Add a destination bank account to the customer account
Add a destination Bank to the customer account
This endpoint needs your API key
Send it as a bearer token in the Authorization header. A request without one is answered with 401. See Authentication for where to find your key and how to keep it secret.
Request
curl -X POST "https://api.leapa.co/v2/customers/cus_3d8e51fa20/destination/bank" \
-H "Authorization: Bearer $LEAPA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"holder_type": "individual",
"bank_request": {
"currency": "BIF",
"address": {
"city": "string",
"state": "string",
"type": "personal",
"country": "BI",
"zip": "string",
"line1": "string",
"line2": "string"
},
"account_number": "00012345678901",
"routing_number": "string",
"bank_name": "Jeanne Ndayishimiye"
}
}'Response
Created
{
"holder_type": "individual",
"bank_response": {
"object": "string",
"address": {
"object": "string",
"city": "string",
"type": "personal",
"status": "invalid",
"state": "string",
"zip": "string",
"line1": "string",
"line2": "string"
},
"defaultPayout": false,
"owner_name": "Jeanne Ndayishimiye",
"type": "bank",
"bank_name": "Jeanne Ndayishimiye",
"account_id": "acc_62f3a8d15b",
"default": false,
"account_number": "00012345678901",
"routing_number": "string",
"created_at_date": 0
}
}Path parameters
Values that go into the URL itself.
customer_idstringrequiredExample:cus_3d8e51fa20
Request body
Required. Send it as JSON.
holder_typestringrequiredHolder Type
Allowed values:individualcompanybank_requestBankRequestrequiredcurrencystringrequiredCard Currency
Allowed values:BIFUSDKESXAFaddressAddressRequestRestrictedcitystringrequiredCity. Constraints: Not null, Size(min=3, max=90)
Must be:3 to 90 charactersstatestringState. Constraints: Size(min=1, max=90)
Must be:1 to 90 characterstypestringrequiredThe type of address. Constraints: Not null
Allowed values:personalbusinesscountrystringrequired2 letter ISO Country Code. Constraints: Not null, Size(min=2, max=3)
Allowed values:BICMzipstringZip. Constraints: Size(min=1, max=15)
Must be:1 to 15 charactersline1stringrequiredLine 1. Constraints:Not null, Size(min=1, max=90)
Must be:1 to 90 charactersline2stringrequiredLine 2. Constraints: Size(min=1, max=90)
Must be:1 to 90 characters
account_numberstringrequiredBank Account Number
routing_numberstringrequiredRouting transit number for the bank account
bank_namestringrequiredBank name
Response
holder_typestringrequiredHolder Type
Allowed values:individualcompanybank_responseBankResponserequiredobjectstringObject name
addressAddressResponseobjectstringObject name
citystringCity
typestringThe type of address. Can be Business location address or Bank Address
Allowed values:personalbusinessstatusstringAddress status - invalid, line1_fail, line1_pass, line1_zip_pass, unchecked, verified, zip_fail, zip_pass
Allowed values:invalidline1_passline1_name_passline1_zip_passname_passname_zip_passuncheckedverifiedand 1 morestatestringState
zipstringZip
line1stringLine 1
line2stringLine 2
defaultPayoutbooleanowner_namestringName of the account owner.
typestringType of payout account.
Allowed values:bankmobilecashbank_namestringBank Name
account_idstringAccount id.
defaultbooleanFlag indicating whether the account is a default payout or not.
account_numberstringAccount Number
routing_numberstringRouting transit number for the bank account
created_at_dateinteger<int64>The date and time that the payout was created
Status codes
201Created400Bad request401Unauthorized402Payment required403Forbidden404Not found428Precondition required500Server error