Endpoints disponíveis
Todos os endpoints que compõem a integração de Código QR, desde a configuração inicial da infraestrutura até o gerenciamento das cobranças. Para integrações em nome de terceiros, autentique as chamadas a esta API com OAuth.
As lojas representam as localizações físicas do seu negócio. Cada loja agrupa os caixas nos quais são gerados os Códigos QR.
| Operação | Path | Descrição |
| Criar lojaPOST | /users/{user_id}/stores | Registra uma loja física onde operarão os caixas com Código QR. |
| Obter lojaGET | /stores/{id} | Retorna os dados de cadastro de uma loja: nome, horário comercial, localização e identificador externo. |
| Buscar em lojasGET | /users/{user_id}/stores/search | Busca lojas por external_id ou outros parâmetros disponíveis, retornando resultados paginados. |
| Atualizar lojaPUT | /users/{user_id}/stores/{id} | Atualiza os dados de configuração de uma loja existente. |
| Excluir lojaDELETE | /users/{user_id}/stores/{id} | Exclui uma loja e a desvincula de seus caixas. |
Cada caixa é um ponto de venda dentro de uma loja associado a um Código QR estático. No modo dinâmico ou híbrido, a order gera também um QR único por transação.
| Operação | Path | Descrição |
| Criar caixaPOST | /pos | Cria um caixa em uma loja, gera o Código QR estático e permite definir o modo de operação do ponto de venda. |
| Obter caixaGET | /pos/{id} | Retorna o detalhe de um caixa, incluindo o qr_code para exibição no ponto de venda. |
| Buscar em caixasGET | /pos | Busca caixas por filtros como nome ou loja, retornando resultados paginados. |
| Atualizar caixaPUT | /pos/{id} | Atualiza a configuração de um caixa existente. |
| Excluir caixaDELETE | /pos/{id} | Exclui um caixa e seu Código QR associado. |
As orders são as solicitações de cobrança processadas via Código QR. Conforme o modo configurado, a order é atribuída ao QR estático do caixa, gera um QR dinâmico por transação, ou ativa os dois no modo híbrido; em todos os casos, o cliente paga escaneando o código com o app do Mercado Pago.
| Operação | Path | Descrição |
| Criar orderPOST | /v1/orders | Cria uma order de cobrança processada via Código QR. No modo estático é atribuída ao QR do caixa, no modo dinâmico gera um QR por transação e no modo híbrido ativa os dois; o cliente escaneia o código com o app do Mercado Pago. |
| Obter order por IDGET | /v1/orders/{id} | Retorna o status e o detalhe de uma order, incluindo o resultado do pagamento. |
| Reembolsar uma orderPOST | /v1/orders/{id}/refund | Reembolsa uma order paga, total ou parcialmente. |
| Cancelar order por IDPOST | /v1/orders/{id}/cancel | Cancela uma order pendente antes de ser paga pelo cliente. |
| Operação | Path | Descrição |
| Obter contestaçãoGET | /v1/chargebacks/{id} | Retorna o detalhe de uma contestação, sendo o status da disputa, o valor afetado e o prazo para definição. |