🇧🇷 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. Learn more.

Payment method properties

Markets (consumer)BR
BrandsAMEX DINERS DISCOVER ELO HIPERCARD MASTER VISA + more
Processing currenciesBRL
Consumer currenciesBRL
Minimum payment amount00.00 BRL
Maximum payment amountVaries by card issuer
Payment instrumentCARD_PPRO_VAULTED
Network tokensNo
Recurring paymentsYes
Separate capturesYes
InstallmentsYes
ValidationYes
RefundFull - Partial - Multiple
Refund validity180 days
Authorization reversalYes
Authorization validity7 days
EMV 3-D SecureNo
DisputesYes
Settlement riskNo

Make a card payment

To create a one-time card payment, you'll need to provide the following data at minimum when calling our payment charges API:

Data FieldDescription
paymentMethodCARD
amount.valueThe amount to be paid in the smallest units of the currency used.
amount.currencyBRL
consumer.nameFull name of the consumer.
consumer.countryThe country where the consumer is shopping.
instrument.typeRAW_CARD
instrument.details.brandAMEX DINERS DISCOVER ELO HIPERCARD MASTER VISA

The brand field is optional. Only use the values listed above. If the card brand is not included in this list, omit the field.
instrument.details.numberThe primary account number (PAN) of the card used for payment.
instrument.details.cvvCard verification value (CVV)
A security code used to verify that the card is in the consumer's possession and to authenticate the card during authorization.
instrument.details.holderNameThe full name of the cardholder as it appears on the card.
instrument.details.expiryMonthThe one to two-digit expiration month of the card.
instrument.details.expiryYearThe four-digit expiration year of the card.

Request

POST /v1/payment-charges

{
	"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": 2030
		}
	}
}

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"
    }
  }
}

Handling the payment response

  1. Once the payment has been successfully AUTHORIZED you can present the payment outcome to the consumer.
  2. The payment charge status will be in CAPTURE_PENDING or CAPTURED depending if autoCapture was applied or not. If required, Capture the payment charge.