🇧🇷 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 or CAPTURED depending if autoCapture was applied or not. If required, Capture the payment charge.