Realizar uma compra teste
Siga as etapas descritas abaixo para simular um fluxo de pagamento completo para Código QR modelo dinâmico.
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 que você criou.
- 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.
- Use as credenciais de produção do usuário vendedor de teste para criar uma loja e uma 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. - Ainda usando as credenciais do usuário de vendedor de teste, crie um pedido e atribua-o à caixa que você criou no passo anterior. Certifique-se de configurar o campo
notification_urlcom a URL onde deseja receber notificações sobre atualizações de pagamentos utilizando o tópicomerchant_order. - Utilize o parâmetro
qr_dataobtido na resposta à criação do pedido para gerar um código QR. Você pode utilizar ferramentas ou bibliotecas que o ajudarão a converter essa string em uma imagem de um código QR.
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 que você teste diferentes fluxos de pagamento.
Casos de validação
Caso queira, é possível 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, estão disponíveis detalhes sobre cada caso, incluindo o resultado esperado no sistema para diferentes situações e orientações sobre como proceder em cada cenário.
| 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 de 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. |
| 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. | Verifique que o seu Ponto de Venda não encerra a transação na caixa. |
| Expiração do pedido. O usuário tenta pagar após a expiração do QR. | A ordem expira e, ao escanear o código QR, uma tela de erro é exibida. | Verifique se você definiu o campo expiration_date no pedido e se ele é anterior ao momento em que o pedido é escaneado. |
Verificar notificações
Após ter realizado o pagamento com o usuário de teste, verifique se você recebeu as 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 que você recebeu na notificação. Isso permitirá que você valide 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.