Payment methods
On-Ramp (fiat → crypto)
Off-Ramp (crypto → fiat)
In Brazil both the deposit account and the destination PIX account are provisioned asynchronously — the PIX key is not available right after creation. Subscribe to Account Events instead of polling, and see the fiat account lifecycle for the destination account.
Requirements
- Customer & KYC: the customer must complete identity verification (
COMPLETED) before operating. Brazil accounts are for natural persons (identified by CPF), and KYC requires thenet_incomefield (income bracket) in addition to the standard fields — see KYC Requirements. - Deposit account (On-Ramp): the PIX deposit account is provisioned before operating — create it with Create Deposit Account using
paymentMethodType: "pix". It may take a moment to become available (the account moves fromprocessingtoenabled), and thepixKeyis only returned once it isenabled. - Off-Ramp destination account: register and validate the user’s destination PIX key as an external fiat account. The deposit account is a prerequisite — registering a withdrawal account while it is missing or
disabledreturns HTTP400. Use Retrieve Fiat Account Requirements to get the exact fields for Brazil. - Terms & Conditions: accept the applicable T&C right after creating the customer — a required step before operating.