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 presenciales - 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 crear una devoluciĂłn total de una transacciĂłn de pago asociada a una order para Mercado Pago Point. En caso de Ă©xito, la solicitud devolverĂĄ una respuesta con el estado 200.
ParĂĄmetros para la solicitud
PATH
order_id
string

REQUERIDO

ID de la order que contiene asociada la transacciĂłn de pago a ser reembolsada. Este valor es devuelto en la respuesta a la solicitud "Crear order".
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 pagos idĂ©nticos. Para garantizar qu...Ver mĂĄs
ParĂĄmetros de respuesta
id
string
Identificador de la order que va a ser reembolsada, recibido en la respuesta a su creaciĂłn.
status
string
Estado actual de la order o de la transacciĂłn.
refunded: La order ha sido reembolsada de manera exitosa.
status_detail
string
Detalles sobre el estado del reembolso. Es devuelto exclusivamente cuando la order es reembolsada por medio de la API.
transactions
object
Contiene informaciĂłn sobre la transacciĂłn asociada a una order.
Errores

400Error.

empty_required_header

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

401Error.

unauthorized

El valor enviado como Access Token es incorrecto. Por favor, verifĂ­calo y vuelve a intentar realizar la solicitud enviando el valor correcto.

404Error.

order_not_found

El valor enviado como Access Token es incorrecto, por lo que la order no puede ser encontrada. Por favor, verifĂ­calo y vuelve a intentar realizar la solicitud enviando el valor correcto.

409Error.

idempotency_key_already_used

El valor enviado como header de idempotencia ya fue utilizado con una solicitud distinta en un tiempo menor a 24 horas. Por favor, vuelve a intentar realizar la peticiĂłn enviando un nuevo valor.

500Error.

idempotency_validation_failed

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

500

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*********' \
    
Respuesta de ejemplo
{
  "id": "123",
  "status": "refunded",
  "status_detail": "refunded",
  "transactions": {
    "refunds": [
      {
        "id": "ref_01J67CQQH5904WDBVZEM1234D",
        "transaction_id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
        "reference_id": "12345678",
        "amount": "24.90",
        "status": "processed"
      }
    ]
  }
}