Para testar a correta criação de uma order e o processamento da transação associada, siga os passos a seguir.

1. Crie uma loja e caixa certificando-se de utilizar seu Access Token de teste ao realizar as solicitações necessárias. Além disso, certifique-se de definir o campo fixed_amount=true ao criar o caixa. Os links na resposta do objeto QR fornecem as imagens do do seu caixa. Para mais detalhes, consulte a documentação Criar loja e caixa.

2. Ainda utilizando seu Access Token de teste, envie um POST ao endpoint /v1/orders certificando-se de incluir o external_pos_id do caixa criado no passo anterior. Para mais detalhes, consulte a documentação Integrar o processamento de transações > Criar uma order.

3. Armazene o identificador da order, retornado na resposta à sua criação sob o parâmetro id, para poder verificar o funcionamento correto das suas notificações webhooks.

4. Baixe o aplicativo do Mercado Pago no seu dispositivo móvel, disponível para Android e iOS, instale-o e, em seguida, inicie sessão com as credenciais da conta de teste comprador. Se, ao iniciar sessão com uma conta de teste ou navegar pelas seções de Suas integrações, for solicitada autenticação por e-mail, acesse nossa documentação para saber como validar o início de sessão em contas de teste.

5. Use seu dispositivo móvel para escanear o gerado anteriormente. O aplicativo mostrará o valor do pedido e as opções de pagamento disponíveis.

6. Realize a retirada utilizando o dinheiro disponível na conta do usuário de teste comprador.

7. Verifique se recebeu a notificação webhook do Mercado Pago para o processamento da order. O campo action, terá o valor order.processed, que indica que a order foi processada, e dentro do nó transactions.cash_outs você poderá ver o status da transação, como mostra o exemplo de notificação webhook abaixo.

json
Copiar
{
  "action": "order.processed",
  "api_version": "v1",
  "application_id": "8950412930771472",
  "data": {
    "external_reference": "ExtRef_123456",
    "id": "ORD01JYHTJA9M4NKTA06K7M808NJD",
    "status": "processed",
    "status_detail": "accredited",
    "total_amount": "100.00",
    "transactions": {
      "cash_outs": [
        {
          "amount": "100.00",
          "id": "CAS01JYHTJA9M4NKTA06K7N6SM4AT",
          "reference": {
            "id": "116232980550"
          },
          "status": "processed",
          "status_detail": "accredited"
        }
      ]
    },
    "type": "qr",
    "version": 2
  },
  "date_created": "2025-06-24T20:38:14.268358898Z",
  "live_mode": false,
  "type": "order",
  "user_id": "1898180608"
}

Para confirmar que o fluxo de processamento funciona corretamente, você poderá realizar um reembolso da transação processada no passo anterior.

Para isso, envie um POST ao endpoint Reembolsar uma order, certificando-se de incluir o id da order que deseja reembolsar e que foi obtido na resposta à sua criação. Se tiver dúvidas sobre como fazê-lo, acesse a seção Integrar o processamento de transações > Reembolsar uma order.

Por último, verifique se recebeu a notificação webhook do Mercado Pago correspondente a essa transação, que deverá indicar no campo action o valor order.refunded e também o status da transação reembolsada.

json
Copiar
{
"action": "order.refunded",
"api_version": "v1",
"application_id": "7604743202375507",
"data": {
  "external_reference": "ER_123456",
  "id": "ORDTST01KGJHVZN67QNNSGVY5G7ZY2M2",
  "status": "refunded",
  "status_detail": "refunded",
  "total_amount": "16.00",
  "transactions": {
    "cash_outs": [
      {
      "amount": "16.00",
      "id": "CAS01KGJHVZN7VGXJM8F8DKX3F0WV",
      "reference": {
        "id": "144675313044"
      },
      "refunded_amount": "16.00",
      "status": "refunded",
      "status_detail": "refunded"
      }
    ],
    "refunds": [
      {
      "amount": "16.00",
      "status": "processed",
      "status_detail": "",
      "transaction_id": "CAS01KGJHVZN7VGXJM8F8DKX3F0WV"
      }
    ]
  },
  "type": "qr",
  "version": 4
},
"date_created": "2026-02-03T20:10:38.081960352Z",
"live_mode": false,
"type": "order",
"user_id": "3134271656"
}

Para validar o funcionamento do fluxo de cancelamento, siga os passos a seguir:

1. O cancelamento de uma order de teste só é possível quando ela está com o status created. Portanto, crie uma nova order enviando um POST ao endpoint /v1/orders.
2. Faça uma solicitação para Cancelar order por ID incluindo o id da order obtida na resposta à sua criação, feita no passo anterior.
3. Por último, verifique se recebeu a notificação webhook do Mercado Pago correspondente a essa transação, que deverá indicar no campo action o valor order.canceled e também o status da transação cancelada.

json
Copiar
{
"action": "order.refunded",
"api_version": "v1",
"application_id": "7604743202375507",
"data": {
  "external_reference": "ER_123456",
  "id": "ORDTST01KGJHVZN67QNNSGVY5G7ZY2M2",
  "status": "canceled",
  "status_detail": "canceled",
  "total_amount": "16.00",
  "transactions": {
    "cash_outs": [
      {
      "amount": "16.00",
      "id": "CAS01KGJHVZN7VGXJM8F8DKX3F0WV",
      "reference": {
        "id": "144675313044"
      },
      "refunded_amount": "16.00",
      "status": "canceled",
      "status_detail": "canceled"
      }
    ],
    "refunds": [
      {
      "amount": "16.00",
      "status": "processed",
      "status_detail": "",
      "transaction_id": "CAS01KGJHVZN7VGXJM8F8DKX3F0WV"
      }
    ]
  },
  "type": "qr",
  "version": 4
},
"date_created": "2026-02-03T20:10:38.081960352Z",
"live_mode": false,
"type": "order",
"user_id": "3134271656"
}