To test the correct creation of an order and the associated payment processing, follow the steps below.

1. Create a store and POS ensuring you use your test Access Token when making the necessary requests. Additionally, make sure to set the fixed_amount=true field when creating the POS. The links in the QR object response provide the QR code images for your POS. For more details, see the documentation Create store and POS.

2. Still using your test Access Token, send a POST to the endpoint /v1/orders making sure to include the external_pos_id from the POS created in the previous step. For more details, see the documentation Integrate payment processing > Create an order.

3. Store the order identifier, returned in the response to its creation under the id parameter, to be able to verify the correct functioning of your webhook notifications.

4. Download the Mercado Pago app on your mobile device, available for Android and iOS, install it, and then log in with the buyer test account credentials. If, when logging in with a test account or navigating through the Your integrations sections, email authentication is requested, access our documentation to learn how to validate login with test accounts.

5. Use your mobile device to scan the QR code generated earlier. The app will show the order value and available payment options.

6. Make the payment using the test cards available in the buyer test user account, considering the following scenarios:

7. Verify that you received the Mercado Pago webhook notification for the order and payment processing. The action field will have the value order.processed, which indicates that the order was processed, and within the transactions.payments node you can see the payment status, as shown in the webhook notification example below.

json
Copiar
{
  "action": "order.processed",
  "api_version": "v1",
  "application_id": "7364289770550796",
  "data": {
    "external_reference": "ER_123456",
    "id": "ORD01JV3AW3NFSTSTB669F41NACDX",
    "status": "processed",
    "status_detail": "accredited",
    "total_amount": "30.00",
    "total_paid_amount": "30.00",
    "transactions": {
      "payments": [
        {
          "amount": "30.00",
          "id": "PAY01JV3AW3NFSTSTB669F4JSAA6C",
          "paid_amount": "30.00",
          "payment_method": {
            "id": "account_money",
            "installments": 1,
            "type": "account_money"
          },
          "reference": {
            "id": "92937960454"
          },
          "status": "processed",
          "status_detail": "accredited"
        }
      ]
    },
    "type": "qr",
    "version": 2
  },
  "date_created": "2025-05-12T22:46:59.635090485Z",
  "live_mode": false,
  "type": "order",
  "user_id": "1403498245"
}

To confirm that the payment flow works correctly, you can perform a refund of the transaction processed in the previous step.

To do this, send a POST to the endpoint Refund an order, making sure to include the id of the order you want to refund and which was obtained in the response to its creation. If you have questions about how to do this, access the section Integrate payment processing > Refund an order.

Finally, verify that you received the corresponding Mercado Pago webhook notification for this transaction, which should indicate in the action field the value order.refunded and also the refunded payment status.

json
Copiar
{
  "action": "order.refunded",
  "api_version": "v1",
  "application_id": "7364289770550796",
  "data": {
    "external_reference": "ER_123456",
    "id": "ORD01JV3AW7R6WME2XT0KZRX7HVS6",
    "status": "refunded",
    "status_detail": "refunded",
    "total_amount": "30.00",
    "total_paid_amount": "30.00",
    "type": "qr",
    "version": 3
  },
  "date_created": "2025-05-12T22:47:05.813331521Z",
  "live_mode": false,
  "type": "order",
  "user_id": "1403498245"
}

To validate the functioning of the payment cancellation flow, follow the steps below:

1. Cancellation of a test order is only possible when it has the status created. Therefore, create a new payment order by sending a POST to the endpoint /v1/orders.
2. Make a request to Cancel order by ID including the id of the order obtained in the response to its creation, done in the previous step.
3. Finally, verify that you received the corresponding Mercado Pago webhook notification for this transaction, which should indicate in the action field the value order.canceled and also the canceled payment status.

json
Copiar
{
  "action": "order.canceled",
  "api_version": "v1",
  "application_id": "7364289770550796",
  "data": {
    "external_reference": "ER_123456",
    "id": "ORD01JV3AW2C31TE7FY2C4VHTJKB2",
    "status": "canceled",
    "status_detail": "canceled",
    "total_amount": "30.00",
    "type": "qr",
    "version": 2
  },
  "date_created": "2025-05-12T22:46:57.697535027Z",
  "live_mode": false,
  "type": "order",
  "user_id": "1403498245"
}