π§π· Brazil Local Acquiring
Integrate Brazil Local Acquiring and have access to a consumer base of over 200 million in Latin America's largest economy. PPRO processes all major domestic and international card brands on local payment rails offering both local and international settlement options for wherever your business is located.
Payment Method Properties
Markets | BR |
Brands | AMEX , DINERS , DISCOVER , ELO , HIPERCARD , MASTER , VISA |
Processing currencies | BRL |
Consumer currencies | BRL |
Settlement currencies | BRL , EUR , GBP , HKD , SGD , USD |
Minimum payment amount | 0.00 BRL |
Maximum payment amount | Varies by card issuer |
Recurring payments | Yes |
Separate captures | Yes |
Instalments | Yes (12 months maximum) |
Zero value authorizations | Yes |
Refund | Full - Partial - Multiple Partial |
Refund validity | 180 days |
Authorization reversal | Yes |
Authorization validity | 7 days |
EMV 3-D Secure | Yes |
Chargeback | Yes |
Sandbox Availability | PPRO provided |
One-time Payment
1. Create a payment charge
In your /v1/payment-charges
request, include:
paymentMethod
: CARD
instrument.type
: RAW_CARD
Request:
{
"paymentMethod": "CARD",
"paymentDescriptor": "Acme Inc. - Order 123",
"amount": {
"value": 5000,
"currency": "BRL"
},
"consumer": {
"billingAddress": {},
"country": "BR",
"name": "John Smith"
},
"instrument": {
"type": "RAW_CARD",
"details": {
"brand": "VISA",
"number": "4111111111111111",
"cvv": "123",
"holderName": "John Smith",
"expiryMonth": 1,
"expiryYear": 2026
}
}
}
Response:
{
"id": "charge_JqOxPe5C0ltzDym2Wb4zo",
"paymentMethod": "CARD",
"currency": "BRL",
"country": "BR",
"paymentDescriptor": "Acme Inc. - Order 123",
"status": "CAPTURE_PENDING",
"consumer": {
"name": "John Smith",
"country": "BR",
"billingAddress": {}
},
"authorizations": [
{
"id": "authz_GRlW0pINO5ftY8aLTVtbg",
"amount": 5000,
"status": "AUTHORIZED",
"createdAt": "2023-07-06T15:17:19.141Z",
"updatedAt": "2023-07-06T15:17:19.141Z"
}
],
"captures": [],
"refunds": [],
"voids": [],
"createdAt": "2023-07-06T15:17:19.043Z",
"updatedAt": "2023-07-06T15:17:19.140Z",
"_links": {
"authorizations": {
"href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/authorizations"
},
"captures": {
"href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/captures"
},
"refunds": {
"href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/refunds"
},
"voids": {
"href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/voids"
}
}
}
2. Handle the response
- Once the payment has been successfully
AUTHORIZED
you can present the payment outcome to the consumer. - The payment charge status will be in
CAPTURE_PENDING
orCAPTURED
depending ifautoCapture
was applied or not. If required, Capture the payment charge.
Updated 4 months ago