Este endpoint permite criar uma devolução total de uma todas as transações associadas a uma order para QR Code do Mercado Pago. Ou seja, o reembolso será feito na order e todas as suas transações, sejam pagamentos, retiradas de dinheiro ou ambos, serão devolvidas. 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
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_order_owner
O valor enviado como Access Token não é o mesmo usado para criar a order. Verifique o valor enviado para ajustá-lo e tente novamente.
in_store_payment_refund_order
O prazo permitido para emissão do reembolso da order foi excedido. Verifique estar dentro do período de dias a partir da data de criação da order.
partial_refund_not_allowed_with_cashout
Não são permitidos reembolsos parciais para orders com retiros de dinheiro (cashout).
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 Order ID não corresponde a uma order criada, razão pela qual 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.
invalid_order_status
Houve uma tentativa de reembolso de uma order com status que não permite. Verifique se o status é "processed", caso contrário, o reembolso não poderá ser processado.
order_already_refunded
Está tentando devolver uma order que já foi reembolsada. Verifique se você enviou o ID correto.
movement_operations_pending
A order tem movimentos pendentes, aguarde alguns minutos.
500Erro.
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 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'X-Idempotency-Key: f1561ba3-db87-46fe-bfda-2207726b9a6d' \
{
"id": "ORD0000ABCD222233334444555566",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"status": "processing",
"reference_id": "12345678"
}
]
}
}