AAPD

Reembolsar una orden

PUT /orders/{order_hash}/refund — anula una orden AAPD ya pagada cuando la hora se canceló.

PUT /orders/{order_hash}/refund
Authorization: Bearer {client_secret}

Anula una orden AAPD ya pagada: le devuelve al paciente todo lo que se le cobró y descuenta de tu próximo pago lo que te correspondía por esa orden. Es una operación total e irreversible.

Es una excepción, no parte del flujo normal

Úsalo solo cuando el pago ya se procesó (la orden está paid) y la hora se canceló por fuerza mayor o por un error: el profesional no pudo atender, la hora se agendó por equivocación o quedó duplicada. Si la prestación se realizó, no corresponde reembolsar la orden.

Cuándo usarlo

Situación¿Usar este endpoint?
El paciente pagó y la hora se canceló por fuerza mayor (el profesional no pudo atender, cierre del centro)Sí
El paciente pagó una hora que se agendó por error o quedó duplicadaSí
El paciente abandonó el widget antes de pagar (orden pending)No — no hay nada que reembolsar. La orden simplemente queda sin pagar.
La prestación se realizó y el paciente quiere devolver solo una parteNo — no hay reembolsos parciales. Escríbenos a contacto@getskip.ai.
El paciente reclama un cobro de la segunda cuotaNo — es parte del flujo AAPD. Ver Reembolso ISAPRE y cobro del 70%.

Llámalo solo desde tu backend, nunca desde el navegador, y pide una confirmación explícita a quien opera tu sistema antes de dispararlo.

Qué gatilla

  1. Reembolso al paciente. Skip devuelve todo lo cobrado al paciente por la orden — el pago inicial y cualquier cuota ya cobrada, comisiones incluidas — al mismo medio de pago con que pagó. El plazo en que el abono se ve reflejado depende del banco emisor de la tarjeta.
  2. Fin de los cobros. Skip deja de cobrar al paciente las cuotas pendientes de la orden.
  3. Descuento a tu próximo pago. El monto que te correspondía por la orden (lo que Skip te transfiere por ella, ya descontada la comisión) se resta de tu siguiente pago de Skip. Si todavía no te habíamos pagado esa orden, sale de ese mismo pago.
  4. Cambio de estado. La orden pasa a refunded y recibes un webhook order.changed con status = refunded — ver Catálogo de eventos.

El endpoint no recibe un motivo: registra en tu sistema por qué se canceló la hora. Si ya enviaste el gasto de esta orden con POST /api/spot/gastos, escríbenos a contacto@getskip.ai para retirarlo de la rendición.

Request

Sin body. Solo order_hash en la ruta, y solo acepta client_secret: con client_id responde 401. Solo puedes reembolsar órdenes de tu propia cuenta.

curl -X PUT "https://pay.getskip.ai/orders/2f88b330-f3ed-5521-aa1f-9d15af1fce8d/refund" \
  -H "Authorization: Bearer $SKIP_CLIENT_SECRET"

Respuesta (200 OK)

Responde 200 solo cuando el procesador de pagos confirmó la devolución. El body es la orden completa — mismo shape que GET /orders/{order_hash} — con status: "refunded":

{
  "hash": "2f88b330-f3ed-5521-aa1f-9d15af1fce8d",
  "status": "refunded",
  "reference": "CLINIC-ORDER-12345",
  "total_amount": 100000,
  ...
}

Reintentos

La operación es idempotente: puedes reintentar la misma llamada sin riesgo. Un reintento no duplica la devolución al paciente ni el descuento a tu pago, y si la orden ya está refunded responde 200 con la orden tal como está.

Errores

Todas las respuestas de error de este endpoint son 400, salvo la autenticación (401). El código viene en detail, como lista:

{ "detail": ["order_not_paid"] }
Código en detailCausaQué hacer
Order not foundEl order_hash no existe o pertenece a otra cuenta.Confirma el hash.
order_not_paidLa orden no está paid (por ejemplo, sigue pending).No hay nada que reembolsar.
refund_not_confirmedEl procesador todavía no confirma la devolución.Reintenta en unos minutos con la misma llamada: no se duplica.
refund_operation_unresolved, collection_operation_unresolvedHay otra operación en curso sobre la orden (un reembolso o un cobro).Reintenta en unos minutos.
Cualquier otro códigoLa orden necesita revisión manual.Escríbenos a contacto@getskip.ai con el order_hash.
StatusCausa
401Credencial faltante, inválida o es client_id en vez de client_secret.

Catálogo completo en Errores.

On this page