Create Deposit Account
Creates the customer’s fiat deposit account - the CVU, CLABE, PIX key or BRE-B key the end user will transfer to.
Call this before creating the on-ramp order for every country and payment method combination that requires it. The matrix is in the On-Ramp integration guide; skipping it makes Create On-Ramp Order fail with 400 and code 40019, which no amount of retrying resolves.
The deposit key is assigned asynchronously by the payment provider: the account starts as processing and becomes enabled once it can receive transfers. Wait for the ACCOUNT.ENABLED webhook before creating the order - creating it while the account is still processing returns 400 with code 40014, which a later retry does resolve. The call is idempotent - if the account already exists it is returned as is, so it is safe to retry.
If the provider does not require prior account creation, returns 200 OK with no side effects. The customer must have an approved KYC before calling this endpoint.
Authorizations
Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.
Path Parameters
Unique identifier of the customer.
Body
Payment method type for the deposit account.
The payment method type for the deposit account.
"bank_transfer"
Response
Provider does not require prior account creation. No action was taken.
The response is of type object.