Suggest edit
Help us improve the documentation
Did you see wrong information and would you like us to explain something else or improve our manuals? Please leave your suggestions on GitHub.

Test your integration

How to test your integration?

Test users allow you to try the integration of your system with Mercado Pago without using real money.

Test user types Description
Seller Test account that you use to obtain credentials to set up in your system and interact with Mercado Pago APIs. You can also access Mercado Pago account and check approved transactions.
Buyer Test account you use to test the buying process. You must access Mercado Pago app with this user data. In case of having money in the account or saved cards, they wil be available as payment methods.

Generate test users

To make tests is necessary to have at least two users: a buyer and a seller.

Execute the following command to generate a test user:

Curl

curl -X POST \

-H "Content-Type: application/json" \
"https://api.mercadopago.com/users/test_user?access_token=PROD_ACCESS_TOKEN
-d '{"site_id":"MLA"}'
Note

Productive credentials should be used for the account you'll be operating with.

Response:

Json

{
"id": 123456,
"nickname": "TT123456",
"password": "qatest123456",
"site_status": "active",
"email": "test_user_123456@testuser.com"
}
IMPORTANT
  • You can generate up to 10 test accounts at the same time. Because of that, we recommend to save email and password for each one.
  • Test users expire after 60 days of no activity on Mercado Pago.
  • To make test payments we recommend to use low amounts.
  • Both buyer and seller should test users.
  • Use test cards, because is not possible to withdraw money.

Test cards

Card Number CVV Expiration date
Mastercard 5031 7557 3453 0604 123 11/25
Visa 4170 0688 1010 8020 123 11/25
American Express 3711 8030 3257 522 1234 11/25

To test different payments results, complete the data you want in the cardholder name:

  • APRO: Approved payment.
  • OTHE: Rejected due to general error.
  • CALL: Rejected with validation to authorize.
  • FUND: Rejected due to insufficient amount.
  • SECU: Rejected due to invalid CVV.
  • EXPI: Rejected due to expiration date problem.
Note

Here you can find more test cards.

Test payment process

1. With your seller user, assign an order to a Point of Sale.

To test attended model, generate an order with the test user credentials you want as seller and send an order to the QR code previously created

2. Make a payment with your buyer user.

  • A. Log in the Mercado Pago app with your buyer test user.
  • B. Click on Pay with QR and scan the QR code from the Point of Sale.
  • C. Choose a saved card or complete the data with a new one and pay.

3. Receive order notifications

Lastly, make sure you’ve received an status notification in your system. And you’re done!

Events to validate

Event Expected output Comments
QR scan before creating the order. A client scans a QR code before to making an order. App shows a waiting screen. Verify fixed_amount = true on the Point of Sale.
QR scanning. User scans QR code after order is created. App shows a checkout screen. Verify amount displayed on checkout.
Approved payment. User makes a successful payment. Point of Sale system receives information about an approved payment. Verify notifications were received.
Rejected payment. User makes a rejected payment. Point of Sale system receives information about the rejected payment and keeps waiting for the order to be pay. merchant_order status must be opened.
Second payment attempt. User first performs a rejected payments and then execute an approved payment. Point of sale system receives information about the rejected payment and an approved payment later. Don’t remove the order after a rejected payment.
Refunds. These are performed from the Point of Sale. Refunds impact in buyer account. See refunds.
Cancel order. Users change their mind and decides to pay in cash. Order is removed and, therefore, scanning the QR code only shows a waiting screen. Remove order from the Point of Sale.

Production mode

When your app is ready and working in test mode, and you want to start processing real payments, you have to complete the form located in credentials. Afterwards, Mercado Pago will be able to audit your website, app or Point of Sale software, checking if all rules are being followed. If necessary, an advisor will contact you to discuss how to fix your integration.

IMPORTANT
  • If you don’t complete the form, you won’t be able to do any type of returns.

Why is this process needed?

By following these steps, we can guarantee security for your clients’ data and achieve the best buying experience, helping maximizing conversion. Breaching these norms can cause being unable to process payments and even legal actions, as stated in our Terms & Conditions.

Your search returns no results.

Verifique a ortografia de termos de pesquisa ou teste com outras palavras-chave.