Testar a integração

O teste de integração da Mercado Pago Point ao seu sistema baseia-se na realização de uma série de transações e suas respectivas validações utilizando nossa API. Dessa forma, você poderá garantir o correto funcionamento da sua integração antes de receber pagamentos reais, a partir de diferentes cenários de teste.

Nessas transações, você deve utilizar suas credenciais de produçãoConjunto de chaves de acesso únicas vinculadas à sua aplicação que permitem receber pagamentos reais. Você pode acessá-las através de *Suas integrações > Detalhes da aplicação > Produção > Credenciais de produção*. Use sua Public Key de produção no frontend e seu Access Token de produção no backend., cartões reais e realizar operações por valores mínimos. Isso já está previsto e não apresentará nenhum problema, uma vez que o fluxo de teste garante a devolução do valor ao cartão que efetuou o pagamento.

Antes de iniciar os testes, certifique-se de que as notificações Webhooks estejam configuradas. Essa configuração é necessária para validar o correto funcionamento das notificações em cada cenário de teste.

Siga o passo a passo detalhado de cada cenário de teste para verificar sua integração.

Criar uma order e processar o pagamento

Para testar a correta criação de uma order e o processamento do pagamento associado, siga os passos abaixo.

Faça uma requisição para Criar orderAPI certificando-se de informar um valor mínimo para o campo transactions.payments.amount. Se tiver dúvidas sobre como fazer isso, acesse a seção Integrar o processamento de pagamentos > Criar uma order.
Armazene o identificador da order, retornado na resposta à sua criação sob o parâmetro id, para poder verificar o correto funcionamento das suas notificações Webhooks.
Processe a intenção de pagamento, que deve ser obtida automaticamente pelo terminal atribuído, seguindo as instruções na tela e utilizando um cartão real.
Verifique se recebeu a notificação Webhook do Mercado Pago para o processamento da order e do pagamento. O campo action, terá o valor order.processed, que indica que a order foi processada, e dentro do nó transactions.payments você poderá ver o status do pagamento, como mostra o exemplo de notificação Webhook abaixo.

json
{
  "action": "order.processed",
  "api_version": "v1",
  "application_id": "2644473656269379",
  "data": {
    "external_reference": "ext-ref",
    "id": "ORD01JY0PGGPZ4DBV73E2PXRBCQ84",
    "status": "processed",
    "status_detail": "accredited",
    "total_paid_amount": "5.00",
    "transactions": {
      "payments": [
        {
          "amount": "5.00",
          "id": "PAY01JY0PGGPZ4DBV73E2Q0DQZQCJ",
          "paid_amount": "5.00",
          "payment_method": {
            "id": "master",
            "installments": 1,
            "type": "credit_card"
          },
          "reference": {
            "id": "115019989861"
          },
          "status": "processed",
          "status_detail": "accredited"
        }
      ]
    },
    "type": "point",
    "version": 3
  },
  "date_created": "2025-06-18T05:00:19.274162018Z",
  "live_mode": true,
  "type": "order",
  "user_id": "123456"
}

Caso receba uma notificação sobre o processamento da order em vez de uma com a ação order.action_required, você deverá validar no terminal o status do pagamento e, se necessário, tentar criar uma order e processar o pagamento novamente para verificar o correto funcionamento do fluxo.

Reembolsar um pagamento

Para confirmar que o fluxo de pagamentos funciona corretamente, você deve realizar um reembolso da transação processada na etapa anterior, devolvendo assim o valor envolvido nesse cenário de teste.

Para isso, envie um POST para o endpoint Reembolsar uma orderAPI, certificando-se de incluir o id da order que deseja reembolsar e que foi obtido na resposta à sua criação. Se tiver dúvidas sobre como fazer isso, acesse a seção Integrar o processamento de pagamentos > Reembolsar uma order.

Por fim, verifique se recebeu a notificação Webhook do Mercado Pago correspondente a essa transação, que deverá indicar no campo action o valor order.refunded e também o status do pagamento reembolsado.

json
{
  "action": "order.refunded",
  "api_version": "v1",
  "application_id": "2644473656269379",
  "data": {
    "external_reference": "ext-ref",
    "id": "ORD01JY0PGGPZ4DBV73E2PXRBCQ84",
    "status": "refunded",
    "status_detail": "refunded",
    "total_paid_amount": "5.00",
    "type": "point",
    "version": 4
  },
  "date_created": "2025-06-18T05:05:08.255803326Z",
  "live_mode": true,
  "type": "order",
  "user_id": "123456"
}

Criar e cancelar uma order de pagamento

Para validar que o fluxo de cancelamento de pagamentos funciona corretamente, você pode testar ambos os modos de cancelamento: via API ou pelo terminal.

Para que seja possível cancelar sua order de teste via API, ela não deve ser obtida pelo terminal e deve permanecer no status created. Embora esse cenário de teste seja muito específico, pode ser útil para você aprender como resolver, a partir da sua integração, casos em que, por exemplo, seu terminal perca o sinal de Wi-Fi.

Para testar esse cenário, siga os passos abaixo.

Comece desligando o Wi-Fi do seu terminal.
Faça uma nova chamada para Criar orderAPI certificando-se de informar um valor mínimo para o campo transactions.payments.amount.
Verifique se a order não chegou ao terminal. Se já foi obtida, você deve cancelá-la pelo terminal e começar novamente esse processo.
Faça uma requisição para Cancelar order por IDAPI enviando no path o id da order criada no passo 2 e obtido na resposta à sua criação.

Depois de testar todos os cenários e verificar o correto funcionamento da sua integração com o Mercado Pago Point, você poderá Subir em produção.

Configurar notificações

Notificações são mensagens enviadas pelo servidor do Mercado Pago a partir de eventos realizados em sua aplicação.

Subir em produção

Conheça as recomendações necessárias para colocar, de maneira eficaz e segura, a sua integração em produção.

Documentação

Começando agora?

Recursos

Suporte

Comunidade

Testar a integração

Navegação

Recursos e Comunidade

Mercado Pago

País e idioma