Skip to main content
GET
/
customer
/
{customerId}
/
payment-method-tokens
cURL
curl --request GET \
  --url https://api.xpaycheckout.com/customer/{customerId}/payment-method-tokens \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "paymentMethodId": "pmt_ftoeKIYGC3f43frT",
      "paymentMethod": "CARD",
      "customerId": "cus_Tfd3Jq1tZxPjYVhRQW2r3",
      "status": "LIVE",
      "createdAt": 1727340330123
    }
  ],
  "metadata": {
    "offset": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
customerId
string
required

Unique identifier of the customer

Query Parameters

​
startTime
integer

Start of range in epoch milliseconds. Fetches items created after this timestamp.

​
endTime
integer

End of range in epoch milliseconds. Fetches items created before this timestamp.

​
limit
integer

Max items per page (default 50, max 100)

Required range: 1 <= x <= 100
​
offset
string

Cursor-based pagination token. Use the offset value from metadata.offset in the previous response to fetch the next page. Continue until metadata.offset is no longer present in the response.

🚨 Important: Changing any query parameters invalidates existing offset values and requires restarting pagination from the beginning.

For detailed pagination implementation guide, see Pagination Guide.

​
status
string

Filter by payment method token status. Valid values: LIVE, DELETED. Refer payment method token status for more details.

Response

Response containing a list of payment method tokens for a customer

​
data
object[]
required

List of payment method tokens, could be empty if no payment method tokens are found for the customer

​
metadata
object
required