GET
/v1/customers/{customer}/payment_methodsList a customer's payment methods
Lists the payment methods attached to a customer. Use type to restrict results to a payment method type, allow_redisplay to filter by checkout redisplay policy, and cursor parameters to paginate the list.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
customerstringrequired
The customer identifier whose payment methods you want to list.
allow_redisplaystringoptional
Filters payment methods by whether they can be shown again in a customer checkout flow: `always`, `limited`, or `unspecified`.
ending_beforestringoptional
An object ID cursor that marks the end of the previous page when retrieving an earlier page.
expandarray<string>optional
Fields to expand in the response; each value must be no longer than 5000 characters.
limitintegeroptional
The maximum number of payment methods to return; must be between 1 and 100 and defaults to 10 when omitted.
starting_afterstringoptional
An object ID cursor that marks the end of the current page when retrieving the next page.
typestringoptional
Filters results by payment method type, including values such as `card`, `acss_debit`, `affirm`, or other types supported by the schema.
200Returns a payment method list containing payment method objects, pagination metadata in `has_more`, the list object type, and the list URL.
dataarray<PaymentMethod>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired
Error handling
customer must identify the customer whose payment methods you want to list. limit must be between 1 and 100, allow_redisplay must be always, limited, or unspecified, and type must be one of the payment method types supported by the schema.