Mexico

Learn about the dLocal supported payment methods in Mexico.

Payment Methods Available

Cards

payment_method_idBrand IDNamepayment_method_typeDetailsAllowed FlowsLogo
CARDVIVisaCARDCredit Card ​DIRECT REDIRECTLogo
CARDMCMasterCardCARDCredit Card ​DIRECT REDIRECTLogo
CARDVDVisa Debit ​CARDDebit Card ​DIRECT REDIRECTLogo
CARDMDMasterCard Debit ​CARDDebit Card ​DIRECT REDIRECTLogo
CARDAEAmerican ExpressCARDCredit Card ​DIRECT REDIRECTLogo
CARDKCCarnet CreditCARDCredit Card ​DIRECT REDIRECTLogo
CARDKDCarnet DebitCARDDebit Card ​DIRECT REDIRECTLogo

ℹ️

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

Alternative Payment Method

payment_method_idNamepayment_method_typeDetailsAllowed FlowsLogo
OXOXXOTICKETCash PaymentsDIRECT REDIRECTLogo
SESPEIBANK_TRANSFERBank Transfer OnlineDIRECT REDIRECTLogo
CQCODIBANK_TRANSFERCodi QR codeDIRECT REDIRECTLogo
CJCODIBANK_TRANSFERCodi Push NotificationDIRECT REDIRECTLogo
IOBank TransferBANK_TRANSFERBank Transfer OnlineDIRECT REDIRECTLogo
MPMercado PagoBANK_TRANSFERWalletREDIRECTLogo

Direct Alternative Payment Methods

OXXO

Example

curl -X POST \
    -H 'X-Date: 2018-02-20T15:44:42.310Z' \
    -H 'X-Login: sak223k2wdksdl2' \
    -H 'X-Trans-Key: fm12O7G9' \
    -H 'Content-Type: application/json' \
    -H 'X-Version: 2.1' \
    -H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \
    -d '{body}'
    https://api.dlocal.com/payments

{
    "amount": 1800,
    "currency": "MXN",
    "country": "MX",
    "payment_method_id": "OX",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Pedro Gomes",
        "email": "[email protected]",
        "document": "42243309114"
    },
    "order_id": "jhg4v34v534",
    "notification_url": "http://merchant.com/notification/new"
}
{
    "id": "D-4-fecd8cdfd-29a4-4b3cc-87d0-75c057a8a2ec",
    "amount": 1800,
    "currency": "MXN",
    "payment_method_id": "OX",
    "payment_method_type": "TICKET",
    "payment_method_flow": "DIRECT",
    "country": "MX",
    "ticket": {
        "type": "REFERENCE_CODE",
        "number": "93003089592390",
        "expiration_date": "2022-09-27T23:59:00.000+0000",
        "image_url": "https://pay.dlocal.com/gmf/payments/M-6dc6f170-46c4-11ea-addf-83f8a04e38b5"
    },
    "created_date": "2022-09-20T20:33:25.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "jhhg4v341v534",
    "notification_url": "http://merchant.com/notification/new"
}
OXXO UI built with the information in the example above.

OXXO UI built with the information in the example above.

User Interfase 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 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 asking for 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 clear.
MX Currency Symbol$
Expiration dateDisplay this element clear 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. In the image above there 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 help users to have their ticket always on their phone, making it needless to take notes or keep the browser opened.
Print buttonIt is useful for some users who need to have their tickets printed.

Bank Transfer

Example

curl -X POST \
    -H 'X-Date: 2018-02-20T15:44:42.310Z' \
    -H 'X-Login: sak223k2wdksdl2' \
    -H 'X-Trans-Key: fm12O7G9' \
    -H 'Content-Type: application/json' \
    -H 'X-Version: 2.1' \
    -H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \
    -d '{body}'
    https://api.dlocal.com/payments

