List payment options

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

Authorizations

Authorization

string

headerrequired

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

Query Parameters

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.

amount

integer

Used by the Flow engine to filter the results based on the transaction amount.

metadata

string

Used by the Flow engine to filter available options based on various client-defined parameters. If present, this must be a string representing a valid JSON dictionary.

locale

string

default: en

An ISO 639-1 Language Code and optional ISO 3166 Country Code. This locale determines the language for the labels returned for every payment option.

Response

200 - application/json

A list of payment options.

items

object[]

items.type

enum<string>

payment-option.

Available options:

payment-option

items.method

enum<string>

The type of payment method that is available.

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.icon_url

string | null

An icon to display for the payment option.

items.mode

enum<string>

The mode to use with this payment option.

Available options:

card,

redirect,

applepay,

googlepay,

click-to-pay,

checkout-session

items.label

string

A label that describes this payment option. This label is returned in the language defined by the locale query parameter. The label can be used to display a list of payment options to the buyer in their language.

items.can_store_payment_method

boolean

A flag to indicate if storing the payment method is supported.

items.can_delay_capture

boolean

A flag to indicate if delayed capture is supported.

items.context

object

Additional context specific to the payment option. This is currently only returned for Apple Pay and Google Pay.

items.context.gateway

string

Gateway used for Google Pay payments.

items.context.gateway_merchant_id

string

Gateway merchant identifier used for Google Pay payments.

items.context.merchant_name

string

Display name of the merchant as registered with the digital wallet provider.

items.context.supported_schemes

string[]

Card schemes supported by the digital wallet provider.

items.context.approval_ui

object

Configuration for the approval interface that should be shown to the buyer.

items.context.required_fields

object

The fields that are required to process a transaction for this payment option.

Payments

Instruments

Vault

Connections

Dashboard

Errors

List payment options

Authorizations

Query Parameters

Response