AAPD

Consultar una orden

GET /orders/{order_hash} — el estado actual de una orden AAPD.

GET /orders/{order_hash}
Authorization: Bearer {client_secret}

Devuelve el estado actual de una orden. Acepta client_secret (server-side) o client_id (la credencial que usa el widget). Úsalo para reconciliar contra los webhooks o para soporte.

Respuesta (200 OK)

{
  "hash": "2f88b330-f3ed-5521-aa1f-9d15af1fce8d",
  "status": "paid",
  "reference": "CLINIC-ORDER-12345",
  "total_amount": 100000,
  "paid_amount": 100000,
  "pending_amount": 0,
  "customer": { "rut": "12345678-9", "first_name": "María", "last_name": "González", "email": "...", "phone_number": "..." },
  "plan": { "name": "plan_30_70", "data": { "installments": [], "commission": { ... } } },
  "created_at": "2026-04-15T10:00:00Z"
}

Mismo shape que devuelve POST /orders, con status y paid_amount reflejando el estado al momento de la consulta. El hash es un UUID. La respuesta trae campos adicionales; trátala como no exhaustiva.

Ciclo de vida del estado

pending → partially_paid → paid → (partially_refunded | refunded)
       └→ cancelled
EstadoCuándo
pendingOrden creada, sin pago todavía
partially_paidPrimera cuota del 30% capturada
paidPréstamo aprobado y financiado completo
partially_refundedReembolso parcial emitido
refundedReembolso total procesado
cancelledOrden cancelada antes del pago

Recibes un webhook en cada cambio de estado — ver Webhooks → Catálogo de eventos.

Errores

StatusCausa
401Credencial faltante o inválida.
404order_hash desconocido.

Catálogo completo en Errores.

On this page