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.