List buyer payment methods

This endpoint requires the payment-methods.read or embed scope.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

buyer_id

string

Filters the results to only the items for which the buyer has an id that matches this value.

buyer_external_identifier

string

Filters the results to only the items for which the buyer has an external_identifier that matches this value.

country

string

Filters the results to only the items which support this country code. A country is formatted as 2-letter ISO country code.

currency

string

Filters the results to only the items which support this currency code. A currency is formatted as 3-letter ISO currency code.

sort_by

enum<string>

Used by the payment method filter to sort the results by an specific usage field.

Available options:

last_used_at,

usage_count,

cit_last_used_at,

cit_usage_count

order_by

enum<string>

default:

desc

Used to show the results ascending or descending order.

Available options:

asc,

desc

Response

200 - application/json

A list of stored payment methods in summarized format.

items

object[]

A list of stored payment methods in summarized format.

items.additional_schemes

enum<string>[] | null

Additional schemes of the card. Only applies to card payment methods.

Available options:

accel,

amex,

bancontact,

carte-bancaire,

cirrus,

culiance,

dankort,

diners-club,

discover,

eftpos-australia,

elo,

hipercard,

jcb,

maestro,

mastercard,

mir,

nyce,

other,

pulse,

rupay,

star,

uatp,

unionpay,

visa

items.approval_target

enum<string> | null

The browser target that an approval URL must be opened in. If any or null, then there is no specific requirement.

Available options:

any,

new_window

items.approval_url

string | null

The optional URL that the buyer needs to be redirected to to further authorize their payment.

items.cit_last_used_at

string | null

The timestamp when this payment method was last used in a transaction for client initiated transactions.

items.cit_usage_count

integer

The number of times this payment method has been used in transactions for client initiated transactions.

items.country

string | null

The 2-letter ISO code of the country this payment method can be used for. If this value is null the payment method may be used in multiple countries.

items.currency

string | null

The ISO-4217 currency code that this payment method can be used for. If this value is null the payment method may be used for multiple currencies.

items.expiration_date

string | null

The expiration date for the payment method.

Required string length: 5

items.has_replacement

boolean

Whether this card has a pending replacement that hasn't been applied yet.

When the Account Updater determines that new card details are available, existing details are not changed immediately, but this field is set to true. There are three scenarios in which the actual replacement occurs:

When this card has expired.
When only the expiration date changed.
When a transaction using this card is declined with any of the following codes:
- canceled_payment_method
- expired_payment_method
- unavailable_payment_method
- unknown_payment_method

When the replacement is applied, this field is set to false. For non-card payment methods, the value of this field is always set to false.

items.id

string

The unique ID of the payment method.

items.label

string

A label for the payment method. For a card payment method this is the last 4 digits on the card. For others it would be the email address.

items.last_replaced_at

string | null

The date and time when this card was last replaced.

When the Account Updater determines that new card details are available, existing details are not changed immediately. There are three scenarios in which the actual replacement occurs:

When this card has expired.
When only the expiration date changed.
When a transaction using this card is declined with any of the following codes:
- canceled_payment_method
- expired_payment_method
- unavailable_payment_method
- unknown_payment_method

When the replacement is applied, this field is updated. For non-card payment methods, the value of this field is always set to null.

items.last_used_at

string | null

The timestamp when this payment method was last used in a transaction.

items.merchant_account_id

string

The unique ID for a merchant account.

items.method

enum<string>

The type of this payment method.

Available options:

afterpay,

alipay,

alipayhk,

applepay,

bacs,

bancontact,

banked,

becs,

bitpay,

boleto,

boost,

card,

cashapp,

chaseorbital,

checkout-session,

clearpay,

click-to-pay,

dana,

dcb,

dlocal,

ebanx,

efecty,

eps,

everydaypay,

gcash,

gift-card,

giropay,

givingblock,

gocardless,

googlepay,

googlepay_pan_only,

gopay,

grabpay,

id,

ideal,

kakaopay,

kcp,

klarna,

laybuy,

linepay,

linkaja,

maybankqrpay,

mercadopago,

multibanco,

multipago,

netbanking,

network-token,

oney_3x,

oney_4x,

oney_6x,

oney_10x,

oney_12x,

ovo,

oxxo,

payid,

paymaya,

paypal,

paypalpaylater,

payto,

venmo,

pix,

pse,

rabbitlinepay,

razorpay,

scalapay,

sepa,

shopeepay,

singteldash,

smartpay,

sofort,

spei,

stripedd,

thaiqr,

touchngo,

truemoney,

trustly,

trustlyeurope,

upi,

vipps,

waave,

webpay,

wechat,

zippay

items.scheme

enum<string> | null

The type of the card, if the payment method is a card.

Available options:

accel,

amex,

bancontact,

carte-bancaire,

cirrus,

culiance,

dankort,

diners-club,

discover,

eftpos-australia,

elo,

hipercard,

jcb,

maestro,

mastercard,

mir,

nyce,

other,

pulse,

rupay,

star,

uatp,

unionpay,

visa

items.type

enum<string>

payment-method.

Available options:

payment-method

items.usage_count

integer

The number of times this payment method has been used in transactions.

Payments

Instruments

Vault

Connections

Dashboard

Errors

List buyer payment methods

Authorizations

Query Parameters

Response