Centro para desarrolladores
Hostra es infraestructura de liquidación de pagos expuesta como API REST descrita con OpenAPI 3.0, sin gRPC ni SDK publicado. Esta página es el mapa: primero las convenciones y luego la documentación, el estado en vivo y la arquitectura que necesitarás para integrarte.
Convenciones de la API
- URL base
- https://api.hostracore.com — los recursos están en /v1/…
- Acceso
- Cookie de sesión para el usuario; Authorization: Bearer hstra_… o X-API-Key para acceso de servidor por comercio.
- Idempotency-Key
- UUID v4 obligatorio al crear o cambiar transferencias y liquidaciones; repetir con la misma llave devuelve el resultado original.
- X-Request-ID
- Se envía en cada solicitud y se conserva en registros y liquidaciones para rastrearla.
- Errores
- Documentos RFC 7807 con tipo, título, código y un detalle legible.
- Eventos
- Notificaciones web firmadas con HMAC-SHA256, con reintentos y cola de no entregados.
Integración típica de movimiento de dinero
- POST /v1/quotes — obtén una cotización del servidor; vale 60 segundos y una vencida se rechaza con HTTP 410.
- POST /v1/transfers — crea la transferencia con un Idempotency-Key UUID v4; la instrucción se guarda antes de llamar al proveedor.
- GET /v1/transfers/{id} — consulta el estado oficial; nunca lo calcules en el cliente.
- Usa la notificación web firmada para el estado final en lugar de consultar sin fin.
- Descarga los comprobantes de operaciones exitosas cuando la API los ofrezca.
Llaves y permisos
Las llaves de servidor están ligadas a un comercio y tienen permisos: transfers:read/write, quotes:read/write, settlements:read/write/reverse, audit:read, webhooks:read/write y devices:read/write. La llave completa se muestra una sola vez al crearla y después solo se guarda su prefijo. Nunca incluyas llaves en código que corre en el navegador.
Referencias
- Documentación de la API — referencia de endpoints y especificaciones OpenAPI.
- API en vivo — estado, versión y documento OpenAPI completo.
- Estado de la API — salud de cada parte del servicio.
- Arquitectura — servicios, estados y flujo de mensajes.
- Motor de liquidación — las garantías de persistencia y ejecución única.
- Registro de auditoría — la cadena de hashes y cómo verificarla.
Documentación de la APIAPI en vivoEstado de la APIArquitecturaMotor de liquidaciónLibro contableRegistro de auditoría
Fuentes legibles por máquina
Los agentes y herramientas deben preferir estas fuentes generadas sobre las páginas comerciales: openapi.json, Swagger UI, health y llms.txt.