Point Simulator - Integrate with POS - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps

Point Simulator

This tool allows you to test your integration safely as if you were in your store with a physical device. With this simulator, you will be able to create a payment intent and process it from the virtual device, simulating the possible statuses that a payment can present.

The simulator has two modes of usage:

  • PDV mode: simulates the integration of a complete system (device and POS) with our Integrations API. Access the PDV mode simulator.
  • Device mode: simulates a virtual Point device so that you can test your integration from HTTP requests. Access the Device Mode Simulator.
To use the simulator, it is not necessary to run the Change the operation mode service, since the simulator works by default in PDV mode.

How to use the simulator

1. Configure your credentials

The simulator only works with test accounts.

When using the simulator for the first time, you will need to enter your keys and select one of your available devices.

  • PDV mode: you must enter your test access-token and the simulator will assign you a virtual device.

  • Device mode: you must enter your test access-token and your device id obtained when listing your devices.

Remember that to use the simulator you must configure a test access-token(TEST-XXXXX-XXXXX-XXXXXXX) and you can get it in your integrations , option My credentials > Test credentials. To query a payment made by the simulator through the payments API , you must use the test access-token (the same one used in the simulator). If you are going to use the device mode of the simulator, remember that you must put X-Test-Scope:sandbox in the header to ensure that the payment attempt reaches the simulator device.

2. Simulate a payment intent

We have prepared different scenarios that allow you to simulate a real experience. In order to do this, you must select the amount according to the status you want to obtain:

SuccessfulAny other value different from the previous ones

3. Get the payment intent from the device

Once the payment intent has been created, you must click on the green button of the virtual device to obtain the created payment intent. Once found, you can verify that the amount initially entered matches the one shown on the device screen.

4. Swipe the card and process the payment

If the previous step was successful, you can click on the animation of the card, which represents the card swipe in the device. Processing will begin immediately and the device will display the corresponding result.

5. Receive the notification

If you followed the configuration steps for the Webhooks notifications, it is time for you to review your records. There, you will see that the notification of the transaction status was sent.

The simulator will allow you to make test payments. You can check out all the information corresponding in the section Payment API .