¿Qué documentación quieres buscar?
¿No sabes cómo empezar la integración?
Accede a los primeros pasosCrear reembolso
POST
Productos que lo utilizan:
Parámetros para la solicitud
PATH
id
Identificador de pagostring
REQUERIDO
HEADER
X-Idempotency-Key
Esta función permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores, como la creación de dos reembolsos idénticos, por ejemplo. ...Ver másstring
REQUERIDO
BODY
amount
Monto de reembolso. Si esta propiedad (monto) es removida del body, creará un reembolso total.number
Parámetros de respuesta
id
Identificador de reembolsonumber
payment_id
Identificador de pagonumber
amount
Monto de reembolsonumber
metadata
Contiene metadatos del pago que nos envían en el post del paymentarray
Errores
400Error
2063
The-action-requested-is-not-valid-for-the-current-payment-state
2085
Invalid-value-for-gateway_operation-
401Error
401
Invalid-token
4040
amount-attribute-must-be-positive
4041
amount-attribute-must-be-numeric
404Error
2000
Payment-not-found
2024
Payment-too-old-to-be-refunded
2032
Refund-not-found
3012
Invalid parameter security_code_length
3024
Not valid action - partial refund unsupported for this transaction
4211
Charge-detail-can't-be-null-or-empty
4248
Charge not found - Shown when the charge is not found
4291
Param-charge-id-can’t-be-null-or-empty
4292
Header-X-Idempotency-Key-can’t-be-null
4293
Invalid-payment-status-to-refund-charges
4294
Charge-type-not-valid-to-refund
4295
Partial-charge-refund-is-not-allowed
4296
Charge-already-refunded
4297
Invalid-charge-id
15016
Payment-too-old-to-be-refunded
¿Te sirvió esta información?
Sí
No
Solicitud
curl -X POST \
'https://api.mercadopago.com/v1/payments/{id}/refunds'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 77e1c83b-7bb0-437b-bc50-a7a58e5660ac' \
-H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
-d '{
"amount": 5
}'curl -X POST \
'https://api.mercadopago.com/v1/payments/{id}/refunds'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 77e1c83b-7bb0-437b-bc50-a7a58e5660ac' \
-H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
-d '{
"amount": 5
}'curl -X POST \
'https://api.mercadopago.com/v1/payments/{id}/refunds'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 77e1c83b-7bb0-437b-bc50-a7a58e5660ac' \
-H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
-d '{
"amount": 5
}'curl -X POST \
'https://api.mercadopago.com/v1/payments/{id}/refunds'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 77e1c83b-7bb0-437b-bc50-a7a58e5660ac' \
-H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
-d '{
"amount": 5
}'curl -X POST \
'https://api.mercadopago.com/v1/payments/{id}/refunds'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 77e1c83b-7bb0-437b-bc50-a7a58e5660ac' \
-H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
-d '{
"amount": 5
}'curl -X POST \
'https://api.mercadopago.com/v1/payments/{id}/refunds'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 77e1c83b-7bb0-437b-bc50-a7a58e5660ac' \
-H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
-d '{
"amount": 5
}'curl -X POST \
'https://api.mercadopago.com/v1/payments/{id}/refunds'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 77e1c83b-7bb0-437b-bc50-a7a58e5660ac' \
-H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
-d '{
"amount": 5
}'Respuesta de ejemplo
{
"id": 1009042015,
"payment_id": 18552260055,
"amount": 10,
"metadata": [
{}
],
"source": [
{
"name": {
"en": "Firstname Lastname",
"pt": "Nome e sobrenome",
"es": "Nombre y apellido"
},
"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": [
{}
]
}