Troubleshooting
A seguir, você poderá encontrar uma lista de problemas que podem ocorrer durante sua integração e operação com Mercado Pago Point, e como solucioná-los.
Se você alterou via API o modo de operação do terminal para PDV ou SELF_SERVICE e a mudança não foi aplicada, reinicie-o.
Lembre-se de que cada atualização realizada no modo de operação dos terminals requer reiniciá-las para completar o processo.
Se sua integração parou de funcionar momentaneamente, isso pode ser devido a alguma interrupção inesperada em nossas APIs de pagamento.
Enquanto trabalhamos para restabelecer o serviço, e apenas provisoriamente, você pode continuar com o processamento de pagamentos com Mercado Pago Point alterando o modo de operação de seu terminal para STANDALONE, que é o modo não integrado com nossas APIs.
Se o terminal estiver no modo PDV, você poderá fazer a alteração via API, pelo terminal ou pelo Painel do Mercado Pago. Se estiver no modo SELF_SERVICE, faça a alteração via API ou pelo Painel, pois esse modo bloqueia o acesso às operações manuais do terminal.
Envie uma solicitação ao endpoint Alterar o modo de operaçãoPATCH utilizando o Access Token que corresponda segundo seu tipo de integração (própriaIntegrações de Mercado Pago Point ao seu sistema para uso próprio e configuradas a partir de credenciais de produção da sua aplicação. Para mais informações, acesse o link abaixo.Acessar as credenciais ou para terceirosIntegrações de Mercado Pago Point ao seu sistema em nome de um vendedor e configuradas a partir de credenciais obtidas por meio do protocolo de segurança OAuth. Para mais informações, acesse o link abaixo.Acessar as credenciais) e certificando-se de enviar o valor STANDALONE no campo terminals.operating_mode.
Confirme na resposta que a mudança no modo de operação tenha sido bem-sucedida e reinicie seu terminal para completar o processo.
PDV ou SELF_SERVICE. Assim, você manterá a conciliação automática entre seu sistema e o Mercado Pago e voltará a receber notificações.Se você criou uma order a partir do seu sistema e ela não é obtida automaticamente pelo terminal, isso pode ocorrer devido a problemas de conexão na sua rede.
Para solucioná-lo e poder continuar com o pagamento, você deverá pressionar o botão Atualizar em seu terminal, o que forçará a obtenção da order.
Esta solução também pode ser útil para cancelar a order. Enquanto ela estiver com status=created, você pode cancelá-la via APIPOST. Se a order já estiver com status=at_terminal, é possível solicitar seu cancelamento pelo mesmo endpoint enviando o header condicional x-allow-cancelable-status: at_terminal, ou atualizar o terminal e realizar o cancelamento pelo leitor. Para solicitações via API em at_terminal, aguarde a notificação Webhook de cancelamento para confirmar a conclusão.
Se momentaneamente você não estiver conseguindo realizar um reembolso via API e verificou que cumpre todos os requisitos para realizar essa operação, isso pode ocorrer devido a uma interrupção inesperada em nossas APIs de pagamento.
Enquanto trabalhamos para restabelecer o serviço, você pode realizar reembolsos manualmente pelo Painel do Mercado Pago. Se utilizar o modo PDV, também poderá realizá-los pelo terminal.
Esta opção está disponível somente no modo PDV. No modo SELF_SERVICE, utilize o Painel do Mercado Pago, pois o terminal bloqueia o acesso ao menu Mais opções.
Pressione o botão Mais opções na margem inferior de seu terminal e escolha a opção Atividade com este Point. Lá você poderá ver as operações realizadas.
Você deverá selecionar a operação que está querendo reembolsar para acessar seus Detalhes. Nesta tela, deslize até a opção Ações relacionadas, e selecione a opção Devolver dinheiro.
Por último, revise as informações para certificar-se de estar reembolsando a transação desejada e confirme a ação pressionando o botão Devolver.
A tela de "Detalhes da operação" agora deverá mostrar a transação reembolsada com o status "Cobrança devolvida" e, retrocedendo para "Mais opções", você poderá ver esta nova atividade com esse terminal.
order.refunded.Se você integrou a funcionalidade de impressões e não está conseguindo obtê-las a partir de seu terminal, primeiro deve certificar-se de ter habilitada esta opção. Para isso, entre em contato com nossa equipe de Suporte e solicite sua atualização.
Se seu terminal já conta com a atualização necessária para realizar impressões, esta funcionalidade pode estar falhando devido a problemas técnicos, como rolo de papel insuficiente ou que a bobina tenha superaquecido. Você deverá revisar os avisos do terminal para poder entender e solucionar o problema em cada caso.
Verifique ter configurado corretamente as notificações via Webhooks para o tópico Order (Mercado Pago). Se você tem configurado algum outro tópico, como Pagamentos ou Integrações Point, pode estar recebendo alertas inconsistentes com sua integração.