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.

Teste sua integração

Antes de partir para a produção, é muito importante que realize testes de fluxo de pagamentos, verificando se as configurações feitas nas preferências realmente. Proporcionar uma boa experiência aos seus clientes no checkout ajuda a garantir a conversão.

Você deve verificar se:

  • As informações do produto ou serviço a ser pago estão corretas.
  • Reconhece a conta do cliente para quem o e-mail é enviado.
  • Oferece os métodos de pagamento que deseja.
  • A experiência de pagamento é apropriada e se informa o resultado do pagamento.

Como testar minha integração

Os usuários de teste permitem que você faça testes no sua integração ao gerar fluxos de pagamento em uma cópia fiel da sua integração.

Tipos de usuarios Descrição
Vendedor É a conta de testes que você usa para configurar a aplicação e credenciais para a cobrança.
Comprador É a conta de testes que você usa para testar o processo de compra.

Como criar usuários

Para fazer os testes é necessário que você tenha pelo menos dois usuários: um comprador e um vendedor.

Execute o seguinte curl para gerar um usuário de teste:

Solicitação

Curl

curl -X POST \
-H "Content-Type: application/json" \
"https://api.mercadopago.com/users/test_user?access_token=PROD_ACCESS_TOKEN" \
-d '{"site_id":"MLM"}'

Resposta

Json

{
    "id": 123456,
    "nickname": "TT123456",
    "password": "qatest123456",
    "site_status": "active",
    "email": "test_user_123456@testuser.com"
}
Importante
  • Você pode gerar até 10 contas de usuários de teste ao mesmo tempo. Por isso, recomendamos salvar o e-mail e senha de cada um.
  • Os usuários de teste caducam após 60 dias sem atividade no Mercado Pago.
  • Para fazer pagamentos de teste, recomendamos usar valore baixos.
  • Tanto o comprador como o vendedor devem ser usuários de teste.
  • Use cartões de teste, já que não é possível retirar o dinheiro.

Teste o fluxo de pagamento

Você conta com um par de credenciais de teste, que permitem testar toda a integração em uma réplica exata do Modo de Produção, podendo simular transações utilizando cartões de teste:

Cartão Número Código de segurança Data de vencimento
Mastercard 5031 7557 3453 0604 123 11/25
Visa 4170 0688 1010 8020 123 11/25
American Express 3711 8030 3257 522 1234 11/25

Você também pode usar cartões de teste de métodos de pagamento locais de cada país.

Receba um pagamento

Com seu access_token e card_token obtidos, você pode fazer um teste para criar um pagamento.

Se, ao criar o pagamento, obtiver algum erro relacionado ao método de pagamento selecionado ou as contas em funcionamento, você será informado com um HTTP Status 400 Bad Request e o código detalhando o erro para que faça a correção e tente criar o pagamento novamente.

Testar todos os cenários possíveis de pagamento aprovado, pendente ou recusado. Para isso, no campo card_holder_name do formulário insira qualquer um dos prefixos a seguir:

  • APRO: Pagamento aprovado.
  • CONT: Pagamento pendente.
  • OTHE: Recusado por erro geral.
  • CALL: Recusado com validação para autorizar.
  • FUND: Recusado por quantia insuficiente.
  • SECU: Recusado por código de segurança inválido.
  • EXPI: Recusado por problema com a data de vencimento.
  • FORM: Recusado por erro no formulário.

Em cada caso, deverá informar ao seu cliente o resultado do pagamento e qual o próximo passo a seguir. Para isso, você receberá um HTTP Status 201 OK informando que o pagamento foi criado corretamente e um código de resultado para que possa redirecionar o cliente para a página com a mensagem correta.

Verifica ter recebido a notificação Webhook

Mercado Pago te enviará uma notificação do evento ocorrido. Valida que a tenha recebido corretamente e tratado corretamente no seu sistema de gestão.

Cancele um pagamento

Realize a devolução de um pagamento aprovado ou o cancelamento de um pagamento pendente e verifique que recebeu a notificação com atualização correspondente ao recurso.

Teste a criação de um cliente

Verifica que se crie o customer com o cartão associado e que seus dados de cartão sejam recuperados de modo correto quando carregar novamente o checkout.

Sua pesquisa não retorna resultados.

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