Suggest edit
Help us improve the documentation
Did you see wrong information and would you like us to explain something else or improve our manuals? Please leave your suggestions on GitHub.

How to integrate QR attended model

To charge with a QR attended model, you’ll have to create and order and then associate it with a Point of Sale.

Model flow

We explain how the attended model works:

Payment flow at QR Mercado Pago point of sale

  1. The point of sale registers an order (1a) and creates an order assigned to a checkout (1b). At this moment the order is available to be scanned (2).
  2. When the customer scans the QR (3) with the order and makes the payment (5), an IPN notification (4a and 6b) is received to the seller's server. With these data, the status of the order (7a) is obtained, to validate that it is closed or is still open, pending payment.

Create an order

Curl

curl -X PUT \
https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/stores/EXTERNAL_STORE_ID/pos/EXTERNAL_POS_ID/orders?access_token=ACCESS_TOKEN -d
{
    "external_reference": "order-id-1234",
    "title": "Title",
    "description": "Mercado Pago",
    "notification_url": "www.yourserver.com",
    "expiration_date": "2023-08-22T16:34:56.559-04:00",
    "total_amount": 100.0,
    "items": [
        {
            "sku_number": "KS955RUR",
            "category": "FOOD",
            "title": "Item1",
            "description": "Item1 Mercado Pago",
            "unit_price": 20,
            "quantity": 5,
            "unit_measure": "unit",
            "total_amount": 100
        }
    ],
    "sponsor": {
        "id": 446566691
    }
}

Obtain more information in our API Reference.

Once the order is created, it is available to be scanned and paid.

Note

Remember that if you haven’t previously provided your business name or logo in your Mercado Pago account, the order title and image showcased to your client in the app will be taken from the first item uploaded.

Eliminate an order

To delete a QR associated order before it’s closed or expires, you can use this following method:

Curl

curl -X DELETE https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/pos/EXTERNAL_POS_ID/orders?access_token=ACCESS_TOKEN  -d 

Answer will be HTTP 204 No Content.

Receive notifications of your orders

IPN notifications are an automatic way of receiving notifications for order creation and status updates. I.e.: when orders are approved, rejected or pending.

Implement IPN merchant_order with an order search by external_reference as a contingency method.

Receive IPN notifications


Next steps

Your search returns no results.

Verifique a ortografia de termos de pesquisa ou teste com outras palavras-chave.