Este endpoint permite criar uma devolução total ou parcial de uma transação de pagamento associada a uma order para Mercado Pago Point. Para um reembolso total, o body da solicitação deve ficar vazio, enquanto que para um reembolso parcial, você deve indicar o valor a ser reembolsado junto com o identificador da transação de pagamento a ser devolvida, desde que a soma das devoluções não exceda o valor total da transação. Os reembolsos parciais estão disponíveis para pagamentos que foram realizados com cartão e códigos QR. Ambos os tipos de reembolsos podem ser realizados sujeitos às seguintes condições: para pagamentos efetuados com cartões físicos, até 90 dias após o pagamento; para pagamentos feitos através da Edenred, até às 23:59:59 do mesmo dia em que o pagamento foi realizado; para pagamentos feitos com Pluxee, até 5 dias úteis após o pagamento. Além disso, apenas orders com "status=processed" podem ser reembolsadas. Em caso de sucesso, a requisição retornará uma resposta com o status 201
POST
OBRIGATÓRIO
OBRIGATÓRIO
400Erro.
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 tem um formato inválido. Ele deve começar com o prefixo "ORD" e ser seguido por 26 caracteres. Verifique e forneça um ID válido para tentar novamente.
unsupported_partially_refunds
Devido a validações internas, a order não suporta reembolsos parciais.
refund_amount_exceeds
O valor do reembolso excede o valor disponível. Verifique se o valor solicitado é menor ou igual ao saldo disponível na order.
401Erro.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
user_not_authorized
Usuário não autorizado para realizar esta ação.
403Erro.
partial_refund_forbidden_with_tips
Reembolsos parciais proibidos quando a order tem gorjetas.
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.
transaction_not_found
A transação não foi encontrada. Verifique se o ID da transação enviado no corpo da requisição está correto e pertence à order especificada.
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.
order_already_refunded
A order já foi reembolsada.
cannot_refund_order
O status da order não permite o reembolso.
refund_period_exceeded
Foi excedido o tempo limite permitido para fazer um reembolso da order.
action_not_allowed_for_current_state
Ação não permitida pelo status atual do pagamento.
refund_in_progress
Reembolso em andamento, aguarde alguns minutos.
movement_operations_pending
A order tem movimentos pendentes, aguarde alguns minutos.
422Erro.
payment_not_refundable
Não é possível realizar o reembolso deste pagamento.
amount_not_refundable
O valor não pode ser reembolsado, tente com outro valor.
max_refunds_exceeded
Foi excedido o número máximo de reembolsos para esta order.
425Erro.
order_payment_not_yet_enabled_for_refund
A order ainda não está habilitada para o reembolso, tente novamente.
428Erro.
insufficient_money_for_refund
Não é possível realizar o reembolso, saldo insuficiente na conta.
500Erro.
idempotency_validation_failed
Falha na validação. Tente enviar a solicitação novamente.
500
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 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-d '{
"transactions": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "25"
}
]
}'{
"id": "ORD0000ABCD222233334444555566",
"status": "refunded",
"status_detail": "refunded",
"transactions": {
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"reference_id": "12345678",
"amount": "47",
"status": "processed"
}
]
}
}