curl --request POST \
--url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/bank-account \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"account": {
"birthCountryIsoCode": "MX",
"birthDate": "19900515",
"clabe": "646180157000000004",
"curp": "GALA900515MDFRPN08",
"firstName": "Ana",
"maternalLastName": "López",
"paternalLastName": "García",
"rfc": "GALA900515AB1",
"transactionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
},
"bankAccountId": "e5f6a7b8-c9d0-1234-efab-345678901234",
"label": "Ana's SPEI account"
}
EOFconst options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
account: {
birthCountryIsoCode: 'MX',
birthDate: '19900515',
clabe: '646180157000000004',
curp: 'GALA900515MDFRPN08',
firstName: 'Ana',
maternalLastName: 'López',
paternalLastName: 'García',
rfc: 'GALA900515AB1',
transactionId: 'c3d4e5f6-a7b8-9012-cdef-123456789012'
},
bankAccountId: 'e5f6a7b8-c9d0-1234-efab-345678901234',
label: 'Ana\'s SPEI account'
})
};
fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/bank-account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/customer/{customer_id}/bank-account"
payload = {
"account": {
"birthCountryIsoCode": "MX",
"birthDate": "19900515",
"clabe": "646180157000000004",
"curp": "GALA900515MDFRPN08",
"firstName": "Ana",
"maternalLastName": "López",
"paternalLastName": "García",
"rfc": "GALA900515AB1",
"transactionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
},
"bankAccountId": "e5f6a7b8-c9d0-1234-efab-345678901234",
"label": "Ana's SPEI account"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"abbrClabe": "•••• 0004",
"bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"compliant": true,
"createdAt": "2026-05-01T14:30:00Z",
"currency": "MXN",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"etherfuseDepositClabe": "646180157000000004",
"label": "Ana's SPEI account",
"needsWork": false,
"status": "active",
"updatedAt": "2026-05-02T09:15:00Z"
}Organization must be approved before adding a bank accountCreate bank account (API)
Programmatically creates a new bank account for a customer using API-key authentication — no presigned URL required. The registration data (name, CURP, RFC, CLABE, etc.) is validated and sent to the payment processor. Bank accounts require verification before they can be used for transactions.
Sandbox: submit XEXX010101000 (personal) or XEX010101000 (business) as the rfc
to skip SPEI provider registration and have the account marked compliant: true
immediately. The hosted onboarding UI uses these RFCs automatically — programmatic
callers must opt in by passing them. Any other RFC in sandbox is sent to the SPEI
provider’s sandbox as a real registration and will not auto-approve. Both values are
rejected in production.
Precondition: the owning organization must be approved before a bank account can be
added. Adding a bank to an unapproved organization returns 409 Conflict. A newly created
customer is unapproved, so complete its verification and approval before registering a
bank.
curl --request POST \
--url https://api.sand.etherfuse.com/ramp/customer/{customer_id}/bank-account \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"account": {
"birthCountryIsoCode": "MX",
"birthDate": "19900515",
"clabe": "646180157000000004",
"curp": "GALA900515MDFRPN08",
"firstName": "Ana",
"maternalLastName": "López",
"paternalLastName": "García",
"rfc": "GALA900515AB1",
"transactionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
},
"bankAccountId": "e5f6a7b8-c9d0-1234-efab-345678901234",
"label": "Ana's SPEI account"
}
EOFconst options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
account: {
birthCountryIsoCode: 'MX',
birthDate: '19900515',
clabe: '646180157000000004',
curp: 'GALA900515MDFRPN08',
firstName: 'Ana',
maternalLastName: 'López',
paternalLastName: 'García',
rfc: 'GALA900515AB1',
transactionId: 'c3d4e5f6-a7b8-9012-cdef-123456789012'
},
bankAccountId: 'e5f6a7b8-c9d0-1234-efab-345678901234',
label: 'Ana\'s SPEI account'
})
};
fetch('https://api.sand.etherfuse.com/ramp/customer/{customer_id}/bank-account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/customer/{customer_id}/bank-account"
payload = {
"account": {
"birthCountryIsoCode": "MX",
"birthDate": "19900515",
"clabe": "646180157000000004",
"curp": "GALA900515MDFRPN08",
"firstName": "Ana",
"maternalLastName": "López",
"paternalLastName": "García",
"rfc": "GALA900515AB1",
"transactionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
},
"bankAccountId": "e5f6a7b8-c9d0-1234-efab-345678901234",
"label": "Ana's SPEI account"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"abbrClabe": "•••• 0004",
"bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"compliant": true,
"createdAt": "2026-05-01T14:30:00Z",
"currency": "MXN",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"etherfuseDepositClabe": "646180157000000004",
"label": "Ana's SPEI account",
"needsWork": false,
"status": "active",
"updatedAt": "2026-05-02T09:15:00Z"
}Organization must be approved before adding a bank accountPath Parameters
Body
Response
The created bank account
Whether the bank account is compliant and can be used for orders. A bank becomes
compliant once the customer completes the required identity verification (or the
owning organization is approved). While false, the customer must complete
additional verification before the bank can be used — launch them into the
Identity verification flow (scope: verification, target: /idv); see User launch
flows.