PIX Integration
PIX is Brazil’s instant payment system operated by the Central Bank. BeInfi uses PIX as its primary payment rail, giving sellers instant settlement and buyers a frictionless checkout experience.
How it works
Section titled “How it works”- Buyer initiates payment — The buyer clicks a payment link or checks out from a marketplace listing.
- QR code generated — BeInfi generates a PIX QR code (or copy-paste code) with the exact amount and recipient details.
- Buyer pays — The buyer scans the QR code or pastes the code in their banking app and confirms the payment.
- Instant confirmation — PIX settles in seconds. BeInfi receives a confirmation from the payment processor and updates the transaction status.
- Seller notified — The seller receives a real-time notification in the dashboard and via webhook.
PIX key setup
Section titled “PIX key setup”To receive payments, you must register at least one PIX key in your BeInfi account.
Supported PIX key types:
| Type | Example |
|---|---|
| CPF | 123.456.789-00 |
you@example.com | |
| Phone | +5511999999999 |
| Random key | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
Navigate to Settings > Payments > PIX Keys to add or update your keys.
Transaction fees
Section titled “Transaction fees”BeInfi charges a small percentage fee per transaction. The exact rate depends on your plan:
| Plan | Fee per transaction |
|---|---|
| Free | 2.9% |
| Pro | 1.9% |
| Business | Custom — contact sales |
Fees are deducted automatically before settlement. You receive the net amount directly in your bank account.
Refunds
Section titled “Refunds”Refunds are processed through the dashboard or API. Navigate to Payments > History, find the transaction, and click Refund. Refunded amounts are returned to the buyer’s bank account via PIX within minutes.
curl -X POST https://api.beinfi.com/v1/payments/{payment_id}/refund \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "reason": "Customer requested cancellation" }'Security
Section titled “Security”All PIX transactions are processed through PCI-compliant payment processors. BeInfi never stores sensitive banking credentials. Communication with payment processors uses TLS encryption and all API calls require authentication.