Teste de integração
É crucial realizar testes do fluxo completo antes de ir para a produção, verificando se a criação de pagamentos é feita corretamente e se as mensagens são eficazes na comunicação com o usuário. Uma boa experiência para seus clientes no checkout ajuda a melhorar a conversão.
Para realizar uma compra teste é preciso utilizar as credenciais de teste do seu usuário de produção. Para obtê-las, acesse Detalhes da aplicação > Credenciais dentro do Painel do desenvolvedor ou em sua conta Mercado Pago, acessando Seu negócio > Configurações > Gestão e Administração > Credenciais.
Você pode utilizar cartões de teste de métodos de pagamento locais e simular diferentes respostas dos pagamentos, sem a necessidade de usar um cartão real.
Para isso, de acordo com o seu país, utilize algum dos cartões de crédito que disponibilizamos a seguir.
| Cartão | Número | Código de segurança | Data de vencimento |
| Mastercard | 5031 7557 3453 0604 | 123 | 11/30 |
| Visa | 4509 9535 6623 3704 | 123 | 11/30 |
| American Express | 3711 803032 57522 | 1234 | 11/30 |
Para testar diferentes resultados de pagamento, preencha o status desejado no nome do titular do cartão (campo card_holder_name):
| Status de pagamento | Descrição | Documento de identidade |
APRO | Pagamento aprovado | (DNI) 12345678 |
OTHE | Recusado por erro geral | (DNI) 12345678 |
CONT | Pagamento pendente | - |
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 | - |
CARD | Rejeitado por falta de card_number | - |
INST | Rejeitado por parcelas inválidas | - |
DUPL | Rejeitado por pagamento duplicado | - |
LOCK | Rejeitado por cartão desabilitado | - |
CTNA | Rejeitado por tipo de cartão não permitido | - |
ATTE | Rejeitado devido a tentativas excedidas de pin do cartão | - |
BLAC | Rejeitado por estar na lista negra | - |
UNSU | Não suportado | - |
TEST | Usado para aplicar regra de valores | - |
Testar um pagamento recusado em Mensageria de Pagamentos Automáticos
A seguir, apresentamos um cenário de teste para validar o correto funcionamento da sua integração de pagamentos recorrentes.
- Utilize sua integração com Checkout API para Obter os dados do cartão e criar o token.
- Crie o Cliente enviando um POST ao endpoint v1/customers com o e-mail
test_payer@example.com. - Associe o cartão previamente tokenizado ao cliente enviando um POST ao endpoint /v1/customers/{customer_id}/cards. Você deverá utilizar o
customer_idobtido na requisição para criar o cliente no path desta requisição, e enviar ocard_tokenno body. - Crie o pagamento recorrente sem CVV. Para o campo
card_holder_name, indique o valorOTHE, que permitirá gerar um pagamento recusado. Se precisar de mais informações sobre como criar esses pagamentos, acesse Mensageria de Pagamentos Automáticos.
curl
curl --location 'https://api.mercadopago.com/v1/payments' \ --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \ --header 'Content-Type: application/json' \ --header 'X-Idempotency-Key: <SOME_UNIQUE_VALUE>' \ --header 'X-Expand-Responde-Nodes: gateway.reference' \ --data '{ "transaction_amount": 100, "token": "12346622341", "payment_method_id": "master", "payer": { "id": "123456789-jxOV430go9fx2e", "type": "customer" }, "point_of_interaction": { "type": "CREDENTIAL_ON_FILE", "sub_type": "recurring", "transaction_data": { "first_transaction": false, "storage": "stored", "transaction_initiator": "merchant", "network_transaction_id": "n7w-c0d3-t7d", "subscription_id": "87654321", "subscription_sequence": { "number": 2, "total": 12 }, "invoice_period": { "period": 1, "type": "monthly" }, "billing_date": "2026-02-25", "reference": { "id": "20792195335" } } } }'
A resposta a esta requisição deverá retornar um pagamento recusado, de acordo com os dados inseridos para o meio de pagamento.
