Integration test - Checkout Pro - Mercado Pago Developers

Test your integration

Create test users

Use test accounts to ensure that your integration supports all possible flows and scenarios. They have the same features as a real Mercado Pago account, which allows you to test the functioning of the integrations you are developing.

To perform the test, you must have at least two accounts:

  • Seller: account required to configure application and credentials. This is your user account.
  • Buyer: account required to test the purchase process.

In addition to these accounts, it is also important to use test cards to test payment integration and simulate the purchase process, as well as balance in the test user's Mercado Pago account. See more details below.

To create accounts and test how the integrations work, follow the steps below.

  1. In Devsite, access the menu Your Integrations > Test Accounts and click on the Create Test Account button.
  2. On the "Create New Account" screen, enter a description for the account identification. Example: "Salesperson - store 1".
  3. Next, select the country of operation for the account. This information cannot be edited later and, in addition, Buyer and Seller users must be from the same country.
  4. Fill in a fictitious amount of money that will serve as a reference for you to test your applications. This amount will appear as a balance in the test user's Mercado Pago account and can be used to simulate payments, as well as with a test card.
  5. Click Create Test Account.
Attention
You can generate up to 15 test user accounts at the same time and it is not yet possible to delete them at the moment.

Ready! The test account has been created and will be displayed in the table with the following information:

  • Country location of origin of the account selected in your registration.
  • Account ID: description for test account identification.
  • User: auto-generated test account username. This username is used to log in with the test user.
  • Password: automatically generated test user account access password. To generate a new password, click on the 3 vertical dots at the end of the table row and select the option Generate new password.
  • Creation Date: date the test account was created.
Important
To edit the account ID or add more play money to test your applications, click on the 3 vertical dots at the end of the table row and select the option Edit data.
There are two ways to make the payment: as a guest user, using an email address of your choice, and as a registered user, using a Mercado Pago account with username and password. In this last scenario, money available in the account and pre saved cards will be enabled as payment methods.

Test the payment flow

1. Configure the checkout with the information of your selling user

Generate a preference with the credentials of the test user that you want to use as a seller.

2. Make a payment with your buyer user

Purchase as a guest user

When opening the checkout created with the data of your seller user:

  1. Select Card as the payment method.
  2. Enter the details of a test card.
  3. Fill in the desired email.

Buy as a registered user

When opening the checkout created with the data of your seller user:

  1. Log in to a Mercado Pago account with your buyer test user.
  2. Select Card as the payment method.
  3. Choose a pre saved card or enter the details of a new test card.
Important
  • Use low amounts to make the payment tests.
  • Always use test cards, since it is not possible to withdraw money.
  • Test Cards

    You can use test cards of local payment methods and simulate different payment responses, without the need to use a real card.

    For this, depending on your country, use one of the cards provided below.

    CardNumberSecurity codeExpiration date
    Mastercard5031 7557 3453 060412311/25
    Visa4009 1753 3280 617612311/25
    American Express3711 803032 57522123411/25

    To test different payment results, fill in the desired status in the cardholder's name:

    Payment StatusDescriptionIdentity document
    APROApproved payment123456789
    OTHEDeclined for general error123456789
    CONTPending payment-
    CALLDeclined with validation to authorize-
    FUNDDeclined for insufficient amount-
    SECUDeclined for invalid security code-
    EXPIDeclined due to due date issue-
    FORMDeclined due to form error-

    Receive payments

    To start charging, you must activate your credentials.

    Before activating them, verify if the credentials used in your integration are the same as those of the account responsible for receiving the money from sales.