QR Code Merchant Payments
Let your users pay local merchants by scanning a QR code, funded from your balance.
What you can buildYour user scans a merchant's QR code at a shop in Vietnam or Brazil. TransFi reads the code, pays the merchant over the local rail in real time, and debits your pre-funded balance. No bank details to collect, no recipient to onboard.
How the money moves
Your pre-funded balance → TransFi decodes the QR → local rail pays the merchant → webhook confirms
The user is yours; the merchant is whoever's QR they scanned. You hold the balance; the merchant gets local currency.
Live today
| Country | Currency | QR standard |
|---|---|---|
| Vietnam | VND | VietQR |
| Brazil | BRL | PIX |
Other corridors are opened on demand with volume projections — ask your account manager.
Flows you'll use
| Flow guide | Needed? |
|---|---|
| QR Payouts | ✓ — the whole flow |
| Pre-funding | ✓ — fund before your users pay |
| POBO / COBO | ◐ your user is registered as the sender the payment is on behalf of |
| MCA | ✓ — where the balance lives |
Your integration
- Pre-fund your balance — Pre-funding
- Register your user as a sender — Create Individual Sender
- Decode the scanned QR — Get QR Code Details. You get the merchant's name and bank, and the amount if the code carries one
- Show the user what they're paying; for a static code, let them enter the amount
- Create a
payoutorder withpaymentType: "qr"— Create Order - On
fund_settled, show "paid" — the merchant has the money
Dynamic vs static codes
| The code carries | The user does | |
|---|---|---|
| Dynamic | Merchant + amount + reference | Confirms |
| Static | Merchant only | Enters the amount in your app |
Before you go live
- A failed payout returns the amount and fees to your balance automatically — show
failureMessageand let the user retry with a fresh scan - Bad or expired codes are rejected at the decode step, before any money moves
- Keep
totalAvailablePrefundingBalanceabove your expected daily volume — MCA
Updated about 1 month ago
Did this page help you?