Payment Initiation

paymentInitiationRecipientCreate

POST
/payment_initiation/recipient/create

Create a payment recipient for payment initiation. The recipient must be in Europe, within a country that is a member of the Single Euro Payment Area (SEPA). For a standing order (recurring) payment, the recipient must be in the UK.

The endpoint is idempotent: if a developer has already made a request with the same payment details, Plaid will return the same recipient_id.

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

PaymentInitiationRecipientCreateRequest defines the request schema for /payment_initiation/recipient/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.

name*string

The name of the recipient

Length1 <= length
iban?|

The International Bank Account Number (IBAN) for the recipient. If BACS data is not provided, an IBAN is required.

Length15 <= length <= 34
bacs?
address?

The optional address of the payment recipient. This object is not currently required to make payments from UK institutions and should not be populated, though may be necessary for future European expansion.

Response Body

application/json

curl -X POST "https://example.com/payment_initiation/recipient/create" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "recipient_id": "recipient-id-sandbox-9b6b4679-914b-445b-9450-efbdb80296f6",  "request_id": "4zlKapIkTm8p5KM"}