QR Payouts for VND and BRL

We are introducing QR Code payout functionality for Vietnamese Dong (VND) and Brazilian Real (BRL) currencies to provide faster, more convenient payment experiences for end users in these markets.

New API Endpoints

QR Code Verify API

Endpoint: POST https://sandbox-api.transfi.com/v2/qr-payout/verify-qrcode

This API allows verification of QR codes before processing payouts, ensuring valid recipient information and reducing transaction failures.

Headers:

Content-Type: application/json
Authorization: Basic [your_auth_token]

Body Parameters:

currency (required): Supported currencies - "VND" or "BRL"
qrCode (required): QR code string to be verified

Example Request:

curl --location --request POST 'https://sandbox-api.transfi.com/v2/qr-payout/verify-qrcode' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic dHJhbnNma' \
  --data-raw '{
    "currency":"VND",
    "qrCode":"0002010102123218888856788880208QRIBFTTA5303704540710000005802VN62140810HD2OBMAWB16304B8BF"
  }'

QR Code Payout API

Endpoint: POST https://sandbox-api.transfi.com/v2/qr-payout/order

This API processes QR code-based payouts for verified recipients in VND and BRL currencies.

Headers:

Content-Type: application/json
Authorization: Basic [your_auth_token]

Body Parameters:

currency (required): Supported currencies - "VND" or "BRL"
qrCode (required): Verified QR code string for payout processing
balanceCurrency (optional): The currency (VND, BRL, USDT) where balance will be deducted from.
partnerId (optional): OrderId from customer.

Example Request:

curl --location --request POST 'https://sandbox-api.transfi.com/v2/qr-payout/order' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic dHJhbnNma' \
  --data-raw '{
    "currency":"VND",
    "qrCode":"00020104218888856788880208QRIBFTTA5303704540710000005802VN62140810HD2OBMAWB16304B8BF",
    "partnerId":"12345678",
    "balanceCurrency":"USDT"
  }'

Supported Currencies

Vietnamese Dong (VND)

Market: Vietnam
QR Standard: VietQR standard compliance
Settlement: Instant settlement to local bank accounts
Verification: Real-time recipient validation

Brazilian Real (BRL)

Market: Brazil
QR Standard: PIX QR code compatibility
Settlement: Instant settlement through PIX network
Verification: CPF/CNPJ validation included

Reasons for Implementation

Enhanced User Experience - QR code payments provide faster, more intuitive payment flows
Market Expansion - Addresses growing demand for digital payments in Vietnam and Brazil
Reduced Errors - QR verification eliminates manual entry mistakes
Instant Settlement - Leverages local payment networks for immediate transfers
Mobile-First Approach - Optimized for smartphone-based payment experiences
Regulatory Compliance - Adheres to local payment standards and regulations

Changes Introduced

New QR Verification Flow - Two-step process ensuring valid recipients before payout
Currency Support Extension - VND and BRL added to supported payout currencies
Mobile Payment Integration - Native QR code scanning and processing capabilities
Real-time Validation - Instant verification of recipient details
Enhanced Error Handling - Specific error codes for QR-related failures

What Remains Unchanged

Authentication Methods - Existing API authentication remains identical
Webhook Events - Standard payout webhook notifications continue to work

Action Required

Integrate New Endpoints - Implement QR verification and payout APIs in your application
Update Currency Handling - Add VND and BRL support to your currency selection
Implement QR Scanning - Add QR code scanning functionality to your mobile/web applications
Test Verification Flow - Validate the two-step QR verification process in sandbox
Update User Interface - Design QR code payment flows for enhanced user experience
Handle New Error Codes - Implement error handling for QR-specific validation failures

Integration Workflow

QR Code Capture - User scans or inputs QR code through your application
Verification Step - Call verify-qrcode API to validate recipient information
Display Details - Show verified recipient details to user for confirmation
Process Payout - Call QR payout order API to complete the transaction
Confirmation - Provide transaction receipt and status updates

Error Handling

Common error scenarios to handle:

Invalid QR code format
Unsupported currency for QR payments
Recipient account validation failures
Network connectivity issues during verification
Insufficient balance for payout processing

Testing

Sandbox Environment - Use sandbox endpoints for development and testing
Test QR Codes - Sample QR codes available for VND and BRL testing
Verification Testing - Validate both successful and failed verification scenarios
End-to-End Testing - Complete payout flow testing in sandbox environment

Support

For integration assistance, QR code format questions, or market-specific inquiries, please contact our technical support team through the designated communication channels.