AI resources
Resolve QR

Resolves the data of a QR code generated by Mercado Pago, returning the order information and available payment methods.

GET

https://api.mercadopago.com/instore/v2/external/resolve
Request parameters
Header
Authorization
string

REQUIRED

Bearer access token.
Query
data
string

REQUIRED

Raw content of the scanned QR code.
Response parameters
status
string
QR status. The endpoint returns HTTP 200 even for business errors — check this field to determine the actual state.
closed_amount: Valid QR with a fixed amount.
opened: Valid QR with an open amount (defined by the wallet).
expired: Expired QR.
administrator
object
Information about the interoperability administrator entity that manages the QR network.
collector
object
Information about the merchant (collector) who owns the QR code and will receive the payment.
order
object
Information about the order associated with the QR code, including its items and total amount.
Errors

404Not Found

500Internal Server Error

Request
curl -X GET \
    'https://api.mercadopago.com/instore/v2/external/resolve?data=00020101021143540016com.mercadolibre0130https://mpago.la/pos/10368058550150011273265943055204970053030325802AR5906Prueba6004CABA6304FA22'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-' \
    
Response
{
  "status": "closed_amount",
  "administrator": {
    "name": "COELSA",
    "identification_number": "30692264785"
  },
  "collector": {
    "name": "Prueba Perfumería",
    "identification_number": "27326594305",
    "account": "0000000000000000000000",
    "mcc": "5912",
    "postal_code": "c1430dnn"
  },
  "order": {
    "id": "is95b2e2c156a448799e17b5fd5eea82513806",
    "items": [
      {
        "title": "Producto",
        "currency_id": "ARS",
        "unit_price": 1,
        "quantity": 1
      }
    ],
    "total_amount": 1
  },
  "payment_methods_allowed": [
    {
      "id": "CARD",
      "restrictions": {
        "min_amount_allowed": 5,
        "max_amount_allowed": 25000,
        "max_bins_allowed": "1"
      }
    }
  ],
  "additional_info": ""
}