Testar a integração

Primeiro, você deverá tokenizar o meio de pagamento.

O Mercado Pago fornece cartões de teste que permitirão que você teste pagamentos sem usar um cartão real.

Seus dados, como número, código de segurança e data de validade, podem ser combinados com os dados relativos ao titular do cartão, que permitirão que você teste diferentes cenários de pagamento. Ou seja, você pode usar as informações de qualquer cartão de teste e testar resultados de pagamento diferentes a partir dos dados do titular.

A seguir, você pode ver os dados dos cartões de débito e crédito de teste. Selecione aquele que você quer usar para testar sua integração.

Em seguida, escolha qual cenário de pagamento testar e preencha os campos do titular do cartão (Nome e sobrenome, Tipo e número de documento) conforme indicado na tabela abaixo.

Continue registrando em seu sistema o cartão de teste tokenizado, seguindo os passos de acordo com o modelo de negócio ao qual sua integração se adapta. Lembre-se de utilizar seu Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais, nunca deve ser exposta no frontend e começa com o prefixo `APP_USR`..

Como e-mail do cliente, utilize o formato testuser{número}@testuser.com (por exemplo, testuser123456789@testuser.com).

• Registro com uma primeira cobrança com CVV
• Registro para pagamentos posteriores

Com o customer_id e o payment_profile_id gerados na etapa anterior, você já pode processar um pagamento automático de teste.

Envie uma requisição ao endpoint /v1/orders incluindo seu Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais, nunca deve ser exposta no frontend e começa com o prefixo `APP_USR`. e seguindo as indicações detalhadas para cada tipo de pagamento.

curl
curl -X POST \
    'https://api.mercadopago.com/v1/orders' \
    -H 'Content-Type: application/json' \
    -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
    -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
    -d '{
        "type": "online",
        "processing_mode": "automatic",
        "total_amount": "100.00",
        "external_reference": "test-order-001",
        "payer": {
            "customer_id": "CUSTOMER_ID"
        },
        "transactions": {
            "payments": [
                {
                    "amount": "100.00",
                    "automatic_payments": {
                        "payment_profile_id": "PAYMENT_PROFILE_ID"
                    },
                    "stored_credential": {
                        "payment_initiator": "merchant",
                        "reason": "card_on_file",
                        "first_payment": true
                    }
                }
            ]
        }
    }'

Se você deseja testar outro cenário de pagamento, repita a requisição certificando-se de incluir os dados associados ao segundo cartão de teste tokenizado.

Para verificar se o pagamento de teste foi realizado corretamente, envie uma requisição ao endpoint /v1/orders/{id}GET substituindo {id} pela identificação da order recebida na resposta do passo anterior.

A resposta deverá mostrar o status do pagamento selecionado no momento de inserir os dados do titular do cartão de teste.

json
{
    "id": "ORD01JS2V6CM8KJ0EC4H502TGK1WP",
    "type": "online",
    "processing_mode": "automatic",
    "status": "processed",
    "status_detail": "accredited",
    "total_amount": "100.00",
    "transactions": {
        "payments": [
            {
                "id": "PAY01JS2V6CM8KJ0EC4H504R7YE34",
                "amount": "100.00",
                "status": "processed",
                "status_detail": "accredited"
            }
        ]
    }
}

Adicionalmente, você pode verificar se recebeu a notificação Webhook com os dados da order.