v1

latestOpenAPI 3.1.02026-07-2051132407.2 KB

Payment instruments

Create a payment instrument

Creates a payment instrument to issue a physical card, a virtual card, or a business account to your user.

For more information, refer to Issue cards or Issue business accounts.

post/paymentInstruments

Request body

balanceAccountIdstring required

The unique identifier of the balance account associated with the payment instrument.

descriptionstring

Your description for the payment instrument, maximum 300 characters.

issuingCountryCodestring required

The two-character ISO 3166-1 alpha-2 country code where the payment instrument is issued. For example, NL or US.

paymentInstrumentGroupIdstring

The unique identifier of the payment instrument group to which the payment instrument belongs.

referencestring

Your reference for the payment instrument, maximum 150 characters.

The status of the payment instrument. If a status is not specified when creating a payment instrument, it is set to Active by default. However, there can be exceptions for cards based on the card.formFactor and the issuingCountryCode. For example, when issuing physical cards in the US, the default status is Requested.

Possible values:

Active: The payment instrument is active and can be used to make payments.
Requested: The payment instrument has been requested. This state is applicable for physical cards.
Inactive: The payment instrument is inactive and cannot be used to make payments.
Suspended: The payment instrument is temporarily suspended and cannot be used to make payments.
Closed: The payment instrument is permanently closed. This action cannot be undone.
Stolen
Lost

type'bankAccount' | 'card' required

The type of payment instrument.

Possible values: card, bankAccount.

Response

OK - the request has succeeded.