Add payment instrument to a wallet

POST 
/customers/:customerId/instruments

Add Payment Instrument. This operation has the following limitations:

• Works only for Legal Entities. Regular customers can not add instuments
• Supports UkBankAccount and SepaBankAccount
• The instrument is created in status UNVERIFIED and can not be used for deposit or withdrawal until proper bank statement is submitted.
• When the required bank statement are submitted through PATCH /customer-legal-entities/{customerId} and verified by Paysafe team, the instrument will be approved.

Request

Path Parameters

customerId stringrequired

Id of the customer to fetch instruments for

application/json

Body

instrumentType

string

required

Possible values: [CARD, SEPA_BANK_ACCOUNT, UK_BANK_ACCOUNT, US_BANK_ACCOUNT, CCI_BANK_ACCOUNT]

Instrument type.

Value	Description
SEPA_BANK_ACCOUNT	SEPA Bank account
UK_BANK_ACCOUNT	UK Bank account
US_BANK_ACCOUNT	US Bank account
CCI_BANK_ACCOUNT	CCI Bank account
CARD	Card

CARD

pan stringrequired

Card Number

cardHolderName string

Possible values: <= 160 characters

Card holder name.

bankName string

Bank name.

expiryDate

object

required

Card expiry date.

year integerrequired

month integerrequired

cardScheme CardScheme (string)

Possible values: [VISA, MC]

Card scheme information.

• VISA - VISA
• MC - Mastercard The scheme is derived from the card PAN.

description string

Possible values: <= 20 characters

Name to be associated with the card.

SEPA_BANK_ACCOUNT

accountHolderName string

Possible values: <= 100 characters

This is the name of the customer or company that owns the bank account.

iban stringrequired

The International Bank Account Number (IBAN) of the account.

bic stringrequired

The Bank Account Bank Identifier Code (BIC) code. Also known as SWIFT code.

bankName string

Bank name.

UK_BANK_ACCOUNT

accountHolderName string

Possible values: <= 100 characters

This is the name of the customer or company that owns the bank account.

accountNumber stringrequired

A bank account number.

sortCode stringrequired

Use our sort code checker to easily find and check UK sort codes.

bankName string

Bank name.

US_BANK_ACCOUNT

accountHolderName string

Possible values: <= 100 characters

This is the name of the customer or company that owns the bank account. As per regulations the Wallet holder and bank account holder must be the same.

accountNumber stringrequired

Possible values: >= 4 characters and <= 17 characters

This is the bank account number.

routingNumber stringrequired

Possible values: >= 9 characters and <= 9 characters

For USD accounts, this is the 9-digit routing number of the bank.

bankName string

Bank name.

accountType string

Possible values: [SAVINGS, CHECKING, LOAN]

CCI_BANK_ACCOUNT

accountNumber stringrequired

Possible values: >= 20 characters and <= 20 characters

A bank account number (Código de Cuenta Interbancario), has 20 digits

externallyVerified booleandeprecated

Is the instrument externally verified. The property is not returned by the API anymore.

status string

Possible values: [VERIFIED, UNVERIFIED, VERIFICATION_REQUIRED, REJECTED]

Instrument status.

creationTime date-time

Represents RFC 3339, section 5.6 date-time.

Responses

200

OK

application/json

Schema

Schema

id string

The instrument id

customerId string

Customer to which this instrument belongs.

instrumentType

string

required

Possible values: [CARD, SEPA_BANK_ACCOUNT, UK_BANK_ACCOUNT, US_BANK_ACCOUNT, CCI_BANK_ACCOUNT]

Instrument type.

Value	Description
SEPA_BANK_ACCOUNT	SEPA Bank account
UK_BANK_ACCOUNT	UK Bank account
US_BANK_ACCOUNT	US Bank account
CCI_BANK_ACCOUNT	CCI Bank account
CARD	Card

CARD

pan stringrequired

Card Number

cardHolderName string

Possible values: <= 160 characters

Card holder name.

bankName string

Bank name.

expiryDate

object

required

Card expiry date.

year integerrequired

month integerrequired

cardScheme CardScheme (string)

Possible values: [VISA, MC]

Card scheme information.

• VISA - VISA
• MC - Mastercard The scheme is derived from the card PAN.

description string

Possible values: <= 20 characters

Name to be associated with the card.

SEPA_BANK_ACCOUNT

accountHolderName string

Possible values: <= 100 characters

This is the name of the customer or company that owns the bank account.

iban stringrequired

The International Bank Account Number (IBAN) of the account.

bic stringrequired

The Bank Account Bank Identifier Code (BIC) code. Also known as SWIFT code.

bankName string

Bank name.

UK_BANK_ACCOUNT

accountHolderName string

Possible values: <= 100 characters

This is the name of the customer or company that owns the bank account.

accountNumber stringrequired

A bank account number.

sortCode stringrequired

Use our sort code checker to easily find and check UK sort codes.

bankName string

Bank name.

US_BANK_ACCOUNT

accountHolderName string

Possible values: <= 100 characters

This is the name of the customer or company that owns the bank account. As per regulations the Wallet holder and bank account holder must be the same.

accountNumber stringrequired

Possible values: >= 4 characters and <= 17 characters

This is the bank account number.

routingNumber stringrequired

Possible values: >= 9 characters and <= 9 characters

For USD accounts, this is the 9-digit routing number of the bank.

bankName string

Bank name.

accountType string

Possible values: [SAVINGS, CHECKING, LOAN]

CCI_BANK_ACCOUNT

accountNumber stringrequired

Possible values: >= 20 characters and <= 20 characters

A bank account number (Código de Cuenta Interbancario), has 20 digits

externallyVerified booleandeprecated

Is the instrument externally verified. The property is not returned by the API anymore.

status string

Possible values: [VERIFIED, UNVERIFIED, VERIFICATION_REQUIRED, REJECTED]

Instrument status.

creationTime date-time

Represents RFC 3339, section 5.6 date-time.

Example (from schema)

{
  "id": "string",
  "customerId": "5435323362",
  "instrumentType": "CARD",
  "status": "VERIFIED",
  "creationTime": "2021-07-15T17:54:12Z"
}

ADD_PAYMENT_INSTRUMENT_RESPONSE

{
  "id": "2323213",
  "customerId": "5435323362",
  "instrumentType": "SEPA_BANK_ACCOUNT",
  "accountHolderName": "John Doe",
  "iban": "NL94RABO7762494464",
  "bic": "RABONL2U",
  "status": "UNVERIFIED"
}

Loading...