Este endpoint executa a devolução total ou parcial de uma order processada. Para fazer o reembolso total, não é necessário 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. Múltiplos reembolsos parciais podem ser realizados sobre a mesma order, desde que o valor acumulado reembolsado não exceda o valor total pago. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO CONDICIONAL
OBRIGATÓRIO CONDICIONAL
400Erro de requisição.
refund_amount_exceeds
Um valor inválido foi enviado para alguma propriedade. O valor fornecido excede o disponível para reembolso. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
order_refund_already_in_process
Um reembolso total já está em processamento para esta order. Verifique a mensagem retornada nos detalhes do erro para identificar o problema e tente novamente.
401Erro. Access Token não autorizado.
401
O Access Token enviado está incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.
invalid_credentials
Não há suporte para credenciais de teste. Utilize usuários de teste com credenciais de produção para o ambiente de teste (sandbox) e as suas credenciais de produção para o ambiente de produção.
404Recurso não encontrado.
transaction_not_found
O ID da transação fornecido não existe nesta order. Use o id de `transactions.payments[].id`.
409Alguma regra específica do sistema não permite a realização da ação devido a restrições definidas.
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.
order_already_refunded
Order já reembolsada.
cannot_refund_order
Não é possível reembolsar a order. Verifique se a order já foi reembolsada.
order_refund_already_in_process
Já existe em processamento uma solicitação de reembolso completo para a order em questão.
500Erro genérico.
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 ' \
-H 'X-Idempotency-Key: e8b309d5-9a7e-4b2e-88b8-8d1282adfa77' \
-d '{
"transactions": [
{
"id": "PAY01HRYFWNYRE1MR1E60MW3X0T2P",
"amount": "100.00"
}
],
"splits": [
{
"user_id": 1,
"amount": "50.00"
}
]
}'{
"id": "ORD01J49MMW3SSBK5PSV3DFR32959",
"transactions": {
"refunds": [
{
"amount": "100.00"
}
]
}
}