🇲🇽 Mexico Local Acquiring

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	`MX`
Brands	`AMEX`, `CARNET`, `DINERS`, `DISCOVER`, `MASTER`, `VISA`
Processing currencies	`MXN`
Consumer currencies	`MXN`
Settlement currencies	`MXN`, `EUR`, `GBP`, `HKD`, `SGD`, `USD`
Minimum payment amount	0.00 MXN
Maximum payment amount	Varies by card issuer
Recurring payments	Yes
Separate captures	Yes
Instalments	Yes (3, 6, 9 or 12 months)
Zero value authorizations	Yes
Refund	Full - Partial - Multiple Partial
Refund validity	180 days
Authorization reversal	Yes
Authorization validity	7 days
EMV 3-D Secure	No
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": 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": 2026
		}
	}
}

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

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.