Inicio
Documentación
Recursos
Partners
Comunidad

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integración y vendedores que quieren contratarlos.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear reembolso - Reembolsos - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Crear reembolso

POST

https://api.mercadopago.com/v1/payments/{id}/refunds
Crear 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.
Parámetros para la solicitud
PATH
id
string

REQUERIDO

Identificador de pago
HEADER
X-Idempotency-Key
string

REQUERIDO

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ás
BODY
amount
number
Monto de reembolso. Si esta propiedad (monto) es removida del body, creará un reembolso total.
Parámetros de respuesta
id
number
Identificador de reembolso
payment_id
number
Identificador de pago
amount
number
Monto de reembolso
metadata
array
Contiene metadatos del pago que nos envían en el post del payment
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

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-8971*********918-01191*********5874530a4*********4799fdf-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": [
    {}
  ]
}