{
    "amount": 100,
    "currency": "MXN",
    "country": "MX",
    "payment_method_id": "IO",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Pedro Gomes",
        "email": "[email protected]",
        "document": "42243309114"
    },
    "order_id": "jhg4v3215t4",
    "notification_url": "http://merchant.com/notification/new"
}
{
    "id": "D-4-0ceeef7a-854b-4181-afd8-d7ef748914a5",
    "amount": 100,
    "currency": "MXN",
    "payment_method_id": "IO",
    "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": "Dlocal MX",
        "bank_account": "646180205700001446",
        "bank_account_label": "CLABE",
        "reference": "10191924",
        "redirect_url": "https://pay.dlocal.com/gmf-apm/payments/M-24d932cf-fb12-4521-999e-7faf3e60d865",
        "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": "2022-11-21T05:59:00.000+0000"
    },
    "ticket": {},
    "created_date": "2022-11-18T18:34:15.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "386fe81e-3075-4d4c-8725-28abbb1462f3",
    "notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}
Example UI built with the information in the example above.

Example UI built with the information in the example above.

User Interfase 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
SPEI logoDisplay SPEI logo, since bank transfer payment method is known by general public in Mexico as SPEI
Currency and AmountShould be relevant elements in the ticket. Users need to have that information very clear.
MX Currency Symbol$
Expiration dateDisplay this element clear and visible enough. In Mexico the date format is DD/MM/YYYY.
Copy CLABEA a "Copy CLABE" button. The CLABE is the only information that all users need to use in order to complete payment. And it is quite long. Adding a feature to copy this number will help to their payment experience.
Concepto de pago & ReferenciaThe Concepto de pago (Payment concept) and Referencia (Reference) values are not necessary in order to complete payments, but some banks may ask for them in their flows. So it is recommended to display this information since some users may otherwise get stuck at this point.
ReferenciaAlso, some banks may pre-populate the Referencia (Reference) field in their payment flows with a different number. Let users know that there is no problem at all if they use the Referencia provided by the bank, the payment will be processed successfully anyway.
Online Payments OnlyInclude a reminder that payments will only be accepted through home banking. Payment to the cashier at the bank branches is not allowed.
Save buttonIt help users to have their ticket always on their phone, making it needless to take notes or keep the browser opened.
Print buttonIt is useful for some users who need to have their tickets printed.

CODI

Example

curl -X POST \
    -H 'X-Date: 2018-02-20T15:44:42.310Z' \
    -H 'X-Login: sak223k2wdksdl2' \
    -H 'X-Trans-Key: fm12O7G9' \
    -H 'Content-Type: application/json' \
    -H 'X-Version: 2.1' \
    -H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \
    -d '{body}'
    https://api.dlocal.com/payments

{
    "amount": 100,
    "currency": "MXN",
    "country": "MX",
    "payment_method_id": "CD",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Pedro Gomes",
        "email": "[email protected]",
        "document": "42243309114",
        "phone": "527621559017"
    },
    "order_id": "jhg4v3215t4",
    "notification_url": "http://merchant.com/notification/new"
}
{
"id": "D-4-1a64bdbd-faf5-473e-94b5-f96d36ef0d3f",
"amount": 100,
"currency": "MXN",
"payment_method_id": "CD",
"payment_method_type": "TICKET",
"payment_method_flow": "DIRECT",
"country": "MX",
"ticket": {
    "type": "CUSTOM",
    "expiration_date": "2021-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": "2021-02-20T17:06:49.545+0000",
"status": "PENDING",
"order_id": "jhg4v34v534",
"notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}
{
"id": "D-4-1a64bdbd-faf5-473e-94b5-f96d36ef0d3f",
"amount": 100,
"currency": "MXN",
"payment_method_id": "CD",
"payment_method_type": "TICKET",
"payment_method_flow": "DIRECT",
"country": "MX",
"ticket": {
    "type": "CUSTOM",
    "expiration_date": "2021-02-21T06:49:19.000+0000",
    "id": "14000000001099765",
    "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": "2021-02-20T17:06:49.545+0000",
"status": "PENDING",
"order_id": "jhg4v34v534",
"notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}
556

Example CODI - QR Code UI built with the information in the example above

User Interfase 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
User Phone numberAlthough it is not mandatory, asking for user phone is recommended, since if we receive that information, a push notification will be sent to the user's phone in order to complete the payment. If a phone is not received, a payment QR code will be displayed.
QR CodeBuild the QR Codes in UTF-8 format.
Currency and AmountShould be relevant elements in the ticket. Users need to have that information very clear.
MX Currency Symbol$
Expiration dateDisplay this element clear and visible enough. In Mexico the date format is DD/MM/YYYY.