Payout Overview (Brazil PIX)

Base URL

https://api.transacty.ai

Purpose

Brazil PIX payout sends BRL from your merchant wallet to a beneficiary via PIX. Your server calls POST /v1/br/payouts. The BRL wallet is debited up front (totalWalletDebit = amount + service fee). If the provider rejects the payout, the debit is refunded and the transaction is marked failed.

Settlement wallet

Payouts debit your BRL ledger pocket (not USDT, USDC, or BDT).
totalWalletDebit = payout amount + fees.platformFee.
The beneficiary receives amount in BRL via PIX.

Enable the Brazil market first. Until Brazil is KYB-approved, /v1/br/* returns 403 (market_not_enabled).

Limits

Minimum amount: 10.00 BRL
Maximum amount: 15,000.00 BRL per transaction

Required headers

X-Transacty-Key
X-Transacty-Timestamp
X-Transacty-Signature
Content-Type: application/json

Required scope

payout:create

Flow

Step	API
1	`POST /v1/br/payouts`
2	`GET /v1/payouts/:id` until `success` or `failed`