Probar integración

Primero, deberás tokenizar el medio de pago.

Mercado Pago proporciona tarjetas de prueba que te permitirán probar pagos sin utilizar una tarjeta real.

Sus datos, como número, código de seguridad y fecha de caducidad, pueden ser combinados con los datos relativos al titular de la tarjeta, que te permitirán probar distintos escenarios de pago. Es decir, puedes utilizar la información de cualquier tarjeta de prueba y probar resultados de pago diferentes a partir de los datos del titular.

A continuación, puedes ver los datos de las tarjetas de débito y crédito de prueba. Selecciona aquella que quieras utilizar para probar tu integración.

Luego, elige qué escenario de pago probar, y completa los campos del titular de la tarjeta (Nombre y apellido, Tipo y número de documento) según lo indica la tabla a continuación.

Continúa registrando en tu sistema la tarjeta de prueba tokenizada siguiendo los pasos según el modelo de negocio al que se adapte tu integración. Recuerda utilizar tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`..

Como email del cliente, utiliza el formato testuser{número}@testuser.com (por ejemplo, testuser123456789@testuser.com).

• Registro con un primer pago con CVV
• Registro para pagos posteriores

Con el customer_id y el payment_profile_id generados en la etapa anterior, ya puedes procesar un pago automático de prueba.

Envía una solicitud al endpoint /v1/orders incluyendo tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`. y siguiendo las indicaciones detalladas para cada tipo de pago.

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
                    }
                }
            ]
        }
    }'

Si deseas probar otro escenario de pago, repite la solicitud asegurándote de incluir los datos asociados a la segunda tarjeta de prueba tokenizada.

Para verificar que el pago de prueba se realizó correctamente, envía una solicitud al endpoint /v1/orders/{id}GET reemplazando {id} por la identificación de la order recibida en la respuesta del paso anterior.

La respuesta deberá mostrar el estado del pago seleccionado al momento de ingresar los datos del titular de la tarjeta de prueba.

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, puedes verificar haber recibido la notificación Webhook con los datos de la order.