Crear reembolso/v1/payments/{id}/refundsCrear reembolsos parciales/totales para un pago específico. Si el campo de suma ha sido completado, creará un reembolso parcial, en caso contrario, creará un reembolso total.
POST
Productos que lo utilizan:
Parámetros para la solicitud
idstring
Localización: pathIdentificador de pagoREQUERIDO
X-Idempotency-Key
Localización: headerIdempotency key. Al usarse, evita los reembolsos duplicadosstring
amount
Localización: bodyMonto de reembolso. Si esta propiedad (monto) es removida del body, creará un reembolso total.number
Parámetros de respuesta
id
Localización: bodyIdentificador de reembolsonumber
payment_id
Localización: bodyIdentificador de pagonumber
amount
Localización: bodyMonto de reembolsonumber
metadata
Localización: bodyContiene metadatos del pago que nos envían en el post del paymentarray
Solicitud
curl
curl -X POST \
'https://api.mercadopago.com/v1/payments/{id}/refunds' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"amount": 5
}'
Respuesta
json
{
"id": 1009042015,
"payment_id": 18552260055,
"amount": 10,
"metadata": [
{}
],
"source": [
{
"name": "Firstname Lastname",
"id": "1003743392",
"type": "collector"
}
],
"date_created": "2021-11-24T13:58:49.312-04:00",
"unique_sequence_number": null,
"refund_mode": "standard",
"adjustment_amount": 0,
"status": "approved",
"reason": null,
"label": [
{}
],
"partition_details": [
{}
]
}
Errores
400bad_request
2063
401bad_request
401401--Token-inválido--Token-válido-requerido-
40404040--atributo-monto-debe-ser-positivo--Monto-debe-ser-mayor-a-0-
40414041--atributo-monto-debe-ser-numérico--Monto-debe-ser-un-número-
404bad_request
20322032--Reembolso-no-encontrado--X-Idempotency-key-ya-utilizada-
20002000--Pago-no-encontrado--Payment_Id_no_existe-