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 Alternative Payment Method 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 Pago


Market 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 codecurrency codedocument namedocument formatdocument required?
MXMXNCURPBetween 10 to 18 charactersYes

Cards supported

payment_method_idBrand IDNamepayment_method_typeDetailsAllowed FlowsLogo
CARDVIVisaCARDCredit Card ​DIRECT REDIRECT
CARDVDVisa Debit ​CARDDebit Card ​DIRECT REDIRECT
CARDMCMastercardCARDCredit Card ​DIRECT REDIRECT
CARDMDMastercard Debit ​CARDDebit Card ​DIRECT REDIRECT
CARDAEAmerican ExpressCARDCredit Card ​DIRECT REDIRECT
CARDKCCarnet CreditCARDCredit Card ​DIRECT REDIRECT
CARDKDCarnet DebitCARDDebit Card​DIRECT REDIRECT

ℹ️

To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method supported

payment_method_idNamepayment_method_typeDetailsAllowed FlowsLogo
OXOXXOTICKETCash PaymentsDIRECT REDIRECT
SESPEIBANK_TRANSFERBank Transfer OnlineDIRECT REDIRECT
CQCoDi QR CodeBANK_TRANSFERCodi QR codeDIRECT REDIRECT
CJCoDi Push NotificationBANK_TRANSFERCodi Push NotificationDIRECT REDIRECT
MPMercado PagoBANK_TRANSFERWalletREDIRECT


Cards

Capabilities

Visa CreditMastercard CreditVisa DebitMastercard DebitAmerican ExpressCarnet CreditCarnet Debit
Minimum amount1 MXN1 MXN1 MXN1 MXN1 MXN1 MXN1 MXN
RefundsYesYesYesYesYesYesYes
RecurringYesYesYesYesYesYesYes
Chargeback optionYesYesYesYesYesYesYes
Chargeback Dispute optionYesYesYesYesYesYesYes
DescriptorMerchant nameMerchant nameMerchant nameMerchant nameMerchant nameMerchant nameMerchant 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. amount1 MXN
Max. expiration time supported10 or 12 days, depending on the provider.
Notification delayImmediate or 1 day, depending on the OXXO product type.
RefundsYes
FlowDIRECT
REDIRECT

Request parameters

PropertyTypeDescriptionMandatory?
amountNumberAmount to be charged.Yes
currencyStringMXN

Transaction currency in ISO 4217.
Yes
countryStringMX

Transaction country in ISO 3166.
Yes
payment_method_idStringOX

ID of the selected payment method.
Yes
payment_method_flowStringDIRECT or REDIRECTYes
payer.nameStringName of the payer.Yes
payer.emailStringEmail of the payer.Yes
payer.documentNumberDocument of the payer.Yes
order_idNumberID of the capture given by the merchant in their system. Think of it as an external ID of the capture.No
notification_urlStringNotifications 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.

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.

ElementTip
Ticket NumberIt 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
BarcodeSome cashiers prefer to scan the barcode rather than ask for the Reference Number. Helping cashiers is a way to improve conversion rates.
Currency and AmountShould be relevant elements in the ticket. Users need to have that information very clearly.
Currency Symbol$
Expiration dateDisplay this element clearly and visible enough. In Mexico, the date format is DD/MM/YYYY.
Payment instructionsAlthough 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 locatorLink it to google.com/maps/search/oxxo/
Save buttonIt helps users to have their tickets always on their phones, making it needless to take notes or keep the browser open.
Print buttonIt 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. amount1 MXN
Max. expiration time supported1 day
Notification delayImmediate
RefundsYes
FlowDIRECT
REDIRECT

Request parameters

PropertyTypeDescriptionMandatory?
amountNumberAmount to be charged.Yes
currencyStringMXN

Transaction currency in ISO 4217.
Yes
countryStringMX

Transaction country in ISO 3166.
Yes
payment_method_idStringSE

ID of the selected payment method.
Yes
payment_method_flowStringDIRECT or REDIRECTYes
payer.nameStringName of the payer.Yes
payer.emailStringEmail of the payer.Yes
payer.documentNumberDocument of the payer.Yes
order_idNumberID of the capture given by the merchant in their system. Think of it as an external ID of the capture.No
notification_urlStringNotifications 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.

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. amount1 MXN
Max. expiration time supported5 days
Notification delayImmediate
RefundsYes
FlowDIRECT
REDIRECT

UX Flow

The screenshots illustrate a generic CoDi redirect flow, through a QR code.

The screenshots illustrate a generic CoDi redirect flow, through a QR code.

Request parameters

PropertyTypeDescriptionMandatory?
amountNumberAmount to be charged.Yes
currencyStringMXN

Transaction currency in ISO 4217.
Yes
countryStringMX

Transaction country in ISO 3166.
Yes
payment_method_idStringCQ

ID of the selected payment method.
Yes
payment_method_flowStringDIRECT or REDIRECTYes
payer.nameStringName of the payer.Yes
payer.emailStringEmail of the payer.Yes
payer.documentNumberDocument of the payer.Yes
order_idNumberID of the capture given by the merchant in their system. Think of it as an external ID of the capture.No
notification_urlStringNotifications 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. amount1 MXN
Max. expiration time supported5 days
Notification delayImmediate
RefundsYes
FlowDIRECT
REDIRECT

UX Flow

The screenshots illustrate a generic CoDi redirect flow, through a push notification.

The screenshots illustrate a generic CoDi redirect flow, through a push notification.

Request parameters

PropertyTypeDescriptionMandatory?
amountNumberAmount to be charged.Yes
currencyStringMXN

Transaction currency in ISO 4217.
Yes
countryStringMX

Transaction country in ISO 3166.
Yes
payment_method_idStringCQ

ID of the selected payment method.
Yes
payment_method_flowStringDIRECT or REDIRECTYes
payer.nameStringName of the payer.Yes
payer.emailStringEmail of the payer.Yes
payer.documentNumberDocument of the payer.Yes
order_idNumberID of the capture given by the merchant in their system. Think of it as an external ID of the capture.No
notification_urlStringNotifications 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. amount1 MXN
Max. expiration time supported5 minutes (authentication)
Notification delayImmediate
RefundsYes
FlowDIRECT
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.

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.

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.