ADadyen
Recurring

Create a token to store payment details

Changed on

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

To make this request, your API credential must have the following role:

  • API tokenise payment details
post/storedPaymentMethods

Request

  • Base URL
    https://checkout-test.adyen.com/v69
  • URL
    https://checkout-test.adyen.com/v69/storedPaymentMethods
  • Auth
    • HTTP basic
    • or API key in header X-API-Key

Headers

Idempotency-Keystring

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

Request body

merchantAccountstring required

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

shopperEmailstring

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

shopperIPstring

The IP address of a shopper.

shopperReferencestring required

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

Response

Created - the request has been fulfilled and has resulted in one or more new resources being created.

aliasstring

The alias of the credit card number.

Applies only to recurring contracts storing credit card details

aliasTypestring

The alias type of the credit card number.

Applies only to recurring contracts storing credit card details.

brandstring

The brand of the card.

cardBinstring

The bank identification number (BIN) of the card.

expiryMonthstring

The month the card expires.

expiryYearstring

The last two digits of the year the card expires. For example, 22 for the year 2022.

externalResponseCodestring

The response code returned by an external system (for example after a provisioning operation).

externalTokenReferencestring

The token reference of a linked token in an external system (for example a network token reference).

holderNamestring

The unique payment method code.

ibanstring

The IBAN of the bank account.

idstring

A unique identifier of this stored payment method.

issuerNamestring

The name of the issuer of token or card.

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.

ownerNamestring

The name of the bank account holder.

shopperEmailstring

The shopper’s email address.

shopperReferencestring

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.

supportedShopperInteractionsstring[]

The supported shopper interactions for this stored payment method.

typestring

The type of payment method.

Changes

  • v69f2e010c0bf7eRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • v69657b767e76f5Revision changes
    • info

      added the optional property to the response with the status