Payment Initiation

createPaymentToken

POST
/payment_initiation/payment/token/create

The /payment_initiation/payment/token/create endpoint has been deprecated. New Plaid customers will be unable to use this endpoint, and existing customers are encouraged to migrate to the newer, link_token-based flow. The recommended flow is to provide the payment_id to /link/token/create, which returns a link_token used to initialize Link.

The /payment_initiation/payment/token/create is used to create a payment_token, which can then be used in Link initialization to enter a payment initiation flow. You can only use a payment_token once. If this attempt fails, the end user aborts the flow, or the token expires, you will need to create a new payment token. Creating a new payment token does not require end user input.

Authorization

PLAID-CLIENT-ID PLAID-SECRET Plaid-Version
PLAID-CLIENT-ID<token>

In: header

PLAID-SECRET<token>

In: header

Plaid-Version<token>

In: header

Request Body

application/json

PaymentInitiationPaymentTokenCreateRequest defines the request schema for /payment_initiation/payment/token/create

client_id?string

Your Plaid API client_id. The client_id is required and may be provided either in the PLAID-CLIENT-ID header or as part of a request body.

secret?string

Your Plaid API secret. The secret is required and may be provided either in the PLAID-SECRET header or as part of a request body.

payment_id*string

The payment_id returned from /payment_initiation/payment/create.

Length1 <= length

Response Body

application/json

curl -X POST "https://example.com/payment_initiation/payment/token/create" \  -H "Content-Type: application/json" \  -d '{    "payment_id": "string"  }'
{  "payment_token": "payment-token-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3",  "payment_token_expiration_time": "2020-01-01T00:00:00Z",  "request_id": "4ciYVmesrySiUAB"}