Home
Documentation
Resources
Certifications
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Community

Get the latest news, ask others for help and share your knowledge.

Create QR tramma - QR Dynamic Model - Mercado Pago Developers

Intelligent search powered by OpenAI 

Create a QR tramma

POST

https://api.mercadopago.com/instore/orders/qr/seller/collectors/{user_id}/pos/{external_pos_id}/qrs
Generates a QR tramma that will be added to an image.
Request's parameters
PATH
user_id
string

REQUIRED

Find the User ID in your developer dashboard at our devsite
external_pos_id
string

REQUIRED

Custom POS ID associated to the order
BODY
external_reference
string
Custom order ID you can synchronize with your sale system
title
string
Purchase title.
description
string
Purchase description.
notification_url
string
URL where you'd like to receive a payment or merchant_order notification.
Response parameters
qr_data
string
EMVCo tramma for the QR generation.
in_store_order_id
string
Instore order ID.
Errors

400Error

invalid_collectorId

user_id must be a number.

invalid_externalPosId

externalPosId must be present.

invalid_external_reference

external_reference must be present.

invalid_total_amount

total_amount must be present.

invalid_items.sku_number

items.sku_number must be string.

invalid_items.category

items.category must be string.

invalid_items.title

items.title must be string.

invalid_items.description

items.description must be string.

invalid_items.unit_measure

items.unit_measure must be string.

invalid_items.quantity

items.quantity must be number.

invalid_items.currency_id

items.currency_id must be string.

invalid_items.unit_price

items.unit_price must be number.

invalid_items.total_amount

items.total_amount must be number.

invalid_title

title must be string.

invalid_unit_measure

unit_measure must be present.

invalid_quantity

quantity must be present.

invalid_unit_price

unit_price must be present.

invalid_description

description must be present.

invalid_sponsor.id

sponsor.id must be number.

invalid_id

sponsor.id must be present.

invalid_cash_out.amount

cash_out.amount must be number.

invalid_amount

cash_out.amount must be present.

error_creating_seller_qr_order

The cash out is required when order has no items.

invalid_notification_url

notification_url must be url.

invalid_expiration_date

Expiration date must be a valid and future date.

500Error

in_store_order_creation_error

Failed to create order.

Request
curl -X POST \
    'https://api.mercadopago.com/instore/orders/qr/seller/collectors/{user_id}/pos/{external_pos_id}/qrs'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    -d '{
  "external_reference": "reference_12345",
  "title": "Product order",
  "description": "Purchase description.",
  "notification_url": "https://www.yourserver.com/notifications",
  "total_amount": 100,
  "items": [
    {
      "sku_number": "A123K9191938",
      "category": "marketplace",
      "title": "Point Mini",
      "description": "This is the Point Mini",
      "unit_price": 100,
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": 100
    }
  ],
  "sponsor": {
    "id": 662208785
  },
  "cash_out": {
    "amount": 0
  }
}'
Sample answer
{
  "qr_data": "00020101021243650016COM.MERCADOLIBRE02013063638f1192a-5fd1-4180-a180-8bcae3556bc35204000053039865802BR5925IZABEL AAAA DE MELO6007BARUERI62070503***63040B6D",
  "in_store_order_id": "d4e8ca59-3e1d-4c03-b1f6-580e87c654ae"
}