Simulate a Pix credit into a sandbox BRL account (sandbox only)
Simulates a Pix that a payer sends into a sandbox BRL account. The credit is added to the account's balance, listed on GET /accounts/{account_id}/movements and announced with account.credited, the same three things a real Pix into a live account produces. Use it to build and test your deposit handling before a live account receives money.
To test the conversion, create a transfer with source.type: account from this account to the customer's wallet. In the sandbox the balance is debited at once, the transfer completes, and the refusals are the live ones: below the BRL 1,000 floor, or above the balance not already committed to an open order (422 ACCOUNT_BALANCE_INSUFFICIENT).
Available only to test-environment API keys on sandbox BRL accounts. A live key, or an account in another currency, gets 404 SIMULATION_NOT_AVAILABLE.
This route takes no Idempotency-Key: every call is a new credit.
Request
- Base URLhttps://developers.ozav.io/v2
- Auth
- API key in header X-API-Key
- or HTTP bearer
Path parameters
The opaque account id (ozav_acc_...).
Request body
Example request
{
"amount": "1500.00"
}Response
The credit, in the same shape GET /accounts/{account_id}/movements lists it.
Changes
No recorded changes to this operation across all 1 revision of this API.