Skip to main content

Get Saved Card Tokens for S2S

List cards saved for a customer so you can charge them with a cardToken.

Call this after S2S Payment with Save Card. Use the returned token in S2S Payment using Card Token or S2S Payment with Card Token and Customer Token.

Endpoint Information​

Name: Get Saved Card Tokens for S2S
Method: GET
URL: {{base_url}}/api/v1/customer-saved-cards?merchantAccountId={{merchantAccountId}}&[email protected]

Authentication​

Type: Basic Auth

  • Username: App Key
  • Password: Secret Key

Query Parameters​

ParameterTypeRequiredDescription
merchantAccountIdstringYesYour merchant account ID
emailstringConditionalCustomer email. Provide either email or customerToken
customerTokenstringConditionalCustomer token. Provide either email or customerToken

Either email or customerToken is required.

Example with email​

GET {{base_url}}/api/v1/customer-saved-cards?merchantAccountId={{merchantAccountId}}&[email protected]

Example with customerToken​

GET {{base_url}}/api/v1/customer-saved-cards?merchantAccountId={{merchantAccountId}}&customerToken={{customerToken}}

Response​

Success Response​

{
"success": true,
"message": "Card List Retrived",
"data": [
{
"card_type": "VISA",
"masked_card": "4000XXXXXXXX0077",
"token": "acaa9bd5-7a86-4f04-b9cf-c0ee2615e716"
}
]
}

Response Fields​

FieldTypeDescription
data[].card_typestringCard network (for example VISA)
data[].masked_cardstringMasked PAN
data[].tokenstringSaved card token (cardToken) to use on later S2S payments

Next steps​

Use data[].token as cardToken when charging, or remove it with Remove Saved Card.