Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizaçÔes das nossas soluçÔes e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agĂȘncias ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratĂĄ-los.

Comunidade

Fique por dentro das Ășltimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Reembolsar uma order - Pagamentos online - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Reembolsar uma order

POST

https://api.mercadopago.com/v1/orders/{order_id}/refund
Este endpoint executa a devolução total ou parcial das transaçÔes associadas a uma order. Para fazer o reembolso total, vocĂȘ nĂŁo deve enviar o valor a ser reembolsado no body da solicitação. Para efetuar um reembolso parcial deverĂĄ indicar o valor a ser reembolsado, juntamente com o identificador da transação que deseja devolver. Em caso de sucesso, a requisição retornarĂĄ uma resposta com o status 201.
Parùmetros de requisição
PATH
order_id
string

OBRIGATÓRIO

ID da order que deve ser reembolsada. Esse valor é retornado na resposta à requisição Criar order.
HEADER
X-Idempotency-Key
string

OBRIGATÓRIO

Esta função permite repetir requisiçÔes de forma segura, sem o risco de realizar a mesma ação mais de uma vez por engano. Isso Ă© Ăștil para evitar erros, como a criação de dois pagamentos idĂȘnticos. Para garantir que cada...Ver mais
BODY
transactions
array

OBRIGATÓRIO

ContĂ©m informaçÔes sobre as transaçÔes associadas Ă  order. Pode conter atĂ© 2 transaçÔes. Por exemplo, se deseja criar uma order com dois cartĂ”es, vocĂȘ pode adicionar um item ao array "payments", dividindo o valor total d...Ver mais
ParĂąmetros de resposta
id
string
Identificador da order processada na requisição.
status
string
Status atual da order.
processed: Todas as transaçÔes foram processadas com sucesso.
refunded: A order foi reembolsada.
status_detail
string
Detalhes sobre o status do pagamento.
refunded: A order foi reembolsada.
partially_refunded: A order foi reembolsada parcialmente.
transactions
object
Contém informaçÔes sobre as transaçÔes associadas a uma order.
Erros

400Erro de requisição.

empty_required_header

O header 'X-Idempotency-Key' é requerido e não foi enviado. Faça a requisição novamente incluindo-o.

invalid_path_param

O order_id fornecido no path da requisição não estå correto. Verifique e forneça um ID vålido para tentar novamente.

refund_amount_exceeds

O valor de devolução solicitado é maior do que o valor disponível.

404NĂŁo encontrado.

Error. Order nĂŁo encontrada.

Error. Transaction nĂŁo encontrada.

409Alguma regra específica do sistema não permite a realização da ação devido a restriçÔes definidas.

Alguma regra específica do sistema não permite a realização da ação devido a restriçÔes definidas.

Erro. Order jĂĄ reembolsada.

A order nĂŁo pode ser reembolsada. Verifique o status da order e tente novamente.

500Erro genérico.

idempotency_validation_failed

Falha na validação. Tente enviar a solicitação novamente.

internal_error

Erro genérico. Tente enviar a solicitação novamente.

Requisição
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/refund'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "transactions": [
    {
      "id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
      "amount": "24.90"
    }
  ]
}'
Resposta de exemplo
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "REF01J49MMW3SSBK5PSV3DFR32959",
        "transaction_id": "PAY01JEVQM06WDW16MAQ8B5SC0MSC",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "amount": "24.90",
        "status": "processed"
      }
    ]
  }
}