Brazil — PIX Pay-in (BRL)

Base URL

https://api.transacty.ai

Summary

Brazil PIX pay-in lets your customers pay in BRL. Your server creates a pay-in via POST /v1/br/payins; you render paymentInfo (PIX copy-and-paste code, QR string, or hosted content depending on type). When the payment completes, Transacty credits your BRL wallet and sends a webhook.

Brazil is a separate market from Bangladesh (BDT), India (USDT), and Europe (USDC). Enabling Brazil does not affect other rails.

Settlement wallet & balances

• Pay-ins settle to your BRL wallet pocket on success.
• The BRL pocket is separate from other currencies — do not sum unlike currencies into one headline number.
• On GET /v1/balance: availableBalance is spendable; pendingBalance is in-flight pay-ins (not yet spendable).
• Transactions appear on the brazil rail with railLabel such as Brazil (PIX).

Limits

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

Required headers

Every request uses HMAC authentication (same scheme as all /v1/* endpoints):

• X-Transacty-Key
• X-Transacty-Timestamp (Unix seconds)
• X-Transacty-Signature = HMAC-SHA256(secret, "{timestamp}.{rawBody}")
• Content-Type: application/json
• Idempotency-Key (required on create)

Required scope

• payin:create

Pay-in flow

1. POST /v1/br/payins with Idempotency-Key.
2. Render paymentInfo by type (code → PIX copy/QR; url → open link).
3. Poll GET /v1/payins/:id (shared status URL) or wait for webhook.
4. Treat pending as unpaid.

Webhook events

When a webhook URL is configured, Transacty sends:

• payin.completed
• payin.failed

See Webhooks for signature verification.

Next steps

• Create Pay-in
• Get Pay-in Status