Integrate Mexico Local Acquiring and have access to a consumer base of over 126 million. 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 (consumer)	`MX`
Processing currencies	`MXN`
Consumer currencies	`MXN`
Consumer Tax Identification	Optional
Minimum payment amount	0.00 MXN
Maximum payment amount	Varies by card issuer
Payment instrument	`CARD_PPRO_VAULTED`
Network tokens	No
Recurring payments	Yes
Separate captures	Yes
Installments	Yes
Validation	Yes
Refund	Full - Partial - Multiple
Refund validity	180 days
Authorization reversal	Yes
Authorization validity	7 days
EMV 3-D Secure	No
Disputes	Yes
Settlement risk	No

Make a card payment

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

Data Field	Description
`paymentMethod`	`CARD`
`amount.value`	The amount to be paid in the smallest units of the currency used.
`amount.currency`	`MXN`
`consumer.name`	Full name of the consumer.
`consumer.country`	The country where the consumer is shopping.
`instrument.type`	`RAW_CARD`
`instrument.details.brand` (optional)	`AMEX` `CARNET` `DINERS` `DISCOVER` `MASTER` `VISA` The `brand` field is optional. Only use one of the values listed above. If the card’s brand is not included in this list or is unknown, do not include the brand field.
`instrument.details.number`	The primary account number (PAN) of the card used for payment.
`instrument.details.cvv`	Card 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.holderName`	The full name of the cardholder as it appears on the card.
`instrument.details.expiryMonth`	The one to two-digit expiration month of the card.
`instrument.details.expiryYear`	The four-digit expiration year of the card.

Request

POST /v1/payment-charges

{
	"paymentMethod": "CARD",
	"paymentDescriptor": "Acme Inc. - Order 123",
	"amount": {
		"value": 20000,
		"currency": "MXN"
	},
	"consumer": {
		"billingAddress": {},
		"country": "MX",
		"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": "MXN",
  "country": "MX",
  "paymentDescriptor": "Acme Inc. - Order 123",
  "status": "CAPTURE_PENDING",
  "consumer": {
    "name": "John Smith",
    "country": "MX",
    "billingAddress": {}
  },
  "authorizations": [
    {
      "id": "authz_GRlW0pINO5ftY8aLTVtbg",
      "amount": 20000,
      "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 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.