Este endpoint permite criar um reembolso total ou parcial das transações associadas a uma order para Código QR do Mercado Pago. Para um reembolso total, não envie body na requisição. Para um reembolso parcial, envie o campo transactions, do tipo array, com o identificador da transação e o valor a ser reembolsado. Reembolsos parciais estão disponíveis apenas para MLA, MLU e MLC. 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
array é opcional e deve ser enviado apenas para reembolsos parciais. Não envie este nó para um reembolso total.status_detail=accredited, o que permite que o reembolso seja emitido. Para verificar o status do reembolso, execute uma solicitação ao endpoint400Erro.
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 360 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: e6697bd6-5e60-4c7f-bd70-5af9cb4b18ca' \
-d '{
"transactions": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50"
}
]
}'{
"id": "ORD0000ABCD222233334444555566",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"status": "processing",
"reference_id": "12345678"
}
]
}
}