Integrar o processamento de pagamentos
O processamento de pagamentos com o Mercado Pago Point é realizado por meio da criação de orders associadas a uma transação de pagamento. Essas orders permitem que seu sistema inicie e acompanhe cada pagamento processado no terminal, relacione-o à operação correspondente por meio de external_reference e mantenha a conciliação atualizada a partir das alterações de status.
No modo PDV, o vendedor cria uma order, que é enviada automaticamente ao terminal Point indicado para que o comprador realize o pagamento.
No modo SELF_SERVICE, a order é processada em tempo real entre o totem utilizado pelo comprador e o Mercado Pago, sem intervenção manual. Nesse modo, o terminal fica dedicado ao processamento de pagamentos, com acesso restrito às configurações e funcionalidades avançadas.
Esta integração permite criar, processar e cancelar orders, além de realizar reembolsos e consultar informações e atualizações de status das transações.
Para começar a processar pagamentos com o Point a partir dos pontos de venda, primeiro você precisa identificar a qual terminal a order será atribuída.
Lembre-se de que o terminal deve estar configurado no modo PDV ou SELF_SERVICE.
Para isso, envie uma solicitação ao endpoint Obter terminalsGET, utilizando seu 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.
Caso necessário, é possível filtrar a busca usando os query params opcionais store_id e pos_id, que correspondem aos identificadores da loja e do caixa retornados na resposta à criação de cada um.
curlcurl -X GET \ 'https://api.mercadopago.com/terminals/v1/list?limit=50&offset=0&store_id=12354567&pos_id=23545678' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
A resposta dessa solicitação exibirá os terminals associados à sua conta, permitindo que você selecione aquele que deseja usar para criar sua order.
A identificação do terminal pode ser feita pelos últimos caracteres do campo id, que correspondem ao número de série impresso na etiqueta traseira do terminal físico.
json{ "data": { "terminals": [ { "id": "NEWLAND_N950__N950NCB801293324", "pos_id": "23545678", "store_id": "12354567", "external_pos_id": "SUC0101POS", "operating_mode": "PDV | SELF_SERVICE" } ] }, "paging": { "total": 1, "offset": 0, "limit": 50 } }
Em seguida, você deve criar a order. Para isso, envie uma solicitação ao endpoint /v1/ordersPOST, incluindo seu 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, e o ID do terminal ao qual deseja atribuir a order, obtido no passo anterior.
A mesma solicitação de criação é utilizada para os modos PDV e SELF_SERVICE. No modo SELF_SERVICE, você pode definir por quanto tempo cada tela permanecerá disponível usando o parâmetro opcional config.point.screen_time. No modo PDV, config.point.screen_time não se aplica.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders' \ -H 'Content-Type: application/json' \ -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ -d '{ "type": "point", "external_reference": "ext_ref_1234", "expiration_time": "PT16M", "transactions": { "payments": [ { "amount": "24" } ] }, "config": { "point": { "terminal_id": "NEWLAND_N950__N950NCB801293324", "print_on_terminal": "no_ticket" }, "payment_method": { "default_type": "credit_card" } }, "description": "Point Smart 2", "integration_data": { "platform_id": "dev_1234567890", "integrator_id": "dev_1234567890", "sponsor": { "id": "446566691" } } }'
Consulte na tabela abaixo as descrições dos parâmetros que possuem alguma particularidade importante que deve ser destacada.
| Atributo | Tipo | Descrição | Obrigatoriedade |
Authorization | Header | Refere-se ao 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. | Obrigatório |
X-Idempotency-Key | Header | Chave de idempotência. Essa chave garante que cada solicitação seja processada apenas uma vez, evitando duplicidades. Use um valor exclusivo no header da requisição, como um UUID V4 ou uma string aleatória. | Obrigatório |
type | Body.String | Tipo de order, associado à solução do Mercado Pago para a qual está sendo criada. Para pagamentos com Mercado Pago Point, o único valor possível é point. | Obrigatório |
external_reference | Body.String | É uma referência externa da order, atribuída no momento de sua criação. Deve ser um valor único para cada order e não pode conter dados PII. O limite máximo permitido é de 64 caracteres e os permitidos são: letras maiúsculas e minúsculas, números e os símbolos de hífen (-) e sublinhado(_). | Obrigatório |
expiration_time | Body. String | Indica o período de validade da order de pagamento a partir de sua criação. Durante esse tempo, a order estará disponível para ser processada pelo cliente; caso não seja processada dentro do prazo especificado, expirará automaticamente e não poderá ser utilizada, sendo necessário gerar uma nova order de pagamento para continuar. O valor mínimo permitido é de 30 segundos (PT30S) e o máximo é de 3 horas (PT3H). Exemplos de uso: para uma expiração de 30 segundos: "PT30S", para 10 minutos: "PT10M" e para 1 hora e 15 minutos: "PT1H15M". | Opcional |
transactions.payments.amount | Body.String | Valor total da order de pagamento. Aceita até 2 casas decimais, e o separador decimal é opcional. Exemplos válidos: "10", "10.5" e "10.00". | Obrigatório |
config.point.screen_time | Body.String | Disponível apenas no modo SELF_SERVICE. Define, no formato ISO 8601, por quanto tempo as telas do terminal permanecem disponíveis para processar a order. Aceita valores de 5 segundos (PT5S) a 5 minutos (PT5M); se omitido, utiliza 15 segundos (PT15S). O tempo é reiniciado quando a tela muda ou o usuário interage com o terminal. Se a order não for processada nesse período, será cancelada. A tela de leitura do cartão é exibida por no máximo 60 segundos, mesmo que um valor superior seja configurado. | Opcional |
config.point.terminal_id | Body.String | Identificador do terminal Point que receberá a order. Você deve enviá-lo exatamente como foi retornado na requisição de Obter terminalsGET, como no seguinte exemplo: NEWLAND_N950__N950NCB801293324. | Obrigatório |
config.point.print_on_terminal | Body.String | Define se o terminal imprime o comprovante da transação. No modo PDV, aceita seller_ticket —valor padrão— ou no_ticket. No modo SELF_SERVICE, aceita seller_ticket, no_ticket ou buyer_ticket —valor padrão—. | Opcional |
processing_mode | Body.String | Modo de processamento da order. Se você não enviar este parâmetro, a order será processada no modo automatic. No modo PDV, você também pode enviar manual para criar uma order no modo reserva de pagamento. | Opcional |
config.payment_method.default_type | Body.String | Indica o meio de pagamento que o terminal aceitará. Por padrão, aceitará todos os meios de pagamento e permitirá que o cliente selecione o meio de pagamento que deseja. O envio deste parâmetro como credit_card é obrigatório ao criar uma order em modo reserva de pagamento. | Opcional |
Se a solicitação for bem-sucedida, a resposta retornará uma order com status created.
json{ "id": "ORD00001111222233334444555566", "type": "point", "user_id": "5238400195", "external_reference": "ext_ref_1234", "description": "Point Smart 2", "expiration_time": "PT16M", "processing_mode": "automatic", "country_code": "MEX", "currency": "MXN", "integration_data": { "application_id": "1234567890", "platform_id": "dev_1234567890", "integrator_id": "dev_1234567890", "sponsor": { "id": "446566691" } }, "status": "created", "status_detail": "created", "created_date": "2024-09-10T14:26:42.109320977Z", "last_updated_date": "2024-09-10T14:26:42.109320977Z", "config": { "point": { "terminal_id": "NEWLAND_N950__N950NCB801293324", "print_on_terminal": "no_ticket" }, "payment_method": { "default_type": "credit_card" } }, "transactions": { "payments": [ { "id": "PAY01J67CQQH5904WDBVZEM4JMEP3", "amount": "24.00", "status": "created" } ] } }
order_id) e o ID do pagamento (transactions.payments.id) obtidos na criação e relacione-os com external_reference. Esses dados permitirão realizar outras operações, consultar suas notificações e manter a conciliação com seu sistema. Além disso, consulte nossa documentação na seção Recursos para conhecer os possíveis status de uma order e de uma transação.Depois de criada, a order será enviada ao terminal atribuído.
No modo PDV, se a order não for carregada automaticamente, pressione o botão Atualizar ou, se o terminal possuir, o botão verde para recebê-la. Se você não preencher o parâmetro expiration_time, a order expirará 15 minutos após sua criação.
No modo SELF_SERVICE, a order é processada sem intervenção manual. Se você não preencher o parâmetro expiration_time, a order expirará 15 segundos após sua criação. Se o comprovante de pagamento for impresso pelo totem, envie no_ticket em config.point.print_on_terminal para evitar sua impressão pelo terminal Point.
O modo reserva de pagamento está disponível apenas para terminais configurados no modo PDV.
Além disso, para criar orders em modo reserva, o único meio de pagamento suportado é cartão de crédito (
default_type=credit_card).Após localizar os terminals associados à sua conta e definir em qual terminal a order será criada, você poderá criar a order em modo reserva.
O modo reserva permite separar a autorização do débito, onde os fundos ficam retidos no cartão do comprador e são capturados de forma independente quando o valor final é definido. É útil em hospedagens, aluguéis ou qualquer cenário em que o valor pode variar em relação ao valor pré-autorizado.
Para ativar o modo reserva, envie uma solicitação ao endpoint /v1/ordersPOST, incluindo seu 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, o id do terminal ao qual deseja atribuir a order, obtido no passo anterior, e inclua processing_mode=manual.
expiration_time não seja enviado, a order expirará automaticamente após 3 minutos. Se for enviado um valor superior a 3 minutos, a API retornará o erro 400 - invalid_expiration_time e a order não será criada. Esse prazo padrão evita que uma tentativa fique pendente quando o terminal não oferece suporte ao fluxo de reserva. Na criação de orders em modo automático (padrão), o prazo padrão permanece em 15 minutos.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ --header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ --data '{ "type": "point", "processing_mode": "manual", "external_reference": "ext_ref_1234", "description": "Reserva de hospedagem", "expiration_time": "PT2M", "transactions": { "payments": [ { "amount": "1500.00" } ] }, "config": { "point": { "terminal_id": "PAX_A910__SMARTPOS123456789" }, "payment_method": { "default_type": "credit_card" } } }'
Consulte na tabela abaixo as descrições dos parâmetros que possuem alguma particularidade importante que deve ser destacada.
| Atributo | Tipo | Descrição | Obrigatoriedade |
Authorization | Header | Refere-se ao 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. | Obrigatório |
X-Idempotency-Key | Header | Chave de idempotência. Essa chave garante que cada solicitação seja processada apenas uma vez, evitando duplicidades. Use um valor exclusivo no header da requisição, como um UUID V4 ou uma string aleatória. | Obrigatório |
type | Body.String | Tipo de order, associado à solução do Mercado Pago para a qual está sendo criada. Para pagamentos com Mercado Pago Point, o único valor possível é point. | Obrigatório |
processing_mode | Body.String | Modo de processamento da order. Para criar uma order no modo reserva a partir de um terminal configurado no modo PDV, envie manual. | Obrigatório |
description | Body.String | Descrição da order com, no máximo, 150 caracteres. Não pode estar vazia no modo reserva. | Obrigatório |
external_reference | Body.String | É uma referência externa da order, atribuída no momento de sua criação. Deve ser um valor único para cada order e não pode conter dados PII. O limite máximo permitido é de 64 caracteres e os permitidos são: letras maiúsculas e minúsculas, números e os símbolos de hífen (-) e sublinhado(_). | Obrigatório |
expiration_time | Body. String | Indica o período de validade da order de pagamento a partir de sua criação. Durante esse período, a order estará disponível para ser processada pelo cliente; caso não seja processada dentro do prazo especificado, expirará automaticamente e não poderá ser utilizada. O valor mínimo permitido é de 30 segundos (PT30S). No modo reserva, se o parâmetro não for enviado, a order expirará após 3 minutos (PT3M). Se for enviado um valor superior a 3 minutos, a API retornará o erro 400 - invalid_expiration_time e a order não será criada. | Opcional |
transactions.payments.amount | Body.String | Valor total da order de pagamento. Aceita até 2 casas decimais, e o separador decimal é opcional. Exemplos válidos: "10", "10.5" e "10.00". | Obrigatório |
config.point.terminal_id | Body.String | Identificador do terminal Point que receberá a order. Você deve enviá-lo exatamente como foi retornado na requisição de Obter terminalsGET, como no seguinte exemplo: NEWLAND_N950__N950NCB801293324. | Obrigatório |
config.payment_method.default_type | Body.String | Indica o meio de pagamento que o terminal aceitará. Para criar uma order em modo reserva, o único valor permitido é credit_card. | Obrigatório |
Se a solicitação for bem-sucedida, a resposta retornará uma order com status created.
json{ "id": "ORD01ABCDEFGHIJKLMNOPQRSTUVWX", "type": "point", "external_reference": "ext_ref_1234", "description": "Reserva de hospedagem", "expiration_time": "PT2M", "processing_mode": "manual", "country_code": "MEX", "user_id": "5238400195", "status": "created", "status_detail": "created", "currency": "MXN", "created_date": "2026-09-01T20:00:30.683Z", "last_updated_date": "2026-09-01T20:00:30.683Z", "integration_data": { "application_id": "5302442096311419" }, "config": { "point": { "terminal_id": "PAX_A910__SMARTPOS123456789", "print_on_terminal": "seller_ticket" }, "payment_method": { "default_type": "credit_card" } }, "transactions": { "payments": [ { "id": "PAY01ABCDEFGHIJKLMNOPQRSTUVWX", "amount": "1500.00", "status": "created" } ] } }
A order avança de forma assíncrona enquanto o terminal processa a operação. Quando o comprador autoriza o pagamento no terminal, a order transita para o status action_required com status_detail=waiting_capture. A partir desse momento, você pode capturar o valor autorizado — total ou parcialmente — ou cancelar a reserva antes de confirmar o débito.
Capturar order
Com a autorização e captura em duas etapas, você pode separar o momento em que os fundos são reservados no cartão do momento em que o débito definitivo é confirmado. Esse fluxo é útil quando o valor final da operação pode variar em relação ao valor pré-autorizado, como em hospedagens, aluguéis ou qualquer cenário de retenção de fundos.
Além disso, a captura só é possível em orders com
status=action_required e status_detail=waiting_capture. Tentar capturar uma order em qualquer outro status retornará o erro 409 - cannot_capture_order. Para mais informações sobre os possíveis erros retornados, acesse /v1/orders/{order_id}/capturePOST.Escolha a opção correspondente ao valor definitivo da operação.
Confirma o débito definitivo de 100% do valor autorizado na criação da order. O body da solicitação deve ser vazio.
Para isso, envie uma solicitação ao endpoint /v1/orders/{order_id}/capturePOST, incluindo seu 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 e o id da order a ser capturada, obtido após a sua criação.
curlcurl --request POST \ --url https://api.mercadopago.com/v1/orders/{order_id}/capture \ --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ --header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ --header 'Content-Type: application/json'
Consulte na tabela abaixo as descrições dos parâmetros necessários para esta requisição.
| Atributo | Tipo | Descrição | Obrigatoriedade |
order_id | Path | Identificador da order a ser capturada. Esse valor é retornado na resposta à requisição de criação da order. | Obrigatório |
Authorization | Header | Refere-se ao 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. | Obrigatório |
X-Idempotency-Key | Header | Chave de idempotência. Essa chave garante que cada solicitação seja processada apenas uma vez, evitando duplicidades. Use um valor exclusivo no header da requisição, como um UUID V4 ou uma string aleatória. | Obrigatório |
Se a solicitação for bem-sucedida, a resposta retornará uma order com status processed.
json{ "id": "ORD01ABCDEFGHIJKLMNOPQRSTUVWX", "status": "processed", "status_detail": "accredited", "transactions": { "payments": [ { "id": "PAY01ABCDEFGHIJKLMNOPQRSTUVWX", "amount": "1500.00", "status": "processed", "status_detail": "accredited" } ] } }
Após capturar a order com sucesso, seu status será processed e você poderá reembolsá-la total ou parcialmente por meio do mesmo fluxo disponível para as demais orders processadas.
O cancelamento de uma order pode ser solicitado via API ou, quando ela estiver no status at_terminal, realizado diretamente no terminal.
at_terminal, seja ele solicitado via API ou realizado no terminal, configure previamente suas notificações Webhooks. A notificação confirma que o cancelamento foi efetivado e permite manter sua conciliação.-
Se o
statusda order forcreated, o cancelamento deve ser feito via API e é processado de forma síncrona. -
Se o
statusforat_terminal, isso indica que a order já foi recebida pelo terminal. Nesse caso, o cancelamento pode ser solicitado de forma assíncrona via API ou realizado diretamente no terminal.
Escolha a opção que melhor se adequa às suas necessidades para saber como cancelar sua order.
Para cancelar uma order com status created ou at_terminal via API, envie uma solicitação ao endpoint /v1/orders/{order_id}/cancelPOST, incluindo seu 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 e o ID da order obtido na resposta à sua criação.
x-allow-cancelable-status não for enviado ou tiver um valor diferente de at_terminal, a solicitação de cancelamento via API de uma order em status=at_terminal retornará o erro 409 cannot_cancel_order.
Além disso, o recurso está disponível em terminals Point Smart 1 e Point Smart 2 que estejam com a versão de software atualizada para a última disponível. Caso contrário, a solicitação será tratada como se o header não tivesse sido enviado e retornará o mesmo erro.
Uma order criada em modo reserva só pode ser cancelada se ainda não tiver sido capturada, ou seja, a order deve estar com status=action_required e status_detail=waiting_capture. Nesse caso, o cancelamento atua como um void: cancela a autorização bancária e libera os fundos retidos no cartão do comprador.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders/{{ORDER_ID}}/cancel' \ -H 'Content-Type: application/json' \ -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ -H 'x-allow-cancelable-status: at_terminal' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
O resultado depende do status da order no momento da solicitação:
- Para
created, o cancelamento é síncrono e a API retornaHTTP 200, com a order emstatus=cancelede o pagamento emstatus_detail=canceled_by_api. O headerx-allow-cancelable-statusé opcional e, quando enviado, é ignorado. - Para
at_terminal, a API aceita a solicitação de forma assíncrona e retornaHTTP 202. A order permanece emstatus=at_terminal, enquanto o pagamento passa a terstatus_detail=cancellation_requested, até que uma notificação Webhook confirme o cancelamento. Se o pagamento já estiver em processamento, o terminal poderá priorizá-lo e não concluir o cancelamento; por isso, a respostaHTTP 202não deve ser interpretada como a confirmação final.
Resposta para uma order em created
json{ "id": "ORD00009999222233334444555566", "user_id": "5238400195", "type": "point", "external_reference": "ext_ref_1234", "description": "Point Smart 2", "expiration_time": "PT16M", "country_code": "MEX", "currency": "MXN", "processing_mode": "automatic", "integration_data": { "application_id": "1234567890", "platform_id": "dev_1234567890", "integrator_id": "dev_1234567890", "sponsor": { "id": "446566691" } }, "status": "canceled", "status_detail": "canceled", "created_date": "2024-09-10T14:26:42.109320977Z", "last_updated_date": "2024-09-10T14:26:42.109320977Z", "config": { "point": { "terminal_id": "NEWLAND_N950__N950NCB801293324", "print_on_terminal": "no_ticket" }, "payment_method": { "default_type": "credit_card" } }, "transactions": { "payments": [ { "id": "PAY01J67CQQH5904WDBVZEM4JMEP4", "amount": "24.00", "status": "canceled", "status_detail": "canceled_by_api" } ] } }
Resposta para uma order em at_terminal
json{ "id": "ORD00009999222233334444555566", "status": "at_terminal", "status_detail": "at_terminal", "transactions": { "payments": [ { "id": "PAY01J67CQQH5904WDBVZEM4JMEP4", "status": "at_terminal", "status_detail": "cancellation_requested" } ] } }
A resposta HTTP 202 confirma apenas que a solicitação foi aceita. Considere a order cancelada somente após receber a confirmação por meio das notificações Webhooks.
Caso necessário, é possível reembolsar uma order criada por meio da nossa API. Este endpoint permite realizar a devolução total ou parcial de uma transação de pagamento associada à order. Para solicitar um reembolso total, não é necessário enviar um body na requisição. Já para o reembolso parcial, é preciso informar no body o valor a ser reembolsado e o identificador da transação.
Escolha a opção que melhor se adequa às suas necessidades e siga as instruções correspondentes.
Para realizar o reembolso total de uma order, envie uma solicitação ao endpoint /v1/orders/{order_id}/refundPOST sem enviar o body na requisição. Certifique-se de incluir seu 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. Também é necessário informar o ID da order (order_id) que deseja reembolsar, obtido na resposta à sua criação.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders/{{ORDER_ID}}/refund' \ -H 'Content-Type: application/json' \ -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
Se a solicitação for bem-sucedida, a resposta trará o status=refunded e um novo nó transactions.refunds, que irá conter os detalhes do reembolso, além do ID do pagamento original (transactions.payments.id) e o ID da transação (transaction_id) de reembolso.
json{ "id": "ORD00001111222233334444555566", "status": "refunded", "status_detail": "refunded", "transactions": { "refunds": [ { "id": "REF01J67CQQH5904WDBVZEM1234D", "transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3", "reference_id": "12345678", "amount": "24.00", "status": "processed" } ] } }
Se necessário, você pode consultar os dados de uma order e suas transações associadas, sejam pagamentos ou reembolsos, incluindo seus status ou valores.
Embora o uso recorrente desta consulta via API não seja recomendado, ela pode ser útil caso você precise de informações adicionais sobre o pedido.
Para realizar a consulta, envie uma solicitação ao endpoint /v1/orders/{order_id}GET, incluindo 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, além do ID da order (order_id) obtido na resposta à sua criação.
curlcurl -X GET \ 'https://api.mercadopago.com/v1/orders/{{ORDER_ID}}' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
Se a solicitação for bem-sucedida, a resposta retornará todas as informações da order, incluindo seu status, o status do pagamento e/ou o status do reembolso em tempo real:
json{ "id": "ORD00001111222233334444555566", "user_id": "5238400195", "type": "point", "external_reference": "ext_ref_1234", "processing_mode": "automatic", "description": "Point Smart 2", "expiration_time": "PT16M", "country_code": "MEX", "currency": "MXN", "integration_data": { "application_id": "1234567890", "platform_id": "dev_1234567890", "integrator_id": "dev_1234567890", "sponsor": { "id": "446566691" } }, "status": "refunded", "status_detail": "refunded", "created_date": "2024-09-10T14:26:42.109320977Z", "last_updated_date": "2024-09-10T14:26:42.109320977Z", "config": { "point": { "terminal_id": "NEWLAND_N950__N950NCB801293324", "print_on_terminal": "no_ticket" }, "payment_method": { "default_type": "credit_card" } }, "transactions": { "payments": [ { "id": "PAY01J67CQQH5904WDBVZEM4JMEP3", "amount": "24.00", "refunded_amount": "24.00", "paid_amount": "24.00", "status": "refunded", "status_detail": "refunded", "reference_id": "12345678", "payment_method": { "type": "credit_card", "installments": 6, "id": "master" } } ], "refunds": [ { "id": "REF01J67CQQH5904WDBVZEM1234D", "transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3", "reference_id": "12345678", "amount": "24.00", "status": "processed" } ] } }