Sugerir alterações
Ajude-nos a melhorar a documentação
Você viu informações equivocadas, gostaria que explicássemos algo a mais ou que melhorássemos nossos manuais? Deixe suas sugestões no GitHub.

Integrar o modelo QR atendido

Para receber por meio de um código QR modelo atendido, deverá criar um pedido e associá-lo ao caixa onde quiser receber.

Fluxo do modelo

Explicamos como funciona o modelo atendido:

Fluxo de pagamento no ponto de venda QR Mercado Pago

  1. O ponto de venda registra um pedido (1a) e cria um pedido atribuído a uma caixa (1b). Neste momento, o pedido está disponível para leitura (2).
  2. Quando o cliente escaneia o QR (3) com o pedido e faz o pagamento (5), uma notificação IPN (4a e 6b) é recebida no servidor do vendedor. Com estes dados obtém-se o estado da encomenda (7a), para validar se está encerrada ou ainda em aberto, com pagamento pendente.

Criar um pedido

Curl

curl -X PUT \
-H 'Authorization: Bearer ACCESS_TOKEN' \
https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/stores/EXTERNAL_STORE_ID/pos/EXTERNAL_POS_ID/orders \
-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
    }
}

Pode obter mais informações em Referências do API.

Assim que o pedido for criado, ele estará disponível para ser digitalizado e pago.

Nota

Leve em consideração que se não fez previamente o carregamento do nome de seu negócio ou a logomarca em sua conta de Mercado Pago, o título e a imagem do pedido que o cliente veja no app serão as do item carregado.

Remover um pedido

Para remover o pedido associado a um QR antes de que expire por validade ou seja encerrado, poderá fazê-lo por meio do método a seguir:

Curl

curl -X DELETE \
-H 'Authorization: Bearer ACCESS_TOKEN' \
https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/pos/EXTERNAL_POS_ID/orders

A resposta será um HTTP 204 No Content.

Receba notificações de suas ordens

As notificações IPN (Instant Payment Notification) são a forma automática de aviso da criação de novas ordens e as atualizações de seus estados. Por exemplo, se foram aprovadas, recusadas ou se estiverem pendentes.

Implementa IPN de merchant_order junto com uma busca do pedido por external_reference como método de contingência.

Receber notificações IPN


Próximos passos

Sua pesquisa não retorna resultados.

Check the spelling of search terms or test with other keywords.