Para testar a correta criação de uma order e o processamento do pagamento associado, 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 código QR 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 pagamentos > 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 código QR gerado anteriormente. O aplicativo mostrará o valor do pedido e as opções de pagamento disponíveis.

6. Realize o pagamento utilizando os cartões de teste disponíveis na conta do usuário de teste comprador, considerando os seguintes cenários:

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

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"
}

Para confirmar que o fluxo de pagamentos 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 pagamentos > 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 do pagamento reembolsado.

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"
}

Para validar o funcionamento do fluxo de cancelamento de pagamentos, 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 de pagamento 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 do pagamento cancelado.

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"
}