Realizar compra teste
Siga as etapas descritas abaixo para simular um fluxo de pagamento completo para Código QR.
Importante
Durante todo o fluxo de teste, você deverá usar as credenciais de produção dos usuários de teste previamente criadas. Em cada etapa, será indicado se é o usuário vendedor ou comprador.
Criar pedido
- Faça login no site do Mercado Pago com o nome de usuário e a senha da conta de vendedor teste previamente criados.
- Crie uma nova aplicação de teste para o código QR e obtenha as credenciais de produção (Access Token) do usuário de vendedor de teste.
- Utilize as credenciais de produção do usuário vendedor de teste para criar uma loja e caixa conforme instruções disponíveis nas respectivas documentações. Além disso, certifique-se de definir o campo
fixed_amount=trueao criar a caixa. Os links na resposta do objeto QR fornecem as imagens do Código QR da sua caixa. - Ainda com as credenciais do usuário vendedor de teste, crie um pedido e atribua-o à caixa criada no passo anterior. Este processo também atribui o pedido ao Código QR da caixa. Configure o campo
notification_urlpara a URL onde deseja receber notificações sobre atualizações de pagamentos, utilizando o tópicomerchant_order.
Importante
Se, ao fazer login com uma conta de teste ou navegar pelas seções de Suas integrações, for solicitada a autenticação por e-mail, acesse nossa documentação para saber
como validar o login em contas teste
.
Realizar pagamento
- Baixe o aplicativo do Mercado Pago no seu dispositivo móvel, disponível para Android e iOS, instale-o e, em seguida, faça login com as credenciais da conta de usuário de teste definida como comprador.
- Utilize seu dispositivo móvel para escanear o Código QR gerado anteriormente. O aplicativo exibirá o valor do pedido e as opções de pagamento disponíveis.
Importante
Os pagamentos Pix não podem ser realizados com credenciais de teste. Recomendamos selecionar outra forma de pagamento para realizar o teste de integração do Código QR.
- Realize o pagamento utilizando cartões de teste, que também permitirão testar diferentes fluxos de pagamento.
Casos de validação
Se você desejar, pode testar diferentes casos para validar se o seu sistema está integrado corretamente com o Mercado Pago. Estes cenários simulam situações que podem ocorrer ao realizar um pagamento.
Importante
Apesar de o ambiente de testes não permitir validar casos de devolução de pagamentos ou reembolsos, recomendamos que você implemente o fluxo de devoluções na sua integração de produção utilizando nossa
API de reembolsos
.
A seguir, você pode ver estes casos em detalhes, o resultado esperado no sistema para cada situação, e uma série de observações que indicarão o que fazer em cada caso.
| Caso | Resultado esperado | Observações |
| Escaneamento correto do QR. O usuário escaneia um Código QR válido, ou seja, um QR que foi previamente associado a um pedido. | O aplicativo exibe a tela de pagamento com o valor atribuído. | Verifique se o valor exibido na tela de pagamento corresponde ao valor atribuído durante a criação da ordem. Caso não corresponda, verifique se a ordem foi corretamente atribuída à caixa correta. |
| Pagamento aprovado. O usuário realiza um pagamento e ele é aprovado. | O sistema do PDV (Ponto de Venda) recebe as informações de um pagamento aprovado. | Verifique se você recebeu as notificações com o tópico merchant_order e verifique se o status delas está como closed. |
| Cancelar pedido. O usuário muda de ideia e decide pagar em dinheiro, por exemplo. | Elimine o pedido da caixa. | Escaneie o QR e verifique se a tela de espera é exibida. Isso confirmará que o pedido foi removido corretamente. |
| Escaneamento prévio à criação do pedido. O cliente escaneia um código QR válido antes de atribuir-lhe o pedido. | O aplicativo mostra a tela de espera. | Verifique se você configurou o campo fixed_amount=true ao criar a caixa. |
| Pagamento recusado. O usuário realiza um pagamento e ele é recusado. | O sistema de Ponto de Venda recebe as informações de um pagamento recusado e continua esperando que o pedido seja pago. | Verifique se você recebeu as notificações com o tópico merchant_order e confirme se o status dessas notificações está como opened. Aguarde a segunda tentativa de pagamento. |
| Segunda tentativa de pagamento. O pagamento realizado pelo usuário é rejeitado e, sem a necessidade de escanear novamente o QR, uma segunda tentativa é feita e é aprovada. | O sistema do Ponto de Venda recebe as informações de um pagamento rejeitado e, em seguida, de um pagamento aprovado. | Não elimine o pedido após um pagamento recusado e garanta que seu Ponto de Venda não encerre a transação na caixa. |
Verificar notificações
Após a realização do pagamento com o usuário de teste, verifique o recebimento das notificações com o tópico merchant_order sobre os estados do pedido em seu sistema.
Para verificar se elas foram processadas corretamente, faça uma requisição GET para o endpoint /merchant_orders com o ID da merchant order recibida na notificação. Isso permitirá validar o estado de cada uma:
- Se o estado retornado for
closed, o pedido foi pago com sucesso. - Se o estado retornado for
opened, o pedido ainda não foi pago. Aguarde até que o pagamento seja feito e aprovado.