API Docs. Elcoin Ltd

Card. Fetch data by card code POST

Get Card data by Card Code

# ENDPOINT

/api/card/getCard/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": "CARD00000AM"
}

# POSITIVE RESPONSE

200 - Response successfully when status is OK

Schema: card

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
account	account	string		account
action	Action	string
activation_date	Activation Date	string	DATE	Activation date in the system
card_code	card_code	string		Card code
card_programme	Card programme	string
card_scheme	card_scheme	string		card scheme
card_status	Card Status	string		Card Status
card_type	card_type	string		Type of card
carrier_type	carrier_type	string		Type of carrier
client_code	Client code	string		Unique client identifier. Issued automatically by the System upon new Customer registration.
close_date	Close Date	string	DATE	Client close date in the system
create_date	Create Date	string	DATETIME	The date entry was created on
create_user	Create User	string		The username of ABS user who has created an entry
delivery_method	delivery_method	string		Type of delivery method
delivery_name	delivery_name	string		Delivery name
design_code	design_code	string		Design code
email	email	string		Email address of a given user
error_description	Error Description	string		Description of error
expiry_date	Expiry date	string
external_id_in_scheme	External id in scheme	string
form_title	form_title	string		Service field
full_delivery_address	full_delivery_address	string		Full delivery address
full_name	full_name	string		Customer full name [first_name] and [last_name] for PERSON and [first_name] only for BUSINESS customer types respectively
holder_counterparty_code	Holder counterparty code	STRING
holder_counterparty_id	Holder counterparty id	INTEGER
holder_full_name	Holder full name	STRING
id	id	integer	INT64	Record's sequence number generated in the system.
modify_date	Modify Date	string	DATETIME	The date entry was last modified on
modify_user	Modify User	string		The username of ABS user who has made last changes to the entry
name_on_card	name_on_card	string		Name on card
pan	Pan	string
state	state	integer	INT64	Record state for replication
telephone	Telephone	STRING
token	Token	string
truncated_pan	Truncated pan	string
uid	uid	string		Unique record identifier which is used to distinguish between existing records
version	version	integer	INT64	Record version for replication

# RESPONSE POSITIVE EXAMPLE

							{
    "status": "ok",
    "error_description": "",
    "error": {},
    "data_type": "system.api.card.cardModel",
    "total_records": 1,
    "data": {
        "card_code": "CARD00000AM",
        "external_id_in_scheme": "b6f62a91-aac0-bfa5-7614-b04c10287643",
        "card_scheme": "RAILSBANK",
        "client_code": "EN003GF4P",
        "full_name": "Leo Messi",
        "account": "60003GF4030EURP",
        "name_on_card": "OLEGS SMIRNOVS",
        "card_type": "physical",
        "carrier_type": "standard",
        "delivery_method": "dhl",
        "delivery_name": "",
        "full_delivery_address": "PERNAVAS 44, RIGA, LV-1054, Latvia",
        "design_code": "DESIGN1",
        "pan": "",
        "truncated_pan": "8360",
        "card_status": "CLOSED",
        "error_description": "",
        "uid": "cc618204-d391-5daa-7614-b04cd0be2b1e",
        "id": 3,
        "version": 514724256,
        "create_user": "root",
        "create_date": "2020-12-11T01:41:53.777",
        "modify_date": "2020-12-21T17:54:19.221"
    }
}

# 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": "[RECORD-NOT-FOUND : Object cardModel cannot find record card.card_code with value ssssssssss]",
    "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. Get PIN	/api/card/getCardPin/cardRequest
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. Description fields request	/api/card/getItemData/cardSearchRequest
Card. Fetch sensitive data	/api/card/getCardSensitiveData/cardRequest
Card. Fetch encrypted sensitive data	/api/card/getCardEncryptedSensitiveData/cardEncryptionRequest