Recursos para IA
Reembolsar pagamentohttps://api.mercadopago.com/v1/advanced_payments/{advanced_payment_id}/refunds
Este endpoint reembolsa um pagamento ("advanced_payment"), de forma total ou parcial. Se o body da requisição estiver vazio ou o campo "amount" for 0, o reembolso será integral. Para um reembolso parcial, especifique o valor a ser devolvido. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
Request parameters
Header
Authorization
string
OBRIGATÓRIO
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
advanced_payment_id
number
OBRIGATÓRIO
Identificador único do pagamento a ser reembolsado.
Body
amount
number
Valor a ser reembolsado. Se 0 ou omitido, o valor total do pagamento é reembolsado.
Response parameters
id
number
Identificador único do reembolso.
payment_id
number
Identificador único do pagamento associado a este reembolso.
amount
number
Valor reembolsado.
source
object
Erros
400Erro de requisição.
invalid_path_param
O "advanced_payment_id" fornecido no path não é válido. Verifique e forneça um id válido para tentar novamente.
500Erro genérico.
internal_error
Ocorreu um erro interno no servidor. Tente novamente mais tarde. Se o problema persistir, entre em contato com o suporte e forneça o x-request-id e detalhes sobre a operação realizada.
Request
curl -X POST \
'https://api.mercadopago.com/v1/advanced_payments/{advanced_payment_id}/refunds'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-d '{
"amount": 24.5
}'Response
[
{
"id": "1009042015",
"payment_id": "18552260055",
"amount": "24.50",
"source": {
"name": "user_name",
"id": "abcdef1e23f4567d8e9123eb6591ff68df74c57930551ed980239f4538a7e530"
}
}
]