Create a Bank Account
attention
This API is available for Finix Flex and Finix Core customers.
warning
Ensure you create an additional buyer Identity separate from the merchant Identity. Associate the buyer Identity with the bank account you tokenize.
curl https://finix.sandbox-payments-api.com/payment_instruments \
-H "Content-Type: application/vnd.json+api" \
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
-d '
{
"account_type": "SAVINGS",
"name": "Alice",
"tags": {
"Bank Account": "Company Account"
},
"country": "USA",
"bank_code": "123123123",
"account_number": "123123123",
"type": "BANK_ACCOUNT",
"identity": "IDpYDM7J9n57q849o9E9yNrG"
}'
Example Response:
{
"id" : "PI8sdzepdapDehPWKFTcre1m",
"application" : "APgPDQrLD52TYvqazjHJJchM",
"fingerprint" : "FPRd5moHxL3Ltuvk4cczxetCg",
"tags" : {
"Bank Account" : "Company Account"
},
"bank_code" : "123123123",
"country" : "USA",
"masked_account_number" : "XXXXX3123",
"name" : "Alice",
"account_type" : "SAVINGS",
"created_at" : "2022-01-27T07:36:57.62Z",
"updated_at" : "2022-01-27T07:36:57.62Z",
"instrument_type" : "BANK_ACCOUNT",
"type" : "BANK_ACCOUNT",
"currency" : "USD",
"identity" : "IDpYDM7J9n57q849o9E9yNrG",
"_links" : {
"self" : {
"href" : "https://finix.sandbox-payments-api.com/payment_instruments/PI8sdzepdapDehPWKFTcre1m"
},
"authorizations" : {
"href" : "https://finix.sandbox-payments-api.com/payment_instruments/PI8sdzepdapDehPWKFTcre1m/authorizations"
},
"transfers" : {
"href" : "https://finix.sandbox-payments-api.com/payment_instruments/PI8sdzepdapDehPWKFTcre1m/transfers"
},
"verifications" : {
"href" : "https://finix.sandbox-payments-api.com/payment_instruments/PI8sdzepdapDehPWKFTcre1m/verifications"
},
"application" : {
"href" : "https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM"
},
"identity" : {
"href" : "https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG"
}
}
}
HTTP Request
POST https://finix.sandbox-payments-api.com/payment_instruments
Request Arguments
Field | Type | Description |
---|---|---|
account_number |
string, required | Bank account number |
account_type |
string, required | Either CHECKING or SAVINGS |
bank_code |
string, required | Bank routing number |
country |
string, optional | Country code |
identity |
string, required | ID for the Identity resource which the account is associated |
name |
string, required | Account owner's full name (max 40 characters) |
type |
string, required | Type of Payment Instrument (for bank accounts use BANK_ACCOUNT) |