GET
/
api
/
customers
/
{customerId}
/
cards
curl --request GET \
  --url https://api.atoa.me/api/customers/{customerId}/cards \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "card_abc123def456",
    "name": "John Doe",
    "type": "credit",
    "lastFourDigits": "4242",
    "category": "consumer",
    "cardType": "DEBIT",
    "brand": "VISA",
    "country": "GB",
    "recurrenceType": "unscheduled",
    "expiryDate": "12/2027"
  }
]

List all saved payment methods for a customer. Use the id field as paymentMethodId when charging a saved card.

​
Authorization

Bearer <accessSecret>

Path Parameters

customerId
string
required

The customer UUID whose cards to retrieve.

Response

Returns an array of saved card objects. Returns an empty array [] if no cards are saved.

id
string

Card identifier. Use this as paymentMethodId when processing payments.

name
string

Cardholder name.

type
string

Card type (e.g., credit, debit).

lastFourDigits
string

Last 4 digits of the card number.

category
string

Card category (e.g., consumer, commercial).

cardType
string

Card type (e.g., DEBIT, CREDIT, PREPAID).

brand
string

Card network brand (e.g., VISA, MASTERCARD).

country
string

Card issuing country code (e.g., GB).

recurrenceType
string

Recurrence type (unscheduled, recurring, installment). Default: unscheduled.

expiryDate
string

Card expiry date in MM/YYYY format.

Delete CustomerGet Payment Method