Mexico

Payment Methods Available

payment_method_id

Name

payment_method_type

brand

Details

Allowed Flows

Logo

OX

OXXO

TICKET

Cash Payment

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/OX.png

SE

SPEI

BANK_TRANSFER

Bank Transfer Online

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/SE.png

BV

BBVA Bancomer

BANK_TRANSFER

Bank Transfer Online

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/BV.png

BQ

Banorte

BANK_TRANSFER

Bank Transfer Online

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/BN.png

SM

Santander

BANK_TRANSFER

Bank Transfer Online

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/SM.png

CARD

Visa

CARD

VI

Credit Card

DIRECT

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/VI.png

CARD

MasterCard

CARD

MC

Credit Card

DIRECT

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/MC.png

CARD

Visa Debit

CARD

VD

Debit Card

DIRECT

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/VD.png

CARD

MasterCard Debit

CARD

MD

Debit Card

DIRECT

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/MD.png

CARD

American Express

CARD

AE

Credit Card

DIRECT

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/AE.png

CARD

Carnet Credit

CARD

KC

Credit Card

DIRECT

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/KC.png

CARD

Carnet Debit

CARD

KD

Debit Card

DIRECT

REDIRECT

https://pay.dlocal.com/views/2.0/images/payments/KD.png

Direct Alternative Payment Methods

OXXO

Example

Example Request
Example Response
Example Request

Example Request

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

Example Request Body

{
"amount": 100,
"currency": "MXN",
"country": "MX",
"payment_method_id": "OX",
"payment_method_flow": "DIRECT",
"payer": {
"name": "Pedro Gomes",
"email": "pedrogomes@dlocal.com",
"document": "42243309114"
},
"order_id": "jhg4v34v534",
"notification_url": "http://merchant.com/notification/new"
}
Example Response

Example Response

{
"id": "D-4-fecd8cfd-29a4-4bcc-87d0-75c057a8a2ec",
"amount": 100,
"currency": "MXN",
"payment_method_id": "OX",
"payment_method_type": "TICKET",
"payment_method_flow": "DIRECT",
"country": "MX",
"ticket": {
"type": "REFERENCE_CODE",
"number": "8500-0273-6135-11",
"expiration_date": "2020-02-13T23:59:00.000+0000",
"image_url": "https://pay.dlocal.com/gmf/payments/M-6dc6f070-46c4-11ea-addf-83f8a04e38b5"
},
"created_date": "2020-02-03T20:33:25.000+0000",
"status": "PENDING",
"status_detail": "The payment is pending.",
"status_code": "100",
"order_id": "jhg4v34v534",
"notification_url": "http://merchant.com/notification/new"
}
Example mobile UI built with the information in the example above

User Interface tips

  • Separate the ticket.number this way: 4 digits - 5 digits - 5 digits. It is easier for users to dictate it to cashiers.

  • Currency and amount should be relevant elements in the ticket. Users need to be aware of that at all times.

  • Make sure that the expiration date is clear and visible enough. In Mexico people use the dd/mm/yyyy format.

  • Include payment instructions. Although most users are familiarized with OXXO payment method, it is a good practice to help those who are not used to it. 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.

  • A Store locator is a helpful feature. Just link it to https://google.com/maps/search/oxxo/

  • A Download button helps users to have their ticket always on their phone, making it needless to take notes or keep the browser opened.

  • A Print button is useful for some users that need to have their tickets printed.