Home
Documentation
Resources
Certifications
Community
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-2151*********762-03031*********750b665b7*********4dac477-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"
}