Inicio
Documentación
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

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.

Reembolsar una order - Pagos online - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Reembolsar una order

POST

https://api.mercadopago.com/v1/orders/{order_id}/refund
Este endpoint permite realizar la devolución total o parcial de los valores asociados a una order. Para realizar un reembolso total, no debes enviar el monto a reembolsar en el body de la requisición. Para realizar un reembolso parcial sí debes indicar el valor a ser reembolsado, junto con el identificador de la transacción que deseas devolver. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
Parámetros para la solicitud
PATH
order_id
string

REQUERIDO

ID de la order a reembolsar. Este valor es devuelto en la respuesta a la requisición Crear order.
HEADER
X-Idempotency-Key
string

REQUERIDO

Esta función permite repetir requisiciones de forma segura, sin riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores como crear dos pagos idénticos. Para garantizar que cada solic...Ver más
BODY
transactions
array

REQUERIDO

Contiene información sobre las transacciones asociadas a la order. Puede contener hasta 2 transacciones. Por ejemplo, en caso de querer crear una order con dos tarjetas, puedes agregar un ítem al array "payments", dividi...Ver más
Parámetros de respuesta
id
string
Identificador de la order procesada en la solicitud.
status
string
Estado actual de la order.
processed: Todas las transacciones fueron procesadas exitosamente.
refunded: La order fue devuelta.
status_detail
string
Detalles sobre el estado del pago.
refunded: La order fue devuelta.
partially_refunded: La order fue devuelta parcialmente.
transactions
object
Contiene información sobre las transacciones asociadas a una order.
Errores

400Error de solicitud.

empty_required_header

El header 'X-Idempotency-Key' es requerido y no fue enviado. Vuelve a realizar la requisición incluyéndolo.

invalid_path_param

El order_id proporcionado en el path de la requisición no es correcto. Compruébalo y proporciona un ID válido para volver a intentarlo.

refund_amount_exceeds

El valor del reembolso es mayor que el valor disponible.

404No encontrada.

Error. Order no encontrada.

Error. Transaction no encontrada.

409Alguna regla específica del sistema no permite realizar la acción debido a restricciones definidas.

Alguna regla específica del sistema no permite realizar la acción debido a restricciones definidas.

Error. Order ya reembolsada.

La order no puede ser reembolsada. Comprueba el estado de la order e intenta nuevamente.

500Error genérico.

idempotency_validation_failed

Falla en la validación de idempotencia. Intenta enviar la solicitud nuevamente.

internal_error

Error genérico. Intenta enviar la solicitud nuevamente.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/refund'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
    -d '{
  "transactions": [
    {
      "id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
      "amount": "24.90"
    }
  ]
}'
Respuesta de ejemplo
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "status": "processed",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "REF01J49MMW3SSBK5PSV3DFR32959",
        "transaction_id": "PAY01JEVQM06WDW16MAQ8B5SC0MSC",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "amount": "24.90",
        "status": "processed"
      }
    ]
  }
}