Recursos para IA

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ãoNúmeroCódigo de segurançaData de vencimento
Mastercard5480 8328 0103 331112311/30
Visa4235 6477 2802 568212311/30
American Express3753 651535 56885123411/30

Para testar diferentes resultados de pagamento, preencha o status desejado no nome do titular do cartão (campo card_holder_name):

Status de pagamentoDescriçãoDocumento de identidade
APROPagamento aprovado(CPF) 12345678909
OTHERecusado por erro geral(CPF) 12345678909
CONTPagamento pendente-
CALLRecusado com validação para autorizar-
FUNDRecusado por quantia insuficiente-
SECURecusado por código de segurança inválido-
EXPIRecusado por problema com a data de vencimento-
FORMRecusado por erro no formulário-
CARDRejeitado por falta de card_number-
INSTRejeitado por parcelas inválidas-
DUPLRejeitado por pagamento duplicado-
LOCKRejeitado por cartão desabilitado-
CTNARejeitado por tipo de cartão não permitido-
ATTERejeitado devido a tentativas excedidas de pin do cartão-
BLACRejeitado por estar na lista negra-
UNSUNão suportado-
TESTUsado 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.

  1. Utilize sua integração com Checkout Transparente para Obter os dados do cartão e criar o token.
  2. Crie o Cliente enviando um POST ao endpoint v1/customers com o e-mail test_payer@example.com.
  3. Associe o cartão previamente tokenizado ao cliente enviando um POST ao endpoint /v1/customers/{customer_id}/cards. Você deverá utilizar o customer_id obtido na requisição para criar o cliente no path desta requisição, e enviar o card_token no body.
  4. Crie o pagamento recorrente sem CVV. Para o campo card_holder_name, indique o valor OTHE, 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.

Para mais informações sobre o fluxo de teste, acesse a seção de Realizar compra teste no Checkout Transparente ou no Checkout Bricks.