/instore/qr/seller/collectors/:user_id/stores/:external_store_id/pos/:external_pos_id/orders
BASE URI https://api.mercadopago.com/instore/qr/seller/collectors/{user_id}/stores/{external_store_id}/pos/{external_pos_id}/orders
HTTP Request
curl
curl -X PUT \
'https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/stores/EXTERNAL_STORE_ID/pos/EXTERNAL_POS_ID/orders' \
-H 'Authorization: Bearer PROD_ACCESS_TOKEN' \
-d '{
"external_reference": "order-id-1234",
"title": "Compra",
"description": "Compra en 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": "COMIDA",
"title": "Pasta",
"description": "Compra en Mercado Pago",
"unit_price": 20,
"quantity": 5,
"unit_measure": "unit",
"total_amount": 100
}
],
"sponsor": {
"id": 446566691
}
}'
Request Params
ParameterTypeDescription
user_id
String
Identificador do usuário. (Mandatório)
external_store_id
String
External_id do loja definido pelo sistema integrador. (Mandatório)
external_pos_id
String
External_id do ponto de venda definido pelo sistema integrador. (Mandatório)
external_reference
String(256)
Referência que pode sincronizar com seu sistema de vendas. (Mandatório)
title
String(256)
Título de compra. (Mandatório)
description
String(256)
Descrição de compra.
notification_url
String(500)
URL em que você gostaria de receber uma notificação de pagamento ou merchant_order.
expiration_date
String(500)
Data de expiração do pedido formatado "2020-08-22T16:34:56.559-04:00".
total_amount
Double
Valor total da transação na moeda local. (Mandatório)
items
Array(Object)
Informações sobre os produtos envolvidos no ordem.
sku_number
String
Código do item.
category
String
Categoria do item.
title
String
Título do item. (Mandatório)
description
String
Descrição do item.
unit_price
Double
Preço unitário do produto (máximo de 2 decimais). (Mandatório)
quantity
Integer
Quantidade do unidades do item. (Mandatório)
unit_measure
String
Unidade de medida do item. (Mandatório)
total_amount
String
URL da imagem do produto. (Mandatório)
sponsor
Object
Informações do integrador.
id
Long
USER_ID da conta Mercado Pago do sistema integrador.
cash_out
Object
Retirada de dinheiro.
amount
Double
Montante a retirar em moeda local.
Error Codes
CodeDescription
400 BAD_REQUEST
invalid_collectorId
user_id deve ser um número.
invalid_externalPosId
externalPosId deve estar presente.
invalid_external_reference
external_reference deve ser um string.
invalid_total_amount
total_amount deve ser um número.
invalid_items.sku_number
items.sku_number deve ser um string.
invalid_items.category
items.category deve ser um string.
invalid_items.title
items.title deve ser um string.
invalid_items.description
items.description deve ser um string.
invalid_items.unit_measure
items.unit_measure deve ser um string.
invalid_items.quantity
items.quantity deve ser um número.
invalid_items.currency_id
items.currency_id deve ser um string.
invalid_items.unit_price
items.unit_price deve ser um número.
invalid_items.total_amount
items.total_amount deve ser um número.
invalid_title
titulo deve estar presente.
invalid_unit_measure
unit_measure deve estar presente.
invalid_quantity
quantity deve estar presente.
invalid_unit_price
unit_price deve estar presente.
invalid_total_amount
total_amount deve estar presente.
invalid_title
title deve ser um string.
invalid_description
description deve ser um string.
invalid_sponsor.id
sponsor.id deve ser um número.
invalid_id
sponsor.id deve estar presente.
invalid_cash_out.amount
cash_out.amount deve ser um número.
invalid_amount
cash_out.amount deve estar presente.
invalid_external_reference
external_reference deve estar presente.
invalid_description
description deve estar presente.
error_creating_seller_qr_order
cash_out é necessário para uma ordem sem um item.
invalid_expiration_date
Data de expiração deve ser uma data futura válida.
500 SERVER_ERROR
in_store_order_creation_error
Erro ao tentar criar uma ordem.