Inicio
Documentação
Recursos
Certificações
Comunidade

Recursos

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

Comunidade

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

Reembolsar uma order - Pagamentos presenciais - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Reembolsar uma order

POST

https://api.mercadopago.com/v1/orders/{order_id}/refund
Este endpoint permite criar uma devolução total de uma transação de pagamento associada a uma order para Mercado Pago Point. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
Parâmetros de requisição
PATH
order_id
string

OBRIGATÓRIO

ID da order que contém a transação de pagamento associada para ser reembolsada. Esse valor é retornado na resposta à requisição "Criar order".
HEADER
X-Idempotency-Key
string

OBRIGATÓRIO

Esta função permite repetir solicitaçõ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 cad...Ver mais
Parâmetros de resposta
id
string
Identificador da order reembolsada, recebido na resposta à sua criação.
status
string
Status atual da order ou da transação.
refunded: A order foi reembolsada com sucesso.
status_detail
string
Detalhes sobre o status do reembolso. É devolvido exclusivamente quando a order é reembolsada através da API.
transactions
object
Contém informações sobre a transação associada a uma order.
Erros

400Erro.

empty_required_header

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

401Erro.

unauthorized

O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.

404Erro.

order_not_found

O valor enviado como Access Token está incorreto, razão pela qual a order não pode ser encontrada. Verifique e tente a enviar requisição novamente com o valor correto.

409Erro.

idempotency_key_already_used

O valor enviado como header de idempotência já foi utilizado em uma solicitação diferente em um período menor que 24 horas. Por favor, tente a solicitação novamente enviando um novo valor.

500Erro.

idempotency_validation_failed

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

500

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-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    
Resposta de exemplo
{
  "id": "123",
  "status": "refunded",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "ref_01J67CQQH5904WDBVZEM1234D",
        "transaction_id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
        "reference_id": "12345678",
        "amount": "24.90",
        "status": "processed"
      }
    ]
  }
}