Test integration

First, you must tokenize the payment method.

Mercado Pago provides test cards that will allow you to test payments without using a real card.

Their data, such as number, security code, and expiration date, can be combined with the data relating to the cardholder, which will allow you to test different payment scenarios. That is, you can use the information of any test card and test different payment results based on the cardholder's data.

Below, you can see the data of the test debit and credit cards. Select the one you want to use to test your integration.

Next, choose which payment scenario to test and fill in the cardholder's information (First name and last name, Document type and number) as indicated in the table below.

Continue registering the tokenized test card in your system, following the steps according to the business model your integration adapts to. Remember to use your test Access TokenPrivate key linked to an application, used in the backend to authenticate operations in the test environment. You can find it in the application's Credentials section, within the test environment. It cannot process real payments, must never be exposed in the frontend, and starts with the `APP_USR` prefix..

As the customer email, use the format testuser{number}@testuser.com (for example, testuser123456789@testuser.com).

• Registration with a first payment with CVV
• Registration for future payments

With the customer_id and payment_profile_id generated in the previous stage, you can now process an automatic test payment.

Send a request to the endpoint /v1/orders including your test Access TokenPrivate key linked to an application, used in the backend to authenticate operations in the test environment. You can find it in the application's Credentials section, within the test environment. It cannot process real payments, must never be exposed in the frontend, and starts with the `APP_USR` prefix. and following the detailed instructions for each payment type.

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

If you want to test another payment scenario, repeat the request making sure to include the data associated with the second tokenized test card.

To verify that the test payment was processed correctly, send a request to the endpoint /v1/orders/{id}GET replacing {id} with the order identification received in the response from the previous step.

The response should show the payment status selected when entering the test cardholder data.

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

Additionally, you can verify that you received the Webhook notification with the order data.