Get Customer Cards API {get-customer-cards}
API call for merchants to retrieve the list of saved credit cards, enabling them to render the card list on their own interface.
{danger.fa-exclamation} IMPORTANT: The method has been extended with the
mit_transactionsobject.
If you are using MIT, the response will now include a list of successful Initial MIT transactions (mit_reference_id) associated with the specific customer.
Endpoints
| Name | URL |
|---|---|
| Sandbox | https://gateway.cashier-test.com/agent/get-customer-cards |
| Live | https://gw.praxisgate.com/agent/get-customer-cards |
Request Parameters
✓ - required value
? - optional, value or null
✕ - always appears as null
| Variable | Type | Description | |
|---|---|---|---|
| merchant_id | varchar(50) | ✓ | Merchant API client account identifier |
| application_key | varchar(32) | ✓ | Identifier of your application (website) |
| cid | varchar(50) | ✓ | Unique customer id in your system |
| is_verified | int(1) | ? | Indicates the verification status of the cards returned in the list. (1 for verified (default), 0 for not verified) |
| version | varchar(3) | ✓ | API version |
| timestamp | int(11) | ✓ | Request time (unix timestamp, seconds) |
Response Parameters
| Variable | Type | Description | |
|---|---|---|---|
| status | int | ✓ | API communication status - for transaction processing status please refer to transaction.transaction.status - 0 if the request was successful - Negative integer if internal server/network error occurs - Positive integer if application/logical error occurs |
| description | varchar(256) | ✓ | Accurate description of the result. Return the actual error for any exception as it helps to diagnose issues in production |
| customer_cards | <Object> | ✓ | Customers cards list |
| version | varchar(3) | ✓ | API version |
| timestamp | int(11) | ✓ | Response time (unix timestamp, seconds) |
Signature
The full signature generation algorithm can be found in the Authentication section.
Request signature parameters
merchant_idapplication_keytimestampcid
Response signature parameters
statustimestamp
Customer Cards List Response Example
{
"customer_cards" : [
{
"card_token": "af7d1b07c48fbeff116b2bb3e84fb4c9",
"card_number": "491694******1514",
"card_holder": "John Doe",
"card_exp": "12/2022",
"card_type": "VISA",
"card_issuer_name": "Random Bank, London",
"card_issuer_country": "GB",
"is_default": 0,
"mit_transactions": [
{
"expired_at": 16823433429,
"trace_id": 10034325235,
"gateway": "feBn6ooVgTwEjT4zTdq-5zQZZ18ThFoE",
"transaction_type": "authorization"
}
]
},
{
"card_token": "c7f9a2c6f4288e8c40f2a6602a64b6742",
"card_number": "512124******5468",
"card_holder": "Jane Doe",
"card_exp": "05/2025",
"card_type": "MasterCard",
"card_issuer_name": "Central Bank, Cyprus",
"card_issuer_country": "CY",
"is_default": 1,
"mit_transactions": [
{
"expired_at": 16823432423,
"trace_id": 10089231233,
"gateway": "87cfb23a8f1e68e162c276b754d9c061",
"transaction_type": "sale"
}
]
}
]
}