Este endpoint permite executar a devolução total ou parcial das transações associadas a uma order de Wallet Connect. 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.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Erro de requisição.
empty_required_header
O header X-Idempotency-Key é obrigatório e não foi enviado. Faça a requisição novamente incluindo-o.
invalid_idempotency_key_length
O X-Idempotency-Key deve ter entre 1 e 64 caracteres.
invalid_path_param
O order_id fornecido no path não é válido. Verifique e forneça um order_id válido para tentar novamente.
refund_amount_exceeds
O valor do reembolso é maior do que o valor disponível na transação.
401Erro. Access Token não autorizado.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente enviar a requisição novamente com o valor correto.
404Não encontrado.
order_not_found
Order não encontrada. Verifique se o order_id enviado está correto.
transaction_not_found
Transação não encontrada. Verifique se o transaction_id enviado está correto.
409Alguma regra específica do sistema não permite a realização da ação devido a restrições definidas.
order_already_refunded
A order já foi totalmente reembolsada.
cannot_refund_order
A order não pode ser reembolsada. Verifique o status da order e tente novamente.
order_refund_already_in_process
Já existe em processamento uma solicitação de reembolso completo para esta order.
idempotency_key_already_used
O valor enviado como header de idempotência (X-Idempotency-Key) já foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.
operation_not_supported
A operação não é suportada para esta order. Verifique o status e status_detail da order e tente novamente.
423Recurso bloqueado.
resource_locked
A chave de idempotência (X-Idempotency-Key) está bloqueada por uma requisição em andamento. Por favor, tente novamente após um breve intervalo.
500Erro genérico.
idempotency_validation_failed
Falha na validação de idempotência. Tente enviar a solicitação novamente.
internal_error
Erro genérico. Tente enviar a solicitação novamente.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/refund'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: 4a19ec38-f52f-41e5-8736-54e9eb147ce6' \
-d '{
"transactions": [
{
"id": "PAY01KHY4WFPYXJ9Z7S5CGG0SE8KN",
"amount": "24.50"
}
]
}'{
"id": "ORDBTA01KHY4WFPYXJ9Z7S5CGED7WCTP",
"status": "refunded",
"status_detail": "refunded",
"transactions": {
"refunds": [
{
"id": "REF01KJZ0BPKX0BQ0KG1VPBMJDX9G",
"transaction_id": "PAY01KHY4WFPYXJ9Z7S5CGG0SE8KN",
"reference_id": "",
"amount": "50.00",
"status": "processed"
}
]
}
}