Skip to main content

Subscription-PaymentMethod

Details about the payment method at the time of the transaction.

methodstring

Subscription method type.

Enum ValueDescription
cardCard

Possible values: [card]

Example: card
card object

Details about the card used as payment method at the time of the transaction.

countryCountry (string)

Two-letter country code (ISO 3166-1 alpha-2).

Example: ES
brandstring

Card brand.

Enum ValueDescription
visaVisa credit or debit card
mastercardMastercard credit or debit card
dinersDiners Club credit card
amexAmerican Express credit card
jcbJapan Credit Bureau card
unionpayUnionPay card from China
unknownCard brand could not be determined

Possible values: [visa, mastercard, diners, amex, jcb, unionpay, unknown]

Example: visa
typestring

Card type debit or credit.

Possible values: [debit, credit]

Example: credit
threeDSecureboolean

Whether this transaction used 3D Secure authentication.

Example: false
threeDSecureVersionstring

The protocol version of the 3DS challenge.

Example: 2.1.0
threeDSecureFlowstring

The flow used for 3DS authentication.

Enum ValueDescription
CHALLENGEAuthentication requiring additional shopper interaction through biometrics, 2FA, or other SCA methods
FRICTIONLESSBackground authentication using device fingerprint without additional shopper interaction
FRICTIONLESS_CHALLENGEComplete 3DS flow with additional authentication if initial data collection is insufficient
DIRECTTransaction exempt from SCA due to low risk assessment

Possible values: [CHALLENGE, FRICTIONLESS, FRICTIONLESS_CHALLENGE, DIRECT]

Example: CHALLENGE
expirationint64

Time at which the card will expire. Measured in seconds since the Unix epoch.

Example: 2048544000
last4string

The last four digits of the card.

Example: 0004
tokenizationMethodstring

The digital wallet used to tokenize the card.

Possible values: [applePay, googlePay, clickToPay]

Example: applePay
cardholderNamestring

The name of the cardholder.

Example: John Doe
cardholderEmailstring

The email of the cardholder.

Example: email@example.com
Subscription-PaymentMethod
{
"method": "card",
"card": {
"country": "ES",
"brand": "visa",
"type": "credit",
"threeDSecure": false,
"threeDSecureVersion": "2.1.0",
"threeDSecureFlow": "CHALLENGE",
"expiration": 2048544000,
"last4": "0004",
"tokenizationMethod": "applePay",
"cardholderName": "John Doe",
"cardholderEmail": "email@example.com"
}
}