Testar a integração
Para testar a integração do Mercado Pago Point com seu sistema, simule diferentes status de transação por meio da nossa API. Assim, você poderá validar seu funcionamento em diferentes cenários antes de subir à produção. Não é possível processar pagamentos reais em um terminal físico utilizando contas de teste; para realizar transações reais no dispositivo Point, é necessário utilizar uma conta produtiva com meios de pagamento reais.
Nesses testes, você deve utilizar credenciais de testeChaves de acesso vinculadas a uma aplicação, utilizadas para testar a integração em um ambiente seguro. Você pode consultá-las na seção Credenciais da aplicação, dentro do ambiente de teste. Elas não permitem processar pagamentos reais.Acessar as credenciais de teste. Se você utilizar um terminal físico, recomendamos vinculá-lo previamente a essas credenciais. Para mais informações sobre como realizar essa associação, acesse Configurar terminal.
Usar dispositivo virtual padrão
Se você não tiver um dispositivo físico, utilize o dispositivo virtual padrão, identificado pelo serial SBX0000001. Para construir seu ID, combine um poi_type válido para o país com esse serial, por exemplo: NEWLAND_N950__SBX0000001.
Com o ID do dispositivo virtual, você pode executar qualquer um dos cenários descritos a seguir.
Simular os cenários de teste
A seguir, selecione e execute os cenários desejados para validar sua integração. Para simular esses cenários, utilize o Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais, nunca deve ser exposta no frontend e começa com o prefixo `APP_USR`.Acessar as credenciais de teste.
A mudança de status da order pode levar até 10 segundos para ser processada (ou até 40 segundos para simular o status action_required). Durante esse processo, a order passa automaticamente para at_terminal antes de atingir o status final solicitado, com exceção de refunded, que transiciona diretamente. Para mais informações sobre os possíveis status, consulte a documentação Status de uma order e de uma transação.
Para testar a criação de uma order e o processamento do pagamento associado, siga os passos abaixo.
- Faça uma requisição ao endpoint de Criar orderPOST utilizando o Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais, nunca deve ser exposta no frontend e começa com o prefixo `APP_USR`.Acessar as credenciais de teste.
- Armazene o identificador da order retornado na resposta, disponível no parâmetro
id. - Envie uma solicitação ao endpoint Simular status da orderPOST, substituindo o
{order_id}no path da requisição pelo ID da order (order_id) criada na etapa 1. No body da requisição, informe o campostatuscom o valorprocessed.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/events' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-232********97488-12********26f67454********f4c8b49c********9526408' \
-d '{
"status": "processed",
"payment_method_type": "credit_card",
"installments": 1,
"payment_method_id": "visa",
"status_detail": "accredited"
}'Consulte na tabela abaixo as descrições dos parâmetros que podem ser enviados nesta requisição.
| Atributo | Tipo | Descrição | Valores possíveis | Obrigatoriedade |
status | Body.String | Status final que deseja simular para a order. | processed | Obrigatório |
payment_method_type | Body.String | Tipo de meio de pagamento a simular. | debit_card, credit_card | Opcional |
installments | Body.Integer | Número de parcelas do pagamento. | 1 | Condicional. Envie este campo apenas quando payment_method_type for credit_card. |
payment_method_id | Body.String | Bandeira do meio de pagamento. | amex, master, visa, debmaster, debvisa | Condicional. Envie este campo quando payment_method_type for debit_card ou credit_card. |
status_detail | Body.String | Detalhe específico do status que deseja simular. | accredited | Opcional |
Se a solicitação for bem-sucedida, a resposta retornará status 204 No Content, sem corpo de resposta.
Você receberá uma notificação Webhook do Mercado Pago com o campo action definido como order.processed. No nó transactions.payments, será possível consultar o status do pagamento, conforme exemplificado abaixo.
Além disso, é possível consultar o endpoint Obter order por IDGET para verificar o status da order.
json{ "action": "order.processed", "api_version": "v1", "application_id": "2644473656269379", "data": { "external_reference": "ext-ref", "id": "ORD01JY0PGGPZ4DBV73E2PXRBCQ84", "status": "processed", "status_detail": "accredited", "total_paid_amount": "120", "transactions": { "payments": [ { "amount": "120", "id": "PAY01JY0PGGPZ4DBV73E2Q0DQZQCJ", "paid_amount": "120", "payment_method": { "id": "visa", "installments": 1, "type": "credit_card" }, "reference": { "id": "115019989861" }, "status": "processed", "status_detail": "accredited" } ] }, "type": "point", "version": 3 }, "date_created": "2025-06-18T05:00:19.274162018Z", "live_mode": false, "type": "order", "user_id": "123456" }
Para validar que sua integração lida corretamente com pagamentos que falharam, simule o status failed de uma order.
- Faça uma nova requisição ao endpoint Criar orderPOST utilizando o Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais, nunca deve ser exposta no frontend e começa com o prefixo `APP_USR`.Acessar as credenciais de teste.
- Armazene o identificador da order retornado na resposta, disponível no parâmetro
id. - Envie uma solicitação ao endpoint Simular status da orderPOST, substituindo o
{order_id}no path da requisição pelo ID da order (order_id) criada na etapa 1. No body da requisição, informe o campostatuscom o valorfailed.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/events' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-232********97488-12********26f67454********f4c8b49c********9526408' \
-d '{
"status": "failed",
"payment_method_type": "credit_card",
"installments": 1,
"payment_method_id": "visa",
"status_detail": "insufficient_amount"
}'Consulte na tabela abaixo as descrições dos parâmetros que podem ser enviados nesta requisição.
| Atributo | Tipo | Descrição | Valores possíveis | Obrigatoriedade |
status | Body.String | Status final que deseja simular para a order. | failed | Obrigatório |
payment_method_type | Body.String | Tipo de meio de pagamento a simular. | debit_card, credit_card | Opcional |
installments | Body.Integer | Número de parcelas do pagamento. | 1 | Condicional. Envie este campo apenas quando payment_method_type for credit_card. |
payment_method_id | Body.String | Bandeira do meio de pagamento. | amex, master, visa, debmaster, debvisa | Condicional. Envie este campo quando payment_method_type for debit_card ou credit_card. |
status_detail | Body.String | Detalhe específico do status que deseja simular. | bad_filled_card_data, required_call_for_authorize, card_disabled, high_risk, insufficient_amount, invalid_installments, max_attempts_exceeded, rejected_other_reason, processing_error | Opcional |
Se a solicitação for bem-sucedida, a resposta retornará status 204 No Content, sem corpo de resposta.
Você receberá uma notificação Webhook do Mercado Pago com o campo action definido como order.failed. No nó transactions.payments, será possível consultar o status do pagamento, conforme exemplificado abaixo.
Além disso, é possível consultar o endpoint Obter order por IDGET para verificar o status da order.
json{ "action": "order.failed", "api_version": "v1", "application_id": "123456", "data": { "external_reference": "ext_ref_1234", "id": "ORD01K23219YK26BC6GK0HASE8VT6", "status": "failed", "status_detail": "failed", "transactions": { "payments": [ { "amount": "120", "id": "PAY01K22Y503EJ8JHGF64KGY1PZ2B", "payment_method": { "id": "debvisa", "installments": 1, "type": "debit_card" }, "reference": { "id": "123456789980" }, "status": "failed", "status_detail": "bad_filled_card_data" } ] }, "type": "point", "version": 3 }, "date_created": "2025-08-07T20:03:04.897928692Z", "live_mode": false, "type": "order", "user_id": "123456" }
Para validar o fluxo de reembolso, simule o status refunded em uma order já processada. Como esse status só pode ser aplicado a orders com processed, execute antes o cenário "Criar uma order e processar o pagamento".
Envie uma solicitação ao endpoint Simular status da orderPOST, substituindo o {order_id} no path da requisição pelo ID da order processada anteriormente. No body da requisição, informe o campo status com o valor refunded.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/events' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-232********97488-12********26f67454********f4c8b49c********9526408' \
-d '{
"status": "refunded"
}'Consulte na tabela abaixo as descrições dos parâmetros que podem ser enviados nesta requisição.
| Atributo | Tipo | Descrição | Valores possíveis | Obrigatoriedade |
status | Body.String | Status final que deseja simular para a order. Importante: Para simular este status, a order deve ter sido processada previamente. | refunded | Obrigatório |
Se a solicitação for bem-sucedida, a resposta retornará status 204 No Content, sem corpo de resposta.
Você receberá uma notificação Webhook do Mercado Pago com o campo action definido como order.refunded, indicando que a order foi reembolsada, conforme exemplificado abaixo.
Além disso, é possível consultar o endpoint Obter order por IDGET para verificar o status da order.
json{ "action": "order.refunded", "api_version": "v1", "application_id": "2644473656269379", "data": { "external_reference": "ext-ref", "id": "ORD01JY0PGGPZ4DBV73E2PXRBCQ84", "status": "refunded", "status_detail": "refunded", "total_paid_amount": "120", "type": "point", "version": 4 }, "date_created": "2025-06-18T05:05:08.255803326Z", "live_mode": false, "type": "order", "user_id": "123456" }
Para validar o fluxo de cancelamento de pagamentos, simule o status canceled de uma order conforme indicado abaixo.
- Faça uma requisição ao endpoint Criar orderPOST utilizando o Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais, nunca deve ser exposta no frontend e começa com o prefixo `APP_USR`.Acessar as credenciais de teste.
- Armazene o identificador da order, retornado na resposta à sua criação sob o parâmetro
id. - Envie uma solicitação ao endpoint Simular status da orderPOST, substituindo o
{order_id}no path da requisição pelo ID da order criada na etapa 1. No body da requisição, informe o campostatuscom o valorcanceled.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/events' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-232********97488-12********26f67454********f4c8b49c********9526408' \
-d '{
"status": "canceled"
}'Consulte na tabela abaixo as descrições dos parâmetros que podem ser enviados nesta requisição.
| Atributo | Tipo | Descrição | Valores possíveis | Obrigatoriedade |
status | Body.String | Status final que deseja simular para a order. | canceled | Obrigatório |
Se a solicitação for bem-sucedida, a resposta retornará status 204 No Content, sem corpo de resposta.
Você receberá uma notificação Webhook do Mercado Pago com o campo action definido como order.canceled. No nó transactions.payments, será possível consultar o status do pagamento, conforme exemplificado abaixo.
Além disso, é possível consultar o endpoint Obter order por IDGET para verificar o status da order.
json{ "action": "order.canceled", "api_version": "v1", "application_id": "123456", "data": { "external_reference": "ext_ref_1234", "id": "ORD01JYH1Z1YJN4HZ8J3Q0RB3YP6D", "status": "canceled", "status_detail": "canceled", "transactions": { "payments": [ { "amount": "120", "id": "PAY01K22Y503EJ8JHGF64KGY1PZ2B", "status": "canceled", "status_detail": "canceled_on_terminal" } ] }, "type": "point", "version": 3 }, "date_created": "2025-08-07T19:30:44.741479284Z", "live_mode": false, "type": "order", "user_id": "123456" }
Para validar que sua integração lida corretamente com orders expiradas, simule o status expired de uma order.
- Faça uma requisição ao endpoint Criar orderPOST utilizando o Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais, nunca deve ser exposta no frontend e começa com o prefixo `APP_USR`.Acessar as credenciais de teste.
- Armazene o identificador da order, retornado na resposta à sua criação sob o parâmetro
id. - Envie uma solicitação ao endpoint Simular status da orderPOST, substituindo o
{order_id}no path da requisição pelo ID da order (order_id) criada previamente. No body da requisição, informe o campostatuscom o valorexpired.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/events' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-232********97488-12********26f67454********f4c8b49c********9526408' \
-d '{
"status": "expired"
}'Consulte na tabela abaixo as descrições dos parâmetros que podem ser enviados nesta requisição.
| Atributo | Tipo | Descrição | Valores possíveis | Obrigatoriedade |
status | Body.String | Status final que deseja simular para a order. | expired | Obrigatório |
Se a solicitação for bem-sucedida, a resposta retornará status 204 No Content, sem corpo de resposta.
Você receberá uma notificação Webhook do Mercado Pago com o campo action definido como order.expired. No nó transactions.payments, será possível consultar o status do pagamento, conforme exemplificado abaixo.
Além disso, é possível consultar o endpoint Obter order por IDGET para verificar o status da order.
json{ "action": "order.expired", "api_version": "v1", "application_id": "123456", "data": { "external_reference": "ext_ref_1234", "id": "ORD01JYH1Z1YJN4HZ8J3Q0RB3YP6D", "status": "expired", "status_detail": "expired", "transactions": { "payments": [ { "amount": "120", "id": "PAY01K22Y503EJ8JHGF64KGY1PZ2B", "status": "expired", "status_detail": "expired" } ] }, "type": "point", "version": 3 }, "date_created": "2025-08-07T19:50:29.172256789Z", "live_mode": false, "type": "order", "user_id": "123456" }
Em alguns casos, é necessário confirmar no terminal se o pagamento foi aprovado ou recusado. Para validar que sua integração lida corretamente com esse cenário, simule o status action_required de uma order. A order mudará automaticamente para o status at_terminal antes de alcançar action_required, e essa transição pode levar até 40 segundos.
O status action_required está disponível apenas no modo PDV.
- Faça uma solicitação ao endpoint Criar orderPOST utilizando o Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais, nunca deve ser exposta no frontend e começa com o prefixo `APP_USR`.Acessar as credenciais de teste.
- Armazene o identificador da order, retornado na resposta à sua criação sob o parâmetro
id. - Envie uma solicitação ao endpoint Simular status da orderPOST, substituindo o
{order_id}no path da requisição pelo ID da order (order_id) criada na etapa 1. No body da requisição, informe o campostatuscom o valoraction_required.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/events' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-232********97488-12********26f67454********f4c8b49c********9526408' \
-d '{
"status": "action_required"
}'Consulte na tabela abaixo as descrições dos parâmetros que podem ser enviados nesta requisição.
| Atributo | Tipo | Descrição | Valores possíveis | Obrigatoriedade |
status | Body.String | Status final que deseja simular para a order. | action_required | Obrigatório |
Se a solicitação for bem-sucedida, a resposta retornará status 204 No Content, sem corpo de resposta.
Você receberá uma notificação Webhook do Mercado Pago com o campo action definido como order.action_required, indicando que uma ação é requerida no terminal, conforme exemplificado abaixo.
Além disso, é possível consultar o endpoint Obter order por IDGET para verificar o status da order.
json{ "action": "order.action_required", "api_version": "v1", "application_id": "123456", "data": { "external_reference": "ext_ref_1234", "id": "ORD01JYH1Z1YJN4HZ8J3Q0RB3YP6D", "status": "action_required", "status_detail": "check_on_terminal", "type": "point", "version": 3 }, "date_created": "2025-06-24T13:28:36.44747706Z", "live_mode": false, "type": "order", "user_id": "123456" }
Depois de testar todos os cenários e verificar o correto funcionamento da sua integração com o Mercado Pago Point, você poderá Subir em produção.