Create a token to store payment details

post/storedPaymentMethods

API Version

Creates a token to store the shopper's payment details. This token can be used for the shopper's future payments.

Endpoint destination URL

https://checkout-test.adyen.com/v40/storedPaymentMethods

Header Parameters

Required

Optional

A unique identifier for the message with a maximum of 64 characters (we recommend a UUID).

Request Parameters

Required

Optional

The merchant account identifier, with which you want to process the transaction.

Contains the information required to store a payment method.

The shopper's email address. We recommend that you provide this data, as it is used in velocity fraud checks.

The IP address of a shopper.

A unique identifier for the shopper (for example, user ID or account ID).

Only for the Token Connect feature. Contains the information required to store a payment method.

Response parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

201 - Created
The request has been fulfilled and has resulted in one or more new resources being created.
brandstring
The brand of the card.
expiryMonthstring
The month the card expires.
expiryYearstring
The year the card expires, for example 2022.
holderNamestring
The unique payment method code.
ibanstring
The IBAN of the bank account.
idstring
A unique identifier of this stored payment method.
lastFourstring
The last four digits of the PAN.
namestring
The display name of the stored payment method.
networkTxReferencestring
Returned in the response if you are not tokenizing with Adyen and are using the Merchant-initiated transactions (MIT) framework from Mastercard or Visa.

This contains either the Mastercard Trace ID or the Visa Transaction ID.
shopperEmailstring
The shopper’s email address.
shopperReferencestring
Min length: 3Max length: 256
Your reference to uniquely identify this shopper, for example user ID or account ID. The value is case-sensitive and must be at least three characters.

Your reference must not include personally identifiable information (PII) such as name or email address.

supportedShopperInteractionsarray[string]
The supported shopper interactions for this stored payment method.
typestring
The type of payment method.

Create a token to store payment details

HTTP Responses

201 - Created