Brazil has a unique payment landscape with strong local payment preferences. In addition to international card brands, local payment methods like and account for a significant portion of online transactions.
Brazilian transactions require taxpayer identification for compliance purposes.
| Document | Format | Description |
|---|---|---|
| 11 digits | Individual taxpayer ID | |
| 14 digits | Company taxpayer ID |
identityNumber field accepts both CPF and CNPJ. Full validation is performed automatically.Onerway supports all major card brands in Brazil.
Supported features:
| Card Brand | Notes |
|---|---|
| Visa | Most widely accepted |
| MasterCard | Most widely accepted |
| American Express | Premium cards |
| Discover | US-based network |
| JCB | Japan-based network |
| Card Brand | Notes |
|---|---|
| Hipercard | Itaú bank network |
| Elo | Brazilian network |
| Aura | Brazilian network |
| Card Brand | Notes |
|---|---|
| Mercado Libre | Latin America network |
| Method | Settlement | Refund | Chargeback | Best For |
|---|---|---|---|---|
| PIX | Immediate | ✅ | — | Instant payments |
| Boleto | Up to 8 days | ✅ | — | Unbanked customers |
| Mercado Pago | Immediate | ✅ | ✅ | Existing MP users |
| PicPay | Up to 1 day | ✅ | ❌ | Mobile-first users |
| Bank Transfer | 1–12 days | ✅ | ❌ | Traditional banking |
| Field | Type | Description |
|---|---|---|
orderAmount | string | Payment amount |
orderCurrency | string | BRL |
country | string | BR |
lpmsInfo | string | Method-specific JSON |
firstName | string | Consumer's given name |
lastName | string | Consumer's family name |
email | string | Consumer's email |
identityNumber | string | CPF / CNPJ |
| Method | lpmsInfo |
|---|---|
| PIX | {"lpmsType":"PIX"} |
| Boleto | {"lpmsType":"Boleto"} |
| Mercado Pago | {"lpmsType":"MercadoPago"} |
| PicPay | {"lpmsType":"PicPay"} |
| Bank Transfer | {"lpmsType":"BankTransfer"} |
| Type | API | User Flow |
|---|---|---|
| DIRECT | Payment API | Merchant → Payment Page |
| REDIRECT | Checkout API | Merchant → Onerway Checkout → Payment Page |
Best for: Instant payments, mobile-savvy customers, high-value transactions.
PIX is an instant payment system launched by the Central Bank of Brazil, supporting real-time settlement 24/7.

| Feature | Value |
|---|---|
| Processing Time | Up to 6 days |
| Confirmation | Immediate |
| Payment Retry | ✅ |
| Duplicate Payment | ❌ |
Best for: Customers without bank accounts or credit cards, cash-preferring consumers.
Boleto Bancário allows consumers to complete payments at supported retail outlets or through online banking platforms.

| Feature | Value |
|---|---|
| Payment Validity | Up to 8 days |
| Refund Processing | Min. 1 day (bank-dependent) |
| Payment Retry | ✅ |
| Duplicate Payment | ❌ |
Best for: Customers with existing Mercado Pago accounts, cross-border Latin American transactions.
Mercado Pago is a leading digital wallet in Latin America, supporting one-time and recurring payments.
| Feature | Value |
|---|---|
| Auth Timeout | 5 minutes |
| Confirmation | Immediate |
| Refund | ✅ |
| Chargeback | ✅ |
Payment Flows:
Consumer authenticates and completes payment immediately.

Save payment details for subsequent payments without re-authentication.
