Payment Initiation

paymentInitiationPaymentList

POST
/payment_initiation/payment/list

The /payment_initiation/payment/list endpoint can be used to retrieve all created payments. By default, the 10 most recent payments are returned. You can request more payments and paginate through the results using the optional count and cursor parameters.

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

PaymentInitiationPaymentListRequest defines the request schema for /payment_initiation/payment/list

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.

count?|

The maximum number of payments to return. If count is not specified, a maximum of 10 payments will be returned, beginning with the most recent payment before the cursor (if specified).

Formatint32
Range1 <= value <= 200
Default10
cursor?|

A string in RFC 3339 format (i.e. "2019-12-06T22:35:49Z"). Only payments created before the cursor will be returned.

Formatdate-time

Response Body

application/json

curl -X POST "https://example.com/payment_initiation/payment/list" \  -H "Content-Type: application/json" \  -d '{}'
{  "payments": [    {      "payment_id": "payment-id-sandbox-feca8a7a-5591-4aef-9297-f3062bb735d3",      "reference": "Account Funding 99744",      "amount": {        "currency": "GBP",        "value": 100      },      "status": "PAYMENT_STATUS_INPUT_NEEDED",      "last_status_update": "2019-11-06T21:10:52Z",      "recipient_id": "recipient-id-sandbox-9b6b4679-914b-445b-9450-efbdb80296f6",      "bacs": null,      "iban": null    }  ],  "next_cursor": "2020-01-01T00:00:00Z",  "request_id": "aEAQmewMzlVa1k6"}

createPaymentToken POST

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.

sandboxItemSetVerificationStatus POST

The `/sandbox/item/set_verification_status` endpoint can be used to change the verification status of an Item in in the Sandbox in order to simulate the Automated Micro-deposit flow. Note that not all Plaid developer accounts are enabled for micro-deposit based verification by default. Your account must be enabled for this feature in order to test it in Sandbox. To enable this features or check your status, contact your account manager or [submit a product access Support ticket](https://dashboard.plaid.com/support/new/product-and-development/product-troubleshooting/request-product-access). For more information on testing Automated Micro-deposits in Sandbox, see [Auth full coverage testing](https://plaid.com/docs/auth/coverage/testing#).