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-7434*********159-03141*********cee51edf8*********f94f589-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"
      }
    ]
  }
}