Órdenes

Suscripciones, rescates, idempotencia y estados.

Endpoints

Método	Path	Descripción
`POST`	`/api/v1/subscriptions`	Alta de suscripción (idempotente).
`POST`	`/api/v1/redemptions`	Alta de rescate (idempotente).
`GET`	`/api/v1/orders/{id}`	Estado de una orden.
`POST`	`/api/v1/orders/{id}/cancel`	Anulación (solo antes del corte).
`GET`	`/api/v1/batches/{id}`	Detalle de un corte: totales, hash y órdenes (para conciliar).

Crear una suscripción

curl -X POST {BASE_URL}/api/v1/subscriptions \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotency_key": "sub-2026-07-28-000123",
    "comitente":       "COM-000123",
    "amount":          150000.50,
    "fund_id":         "9be2…-uuid del fondo (GET /api/v1/funds)",
    "client_id":       "tu id interno del cliente",
    "client_name":     "Juan Pérez",
    "external_ref":    "op-987654",
    "cvu":             "0000003100010000000001"
  }'

Rescates: mismo shape en POST /api/v1/redemptions.

Idempotencia

La idempotency_key es obligatoria y única por orden (mín. 8 caracteres). Un reintento con la misma clave devuelve la misma orden con replayed: true y status 200 (en lugar de 201). Nunca duplica: reintentá con confianza ante timeouts.

Estados de la orden

Estado	Significado
`QUEUED`	Recibida, en cola para el próximo corte. Se puede anular.
`BATCHED`	Incluida en un corte, esperando aprobación. Ya no se anula.
`SENT`	Enviada al Back Office (neteada por comitente).
`CANCELLED` / `REJECTED`	Anulada por vos u operador / corte rechazado.

Schemas completos: Swagger.

Referencia completa: /docs/api (Swagger) · Hub de documentación