Customers

List Payment Methods

Changed on

Lists the payment methods a customer has saved.

Card and account numbers are never returned. Each entry carries only the display details — brand, last four digits, expiry — along with an id you can pass as paymentToken on a payment.

Expired payment methods are left out.

sequence:

sequence: true marks a payment method saved for merchant-initiated charges, such as subscription renewals. These are the candidates a declined renewal fails over to. sequence: false marks one the buyer chose at checkout, which you can charge again with paymentToken or set as the customer's defaultTokenId.

get/customers/{id}/payment-methods

Request

Response

The payment methods the customer has saved

idstring required

Identifier of the saved payment method. Pass it as paymentToken on a payment, as defaultTokenId when updating the customer, or to delete the payment method.

typestring required

How the payment method is stored. One of STICKY or ENCRYPTED_STICKY.

expireAtinteger

Time at which the payment method expires, in seconds since the Unix epoch. For a card this is one month after the card's own expiry. Absent when the payment method does not expire.

createdAtstring date-time

Time at which the resource was created.

sequenceboolean required

Whether this payment method was saved for merchant-initiated charges, such as subscription renewals, rather than being one the buyer chooses at checkout.

Example response

[
  {
    "id": "7cc38b08ff471ccd313ad62b23b9f362b107560b",
    "type": "ENCRYPTED_STICKY",
    "paymentMethod": {
      "method": "card",
      "card": {
        "country": "ES",
        "brand": "visa",
        "type": "credit",
        "threeDSecureVersion": "2.1.0",
        "threeDSecureFlow": "CHALLENGE",
        "expiration": 2048544000,
        "last4": "0004",
        "fingerprint": "7f2afde1566286c5fb126bb7e79bef549755cce6033dc429013c46d1365ff0e9",
        "tokenizationMethod": "applePay",
        "cardholderName": "John Doe",
        "cardholderEmail": "email@example.com"
      },
      "paypal": {
        "orderId": "7XP21983KL5672104",
        "payerId": "QWRTNBFHZXLPD",
        "email": "john.doe@example.com",
        "name": "John Doe"
      },
      "sepa": {
        "fingerprint": "7f2afde1566286c5fb126bb7e79bef549755cce6033dc429013c46d1365ff0e9"
      },
      "klarna": {
        "billingCategory": "PAY_LATER",
        "authPaymentMethod": "card"
      }
    },
    "expireAt": 1801612800,
    "createdAt": "2026-09-21T10:25:52.000Z"
  }
]

Changes