API Docs. Elcoin Ltd

Card. Get PIN POST

Get Card PIN

# ENDPOINT

/api/card/getCardPin/cardRequest

# REQUEST arguments

Variable	Value	Example	Usage	Description
X-App-Sig header 0	DEV-SKIP	DEV-SKIP	M

# REQUEST BODY

# RESPONSE

# REQUEST arguments

Variable	Name	Type	Format	Usage	Description
X-App-Sig	X-App-Sig	header	string	M
Example	DEV-SKIP

# REQUEST BODY

Schema: cardRequest

Type: object

Variable	Name	Type	Format	Usage	Description
card_code	card_code	string			Card code

# REQUEST BODY EXAMPLE

							{
  "card_code": "CARD000013A"
}

# POSITIVE RESPONSE

200 - Response successfully when status is OK

Schema: cardGetPinResponse

Type: application/json

Variable	Name	Type	Description
status	status	string	Request execution status
error_description	Error Description	string	Description of error
error	Error Code	string	Error code
data_type	data_type	string	Type of data
total_records	total_records	string	Total count of records
data	data	object	data of Response

attribute: data

Variable	Name	Type	Format	Description

# RESPONSE POSITIVE EXAMPLE

							{
    "status": "ok",
    "error_description": "",
    "error": {},
    "data_type": "system.api.card.cardGetPinResponse",
    "total_records": 1,
    "data": {
        "pin": "5826"
    }
}

# NEGATIVE RESPONSE

200 - Response with error when status is ERROR

Schema: HeaderResponseStatusError

Type: application/json

Variable	Name	Type	Description
status	status	string	Request execution status
error_description	Error Description	string	Description of error
error	Error Code	string	Error code
data_type	data_type	string	Type of data
total_records	total_records	string	Total count of records
data	data	object	Empty object

# RESPONSE NEGATIVE EXAMPLE

							{
    "status": "error",
    "error_description": "[INCORRECT-CARD-STATUS : Card is closed.]",
    "error": {},
    "data_type": "",
    "total_records": -2,
    "data": {}
}

# Other endpoints

Name	Endpoint
Card. Create	/api/card/createCard/cardCreateRequest
Card. Activate	/api/card/activateCard/cardRequest
Card. Suspend	/api/card/suspendCard/cardActionRequest
Card. Close	/api/card/closeCard/cardActionRequest
Card. Reset PIN	/api/card/resetCardPin/cardRequest
Card. Fetch temporary Image URL by card code	/api/card/getCardTempImageUrl/cardRequest
Card. Fetch data by request	/api/card/getData/cardSearchRequest
Card. Fetch card delivery address by card code	/api/card/getCardDeliveryAddress/cardRequest
Card. Fetch data by card code	/api/card/getCard/cardRequest
Card. Description fields request	/api/card/getItemData/cardSearchRequest
Card. Fetch sensitive data	/api/card/getCardSensitiveData/cardRequest
Card. Fetch encrypted sensitive data	/api/card/getCardEncryptedSensitiveData/cardEncryptionRequest