Other payment methods

With Mercado Pago's Checkout API it is also possible to offer payments with OXXO, Paycash, Citibanamex and BBVA Bancomer.

With these payment methods, buyers will be able to make a deferred cash payment, always within the established deadline for its due date, and they will need to wait for it to be credited to consider the purchase completed.

If you wish to continue with your integration after setting up your environment and want to offer payments with OXXO, Paycash, Citibaname e BBVA Bancomer, follow the steps below.

Remember: before setting up the payment methods, choose the way you will process your transactions. The processing mode, whether manual or automatic, will be defined at the time of order creation, using the processing_mode parameter. For more information, visit the section Integration Model.

Add payment form

To be able to receive payments, you need to add a form in the frontend that securely captures the payer's information.

If you already have a development that includes your own payment form, make sure to include these payment methods among the payment options you want to offer, as indicated below, and continue to the Submit payment step.

If you do not have a payment form, add the one below to your project, including the identifier of the payment methods to be offered.

Payment method	`payment_method_id`
BBVA Bancomer	`bancomer`
Citibanamex	`banamex`
OXXO	`oxxo`
Paycash	`paycash`

html
  <form id="form-checkout" action="/process_payment" method="post">
    <div>
      <div>
        <label for="payerFirstName">Nombre</label>
        <input id="form-checkout__payerFirstName" name="payerFirstName" type="text">
      </div>
      <div>
        <label for="payerLastName">Appelido</label>
        <input id="form-checkout__payerLastName" name="payerLastName" type="text">
      </div>
      <div>
        <label for="email">E-mail</label>
        <input id="form-checkout__email" name="email" type="text">
      </div>
      <div>
        <label for="identificationType">Tipo de documento</label>
        <select id="form-checkout__identificationType" name="identificationType" type="text"></select>
      </div>
      <div>
        <label for="identificationNumber">Número del documento</label>
        <input id="form-checkout__identificationNumber" name="identificationNumber" type="text">
      </div>
    </div>

    <div>
      <div>
        <input type="hidden" name="transactionAmount" id="transactionAmount" value="100">
        <input type="hidden" name="description" id="description" value="Nome do Produto">
        <br>
        <button type="submit">Pagar</button>
      </div>
    </div>
  </form>

Submit payment

The payment submission must be made by creating an order that contains associated payment transactions.

The creation of a payment can occur asynchronously in an order. In this scenario, the order remains in a processing state and without information. We recommend setting up Order topic notifications to receive updates on the status change, including the updated order data. Alternatively, you can choose to send a GET request to the /v1/orders/{id} endpoint to retrieve that updated information.

To do this, send a POST with your test Access TokenTesting private key of the application created in Mercado Pago, that is used in the backend. You can access it through Your integrations > Application details > Testing > Testing credentials. and the required parameters listed below to the endpoint /v1/ordersAPI and execute the request.

curl
curl --location 'https://api.mercadopago.com/v1/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ENV_ACCESS_TOKEN' \
--header 'X-Idempotency-Key: <SOME_UNIQUE_VALUE>' \
{
  "type": "online",
  "external_reference": "ext_ref_1234",
  "processing_mode": "automatic",
  "total_amount": "200.00",
  "payment_expiration_time": "P3D",
  "payer": {
    "email": "test@testuser.com",
    "first_name": "John",
    "last_name": "Doe",
    "identification": {
      "type": "CPF",
      "number": "99999999999"
     },
  },
  "transactions": {
    "payments": [
      {
        "amount": "200.00",
        "payment_method": {
          "id": "oxxo",
          "type": "ticket"
        }
      }
    ]
  }
}

See the table below for descriptions of the parameters that are mandatory in the request and those that, although optional, have some important particularity that should be highlighted.

