Skip to main content

Used Cards

Get a list of credit cards previously used by a customer.

Endpoint Information​

Name: Get Customer's Previously Used Cards
Method: GET
URL: {{BASE_URL}}/api/v1/customer-card/previously-used-cards

Description​

Retrieve a list of cards that have been previously used by a specific customer. This enables "One-Click Payment" scenarios where user selects a saved card.

Authentication​

Type: Basic Auth

  • Username: App Key
  • Password: Secret Key

Query Parameters​

ParameterTypeRequiredDescription
merchantAccountIdstringYesYour merchant account ID
customerTokenstringYesThe customer's token

Response​

Success Response​

{
  "success": true,
  "message": "Previously used cards retrieved successfully",
  "data": [
    {
      "cardToken": "6d044049-5c2f-4b25-8eb3-6e1ad20e4578",
      "cardBrand": "Visa",
      "lastFourDigits": "4242",
      "expiryMonth": "12",
      "expiryYear": "2026",
      "cardHolderName": "John Doe",
      "isDefault": true,
      "lastUsed": "2025-12-20 15:30:22"
    }
  ]
}

Usage​

Use the returned cardToken in the Payment Request Using Customer Token API to charge the card.