Mexico
Learn about the dLocal supported payment methods in Mexico.
Market specifications
Take a look of all the payment methods available.
Country reference Cards supported APM supported
Cards
Find all the information about the card supported capabilities.
Capabilities Process Card Payments
Alternative Payments
Learn how to integrate cash, bank transfer or wallet payment.
OXXO SPEI CoDi QR Code CoDi Push Notification Mercado PagoMarket specifications
Do you want to know more information about Mexico's market? Go to the Mexico’s economy and eCommerce market article.
Country reference
country code | currency code | document name | document format | document required? |
|---|---|---|---|---|
MX | MXN | CURP | Between 10 to 18 characters | Yes |
Cards supported
payment_method_id | Brand ID | Name | payment_method_type | Details | Allowed Flows | Logo |
|---|---|---|---|---|---|---|
CARD | VI | Visa | CARD | Credit Card | DIRECT REDIRECT |  |
CARD | VD | Visa Debit | CARD | Debit Card | DIRECT REDIRECT |  |
CARD | MC | Mastercard | CARD | Credit Card | DIRECT REDIRECT |  |
CARD | MD | Mastercard Debit | CARD | Debit Card | DIRECT REDIRECT |  |
CARD | AE | American Express | CARD | Credit Card | DIRECT REDIRECT |  |
CARD | KC | Carnet Credit | CARD | Credit Card | DIRECT REDIRECT |  |
CARD | KD | Carnet Debit | CARD | Debit Card | DIRECT REDIRECT |  |
To offer all the card options that may be available in your integration, send the
payment_method_idasCARD.
Alternative Payment Method supported
payment_method_id | Name | payment_method_type | Details | Allowed Flows | Logo |
|---|---|---|---|---|---|
OX | OXXO | TICKET | Cash Payments | DIRECT REDIRECT |  |
SE | SPEI | BANK_TRANSFER | Bank Transfer Online | DIRECT REDIRECT |  |
CQ | CoDi QR Code | BANK_TRANSFER | Codi QR code | DIRECT REDIRECT |  |
CJ | CoDi Push Notification | BANK_TRANSFER | Codi Push Notification | DIRECT REDIRECT | |
MP | Mercado Pago | BANK_TRANSFER | Wallet | DIRECT REDIRECT |  |
Cards
Capabilities
| Visa Credit | Mastercard Credit | Visa Debit | Mastercard Debit | American Express | Carnet Credit | Carnet Debit | |
|---|---|---|---|---|---|---|---|
| Minimum amount | 1 MXN | 1 MXN | 1 MXN | 1 MXN | 1 MXN | 1 MXN | 1 MXN |
| Refunds | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Recurring | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Chargeback option | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Chargeback Dispute option | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Descriptor | Merchant name | Merchant name | Merchant name | Merchant name | Merchant name | Merchant name | Merchant name |
How to process Card Payments?
Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.
Alternative Payment Method
OXXO
Is the most popular chain of convenience stores in Mexico.
With the aim of facilitating payments in the country, they created the OXXO invoice, which is now widely used by Mexicans to pay for their utility bills and online purchases, in cash.
Capabilities
| OXXO | |
|---|---|
| Min. amount | 1 MXN |
| Max. expiration time supported | 10 or 12 days, depending on the provider. |
| Notification delay | Immediate or 1 day, depending on the OXXO product type. |
| Refunds | Yes |
| Flow | DIRECT REDIRECT |
Request parameters
| Property | Type | Description | Mandatory? |
|---|---|---|---|
amount | Number | Amount to be charged. | Yes |
currency | String | MXNTransaction currency in ISO 4217. | Yes |
country | String | MX Transaction country in ISO 3166. | Yes |
payment_method_id | String | OX ID of the selected payment method. | Yes |
payment_method_flow | String | DIRECT or REDIRECT | Yes |
payer.name | String | Name of the payer. | Yes |
payer.email | String | Email of the payer. | Yes |
payer.document | Number | Document of the payer. | Yes |
order_id | Number | ID of the capture given by the merchant in their system. Think of it as an external ID of the capture. | No |
notification_url | String | Notifications will be sent in every change of status of a payment to the notification_url specified by the merchant. | No |
Examples
{
"amount": 1800,
"currency": "MXN",
"country": "MX",
"payment_method_id": "OX",
"payment_method_flow": "DIRECT",
"payer": {
"name": "Jane Doe",
"email": "[email protected]",
"document": "1234567890",
"address": {
"country": "MX",
"state": "Mexico DF",
"city": "Mexico DF",
"zip_code": "8858",
"street": "Av. Principal",
"number": "5940"
}
},
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"callback_url": "http://merchantsite.com/success_page"
}
{
"id": "D-4-9ad938ba-c157-2022-9451-2881fe74098d",
"amount": 1800,
"currency": "MXN",
"payment_method_id": "OX",
"payment_method_type": "TICKET",
"payment_method_flow": "DIRECT",
"country": "MX",
"bank_transfer": {},
"ticket": {
"type": "REFERENCE_CODE",
"number": "9300-30895-92390",
"expiration_date": "2022-09-27T22:04:49.627+0000",
"image_url": "https://pay.dlocal.com/gmf-apm/payments/M-04d8002b-db83-4d7b-a6e1-578c8803629b"
},
"created_date": "2022-09-17T22:04:48.000+0000",
"status": "PENDING",
"status_detail": "The payment is pending.",
"status_code": "100",
"order_id": "34545sk3483kqw0",
"notification_url": "http://merchantsite.com/notification/new"
}
OXXO UI built with the information in the example above.
User Interface Tips UI
If you are using this payment method through a DIRECT integration, follow the tips below in order to make it easier for your customers to complete payments, boosting your conversion rates.
| Element | Tip |
|---|---|
| Ticket Number | It is the number that payers must dictate to the cashiers in order to complete payment. Name it "Referencia" and separate it this way so it is easier to read: 4 digits - 5 digits - 5 digits |
| Barcode | Some cashiers prefer to scan the barcode rather than ask for the Reference Number. Helping cashiers is a way to improve conversion rates. |
| Currency and Amount | Should be relevant elements in the ticket. Users need to have that information very clearly. |
| Currency Symbol | $ |
| Expiration date | Display this element clearly and visible enough. In Mexico, the date format is DD/MM/YYYY. |
| Payment instructions | Although most users are familiarized with OXXO, it is a good practice to help those who are not. The image above is an example of instructions, but if needed, our team will be happy to help you with more personalized instructions. |
| Store locator | Link it to google.com/maps/search/oxxo/ |
| Save button | It helps users to have their tickets always on their phones, making it needless to take notes or keep the browser open. |
| Print button | It is helpful for some users who need to have their tickets printed. |
SPEI
Is a funds transfer system in which participants can make transfers among themselves on behalf of themselves or their customers.
Each payment order contains information allowing identification of the sender client and the client to whom the payment should be credited.
Capabilities
| SPEI | |
|---|---|
| Min. amount | 1 MXN |
| Max. expiration time supported | 1 day |
| Notification delay | Immediate |
| Refunds | Yes |
| Flow | DIRECT REDIRECT |
Request parameters
| Property | Type | Description | Mandatory? |
|---|---|---|---|
amount | Number | Amount to be charged. | Yes |
currency | String | MXNTransaction currency in ISO 4217. | Yes |
country | String | MX Transaction country in ISO 3166. | Yes |
payment_method_id | String | SE ID of the selected payment method. | Yes |
payment_method_flow | String | DIRECT or REDIRECT | Yes |
payer.name | String | Name of the payer. | Yes |
payer.email | String | Email of the payer. | Yes |
payer.document | Number | Document of the payer. | Yes |
order_id | Number | ID of the capture given by the merchant in their system. Think of it as an external ID of the capture. | No |
notification_url | String | Notifications will be sent in every change of status of a payment to the notification_url specified by the merchant. | No |
Examples
{
"amount": 100,
"currency": "MXN",
"country": "MX",
"payment_method_id": "SE",
"payment_method_flow": "DIRECT",
"payer": {
"name": "Jane Doe",
"email": "[email protected]",
"document": "1234567890",
"address": {
"country": "MX",
"state": "Mexico DF",
"city": "Mexico DF",
"zip_code": "8858",
"street": "Av. Principal",
"number": "5940"
}
},
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"callback_url": "http://merchantsite.com/success_page"
}
{
"id": "D-4-3e6e6631-2ed6-4444-65tr-b109af0f5a1d",
"amount": 100,
"currency": "MXN",
"payment_method_id": "SE",
"payment_method_type": "BANK_TRANSFER",
"payment_method_flow": "DIRECT",
"country": "MX",
"bank_transfer": {
"bank_account_type": "CHECKING",
"bank_name": "STP",
"bank_code": "STP",
"beneficiary_name": "DEMERGE MEXICO SA DE CV",
"bank_account": "646180205700879296",
"bank_account_label": "CLABE",
"reference": "64618020",
"redirect_url": "https://pay.dlocal.com/gmf-apm/payments/M-450359a6-b3a6-4415-82a4-7965tr370370",
"user_payment_amount": 100,
"payment_instruction": "Ingresa a tu banca en línea y realiza la transferencia a la siguiente cuenta. Recuerda que no se pueden hacer pagos en ventanilla.",
"expiration_date": "2023-07-06T00:16:02.500+0000"
},
"ticket": {},
"created_date": "2023-07-05T22:16:02.000+0000",
"status": "PENDING",
"status_detail": "The payment is pending.",
"status_code": "100",
"order_id": "34545sk3483kqw0",
"notification_url": "http://merchantsite.com/notification/new"
}
Example ticket
SPEI UI built with the information in the example above.
CoDi QR Code
It was officially launched by Banco de Mexico to promote payments through digital transfers.
The bank wants this transaction to be as fast and secure as possible, and to promote mobile-friendly payment experiences.
Capabilities
| CoDi QR Code | |
|---|---|
| Min. amount | 1 MXN |
| Max. expiration time supported | 5 days |
| Notification delay | Immediate |
| Refunds | Yes |
| Flow | DIRECT REDIRECT |
UX Flow
The screenshots illustrate a generic CoDi redirect flow, through a QR code.
Request parameters
| Property | Type | Description | Mandatory? |
|---|---|---|---|
amount | Number | Amount to be charged. | Yes |
currency | String | MXNTransaction currency in ISO 4217. | Yes |
country | String | MX Transaction country in ISO 3166. | Yes |
payment_method_id | String | CQ ID of the selected payment method. | Yes |
payment_method_flow | String | DIRECT or REDIRECT | Yes |
payer.name | String | Name of the payer. | Yes |
payer.email | String | Email of the payer. | Yes |
payer.document | Number | Document of the payer. | Yes |
order_id | Number | ID of the capture given by the merchant in their system. Think of it as an external ID of the capture. | No |
notification_url | String | Notifications will be sent in every change of status of a payment to the notification_url specified by the merchant. | No |
Examples
{
"amount": 100,
"currency": "MXN",
"country": "MX",
"payment_method_id": "CQ",
"payment_method_flow": "DIRECT",
"payer": {
"name": "Jane Doe",
"email": "[email protected]",
"document": "1234567890",
"address": {
"country": "MX",
"state": "Mexico DF",
"city": "Mexico DF",
"zip_code": "8858",
"street": "Av. Principal",
"number": "5940"
}
},
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"callback_url": "http://merchantsite.com/success_page"
}
{
"id": "D-4-1a64bdbd-faf5-473e-94b5-f96d36ef0d3f",
"amount": 10,
"currency": "MXN",
"payment_method_id": "CQ",
"payment_method_type": "TICKET",
"payment_method_flow": "DIRECT",
"country": "MX",
"ticket": {
"type": "CUSTOM",
"expiration_date": "2023-02-21T06:49:19.000+0000",
"id": "14000000001099765",
"barcode": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAIAAABEtEjdAABeuklEQVR4XuzUQa4cyQ4gwX//S88AvjQ1ARGKrImqSVs2nGRUqvH+939er9fr9XP+5394vV6v1/d7/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9cPev+4v16v1w96/7i/Xq/XD3r/uL9er9c.....",
"company_name": "DLOCAL MX",
"provider_name": "codi",
"provider_logo": "http://static.dlocal.com/images/providers/caixa.png",
"image_url": "http://pay.dlocal.com/gmf/payments/M-cee70da0-0542-11e9-b88f-39144191f926"
},
"created_date": "2023-02-20T17:06:49.545+0000",
"status": "PENDING",
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"callback_url": "http://merchantsite.com/success_page"
}
CoDi Push Notification
It was officially launched by Banco de Mexico to promote payments through digital transfers.
The bank wants this transaction to be as fast and secure as possible, and to promote mobile-friendly payment experiences.
Capabilities
| CoDi Push Notification | |
|---|---|
| Min. amount | 1 MXN |
| Max. expiration time supported | 5 days |
| Notification delay | Immediate |
| Refunds | Yes |
| Flow | DIRECT REDIRECT |
UX Flow
The screenshots illustrate a generic CoDi redirect flow, through a push notification.
Request parameters
| Property | Type | Description | Mandatory? |
|---|---|---|---|
amount | Number | Amount to be charged. | Yes |
currency | String | MXNTransaction currency in ISO 4217. | Yes |
country | String | MX Transaction country in ISO 3166. | Yes |
payment_method_id | String | CQ ID of the selected payment method. | Yes |
payment_method_flow | String | DIRECT or REDIRECT | Yes |
payer.name | String | Name of the payer. | Yes |
payer.email | String | Email of the payer. | Yes |
payer.document | Number | Document of the payer. | Yes |
order_id | Number | ID of the capture given by the merchant in their system. Think of it as an external ID of the capture. | No |
notification_url | String | Notifications will be sent in every change of status of a payment to the notification_url specified by the merchant. | No |
Examples
{
"amount": 100,
"currency": "MXN",
"country": "MX",
"payment_method_id": "CJ",
"payment_method_flow": "DIRECT",
"payer": {
"name": "Jane Doe",
"email": "[email protected]",
"document": "1234567890",
"phone": "6442306514",
"address": {
"country": "MX",
"state": "Mexico DF",
"city": "Mexico DF",
"zip_code": "8858",
"street": "Av. Principal",
"number": "5940"
}
},
"order_id": "34545sk3483kqw0",
"description": "Tshirt",
"notification_url": "http://merchantsite.com/notification/new",
"callback_url": "http://merchantsite.com/success_page"
}
{
"id": "D-4-1a64bdbd-faf5-473e-94b5-f96d36ef0d3f",
"amount": 10,
"currency": "MXN",
"payment_method_id": "CJ",
"payment_method_type": "TICKET",
"payment_method_flow": "DIRECT",
"country": "MX",
"ticket": {
"type": "CUSTOM",
"expiration_date": "2023-02-21T06:49:19.000+0000",
"id": "14000000001099765",
"company_name": "DLOCAL MX",
"provider_name": "codi",
"provider_logo": "http://static.dlocal.com/images/providers/codi.png",
"image_url": "http://pay.dlocal.com/gmf/payments/M-cee70da0-0542-11e9-b88f-39144191f926"
},
"created_date": "2023-02-20T17:06:49.545+0000",
"status": "PENDING",
"order_id": "34545sk3483kqw0",
"notification_url": "http://merchantsite.com/notification/new"
}
"status": "PENDING",
"status_detail": "The payment is pending.",
"status_code": "100",
}
Mercado Pago
Mercado Pago is a very popular wallet in several countries in Latin America which allow its users to make one-shot payments; as well as recurring payments just by authorizing the merchant on the enrollment payment.
Capabilities
| Mercado Pago | |
|---|---|
| Min. amount | 1 MXN |
| Max. expiration time supported | 5 minutes (authentication) |
| Notification delay | Immediate |
| Refunds | Yes |
| Flow | DIRECT REDIRECT |
UX Flow
One-shot payment
The screenshots illustrate a Mercado Pago one-shot payment redirect flow. The specifics of the flow may vary depending on the payment method selected to complete the payment.
Tokenized wallet
The screenshots illustrate a Mercado Pago tokenized wallet redirect flow.
How to process Mercado Pago payments?
Learn how to process with wallets (one-shot payments and wallet tokenization) with dLocal in our Wallets Payment section.
Updated about 1 month ago