Atribute	Type	Description	Required/Optional
`Authorization`	Header	Refers to your private key, or Access Token. Use the test Access TokenTesting private key of the application created in Mercado Pago, that is used in the backend. You can access it through Your integrations > Application details > Testing > Testing credentials. in development environments, and the production Access TokenPrivate key of the application created in Mercado Pago, that is used in the backend when receiving real payments. You can access it through Your integrations > Application details > Production > Production credentials. for real payments.	Required
`X-Idempotency-Key`	Header	Idempotency key. It is used to ensure that each request is processed only once, avoiding duplications. Use a unique value in the header of your request, such as a UUID V4 or random strings.	Required
`processing_mode`	Body. String	Processing mode of the order. The possible values are: - `automatic`: to create and process the order in automatic mode. - `manual`: to create the order and process it later. For more information, visit the section Integration model.	Required
`total_amount`	Body. String	Total amount for the transaction.	Required
`payment_expiration_time`	Body. String	Allows you to set the due date using the ISO 8601 duration format. By default, the due date of the boleto is 3 business days ("`P3D`" in the example) to avoid conflicts between the expiration date and the payment crediting, which can take up to 2 business hours from its completion. In case the payment is made after the established expiration date, the amount will be refunded to the payer's Mercado Pago account.	Optional
`payer.email`	Body. String	Buyer’s e-mail.	Required
`transaction.payments.payment_method.id`	Body. String	Identifier of the payment method. The options for these payment methods are: `bancomer`: for payments with BBVA Bancomer. `banamex`: for payments with Citibanamex. `oxxo`: for payments with OXXO. `paycash`: for payments with Paycash.	Required
`transaction.payments.payment_method.type`	Body. String	Type of the payment method. For payments with BBVA Bancomer and Citibanamex, the value must be `atm`. For payments with OXXO and Paycash, the value must be `ticket`.	Required

To learn in detail about all the parameters sent and returned in this request, please refer to our API Reference. Additionally, if you receive an error when submitting the payment, you can consult our list of errors. The response will return the parameter ticket_url, which contains the URL with instructions for the buyer to make the payment, to which you should redirect them. Additionally, it will show the status action_required until the payment is completed.

json
{
  "id": "ORD01J6TC8BYRR0T4ZKY0QR39WGYE",
  "type": "online",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "marketplace": "NONE",
  "total_amount": "200.00",
  "country_code": "MEX",
  "user_id": "1245621468",
  "status": "action_required",
  "status_detail": "waiting_payment",
  "capture_mode": "automatic",
  "created_date": "2024-09-02T22:04:01.880469Z",
  "last_updated_date": "2024-09-02T22:04:04.429289Z",
  "integration_data": {
    "application_id": "4599991948843755"
  },
  "transactions": {
    "payments": [
      {
        "id": "PAY01J6TC8BYRR0T4ZKY0QRTZ0E24",
        "amount": "200.00",
        "reference_id": "22dvqmsbq8c",
        "status": "action_required",
        "status_detail": "waiting_payment",
        "payment_method": {
          "id": "oxxo",
          "type": "ticket",
          "ticket_url": "https://www.mercadopago.com.mx/sandbox/payments/00000000000/ticket?caller_id=77777777777&hash=34cb0d7c-81d9-478c-92a5-767d0kakjja",
          "barcode_content": "3335008800000000006004835002100020000242462010",
          "reference": "1234567890",
          "verification_code": "1234567890"
        }
      }
    ]
  }
}

If you have created the order in manual mode, remember that processing the payment requires an additional step, which is calling the Process orderAPI.

Payment locations

It is important to share with buyers the information about the different places where they can make the payment. Please refer to the following table to learn the details of each location, and include them when providing the payment coupon.

Payment method	Available locations
OXXO	OXXO
PayCash	7-Eleven Circle K Soriana Extra Calimax Santander
BBVA Bancomer	BBVA Bancomer Farmacias del Ahorro Casa Ley
Citibanamex	Citibanamex Chedraui Telecomm

Cancel payment

If you wish, you can cancel a payment created for boleto bancário, as long as it is pending or in process; that is, with status=action_required.

Additionally, we recommend canceling payments that were not made by the established due date to avoid billing and reconciliation issues.

If 30 days pass after the established due date for a payment and it has not been made, Mercado Pago will consider it expired. In these cases, it is not possible to perform a manual cancellation, and the payment status will change to canceled or expired.

For more information, please consult the Refunds and cancellations section.

Cartões

Saiba como configurar pagamentos com cartão no Checkout API.

Configurar notificações

Notificações são mensagens enviadas pelo servidor do Mercado Pago a partir de eventos realizados em sua aplicação.

Documentation

Starting now?

Resources

Support

Partners

Community

Other payment methods

Navigation

Resources and Community

Mercado Pago

Country and language