Recursos para IA

Testar a integração

Antes de ir à produção, recomendamos testar o funcionamento correto da sua integração e do processamento das transações. Isso permitirá verificar se a integração foi feita corretamente e se as transferências estão sendo processados sem erros. Veja abaixo como testar a sua integração.

Caso deseje, antes de testar sua integração você poderá criptografar os seus dados para realizar as suas transações de teste. Para saber criar essa criptografia, acesse Criptografia de segurança. Lembrando que essa criptografia só é obrigatória para a subida em produção de sua integração, ou seja, para as suas trasações reais.

Para testar sua integração com Payouts, crie transações enviando um POST, com seu Access Token de testeChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Testes > Credenciais de teste. e o header X-Test-Token:true ao endpoint /v1/payouts/{id}/transactionsAPI para que a requisição seja feita em um ambiente de testes.

Transferências entre contas Mercado Pago:

curl
curl --location 'https://api.mercadopago.com/v1/payouts' \
--header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
--header 'Content-Type: application/json' \
--header 'X-Enforce-Signature: false' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
--header 'X-Test-Token: true' \
--data-raw '{
    "external_reference": "global_111",
    "config": {
        "notification_url": "https://your-webhook-endpoint.com/notifications"
    },
    "description": "description_root",
    "schedule_date": "2026-11-13T15:00:00",
    "transactions": [
        {
            "type": "account",
            "description": "description_transaction",
            "account": {
                "email": "test_user_7016385811392037126@testuser.com"
            },
            "amount": {
                "currency": "ARS",
                "value": 1
            },
            "external_reference": "test_mp-mp"
        }
    ]
}'

Transferências para outros bancos a partir do Mercado Pago:

curl
curl --location 'https://api.mercadopago.com/v1/payouts' \
--header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
--header 'Content-Type: application/json' \
--header 'X-Enforce-Signature: false' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
--header 'X-Test-Token: true' \
--data '{
    "external_reference": "global_111",
    "config": {
        "notification_url": "https://your-webhook-endpoint.com/notifications"
    },
    "description": "description_root",
    "schedule_date": "2026-11-13T15:00:00",
    "transactions": [
        {
            "description": "description_transaction",
            "type": "account",
            "account": {
                "holder": "Test payout",
                "number": "646016230131277849",
                "bank_id": "646"
            },
            "amount": {
                "currency": "ARS",
                "value": 10
            },
            "external_reference": "12344"
        }
    ]
}'

Para saber como enviar os campos restantes para executar essa solicitação, consulte Configuração da integração.

Pronto! Uma vez finalizadas estas etapas, a integração estará completa e você poderá subir em produção.

Configurar notificaciones

Configura la recepción de notificaciones de Mercado Pago para mantener actualizadas las transferencias en tu sistema.

Salir a producción

Conoce las recomendaciones para llevar tu integración con Payouts a producción de manera eficaz y segura.