Account states
A fiat account must be
enabled before it can receive a payout.
In Brazil (PIX) there is no deposit account and no prerequisite: the destination PIX key is resolved to its account holder while Create Fiat Account is being served, so the account comes back already
unconfirmed — or disabled if the key belongs to someone other than the customer. See Brazil.One active account per payment method
A customer can have only one active (enabled) fiat account per payment method at a time. When a fiat account becomes enabled, any other account that was previously enabled for the same customer and the same payment method is automatically moved to suspended.
The rule is scoped per payment method: enabling an account of one payment method does not affect the customer’s accounts registered under a different payment method.
Suspension has no dedicated event or webhook. To detect that a previously active account was suspended, poll List Fiat Accounts or Retrieve Fiat Account Requirements and read each account’s
status.Reactivating a suspended account
Asuspended account is not gone — it can be brought back to enabled in any of these ways:
- Re-register the same account. Submitting Create Fiat Account again with the same account details re-enables the existing account instead of creating a duplicate.
- Use it in a new off-ramp. Referencing the suspended account’s
fiatAccountIdwhen you create an off-ramp order or off-ramp session reactivates it. - Use it to reprocess a cancelled order. Naming it as the replacement destination in Change Fiat Account and Reprocess reactivates it before the payout is retried.
enabled, and — following the rule above — the account that was active before it is moved to suspended.