Endpoints disponíveis
Todos os endpoints que compõem a integração do Mercado Pago Point, desde a configuração inicial da infraestrutura até a gestão 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 e terminais Point que operam naquele local.
| Operação | Path | Descrição |
| Criar lojaPOST | /users/{user_id}/stores | Registra uma loja física onde operarão os caixas e terminais Point. |
| Pesquisar lojasGET | /users/{user_id}/stores/search | Pesquisa lojas por external_id ou outros parâmetros disponíveis, retornando resultados paginados. |
| Obter lojaGET | /stores/{id} | Retorna os dados de cadastro de uma loja: nome, horário comercial, localização e identificador externo. |
| 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. Ao criá-lo, você pode vinculá-lo a um terminal Point para que receba as orders de cobrança.
| Operação | Path | Descrição |
| Criar caixaPOST | /pos | Cria um caixa em uma loja e o vincula a um terminal Point para processar cobranças. |
| Pesquisar caixasGET | /pos | Pesquisa caixas por external_id ou outros parâmetros disponíveis; retorna resultados paginados. |
| Obter caixaGET | /pos/{id} | Retorna o detalhe de um caixa, incluindo seu status e configurações. |
| Atualizar caixaPUT | /pos/{id} | Atualiza a configuração de um caixa existente. |
| Excluir caixaDELETE | /pos/{id} | Exclui um caixa e desvincula o terminal associado. |
Os terminals Point são os dispositivos físicos do Mercado Pago Point associados à sua conta. Você pode consultá-los e configurar seu modo de operação via API.
| Operação | Path | Descrição |
| Obter lista de terminalsGET | /terminals/v1/list | Lista os terminals disponíveis para a conta, retornando o identificador, o modo de operação e o caixa associado a cada terminal. |
| Atualizar modo de operação do terminalPATCH | /terminals/v1/setup | Altera o modo de operação do terminal entre STANDALONE e PDV. |
As orders são as solicitações de cobrança enviadas ao terminal. Seu backend cria a order com o valor e o caixa destino para que o terminal a receba automaticamente e o cliente realize o pagamento.
| Operação | Path | Descrição |
| Criar orderPOST | /v1/orders | Cria uma order de cobrança e a envia ao terminal vinculado ao caixa. O cliente realiza o pagamento. |
| Obter order por IDGET | /v1/orders/{id} | Retorna o status e o detalhe de uma order, incluindo o resultado do pagamento no terminal. |
| Cancelar order por IDPOST | /v1/orders/{id}/cancel | Cancela uma order pendente antes de ser processada pelo terminal. |
| Reembolsar uma orderPOST | /v1/orders/{id}/refund | Reembolsa uma order processada, total ou parcialmente. |
| Simular estado da orderPOST | /v1/orders/{id}/events | Simula o resultado de uma order em ambiente de testes com os status processed, failed ou cancelled, entre outros, sem processar um pagamento real. |
| 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. |