Genera tus credenciales
Dentro del portal, en Configuración › Integración API. Se muestran una sola vez: guárdalas en el gestor de secretos de tu servidor.
Una API REST para crear afiliaciones de salud, seguir su estado y descargar el soporte. Con un sandbox donde puedes probarlo todo sin tocar datos reales.
# Crear una afiliación de salud curl -X POST https://portal.acicolombia.com.co/api/external/v1/affiliation-requests \ -H "X-ACI-API-Key: $ACI_API_KEY" \ -H "X-ACI-Secret-Key: $ACI_SECRET_KEY" \ -H "Idempotency-Key: OT-1024" \ -H "Content-Type: application/json" \ -d '{"external_reference":"OT-1024", ...}'
// Con el cliente HTTP de Laravel $respuesta = Http::withHeaders([ 'X-ACI-API-Key' => env('ACI_API_KEY'), 'X-ACI-Secret-Key' => env('ACI_SECRET_KEY'), 'Idempotency-Key' => 'OT-1024', ])->post('https://portal.acicolombia.com.co/api/external/v1/affiliation-requests', [ 'external_reference' => 'OT-1024', // ...resto del cuerpo ]);
// fetch desde tu servidor (nunca desde el navegador) const r = await fetch('https://portal.acicolombia.com.co/api/external/v1/affiliation-requests', { method: 'POST', headers: { 'X-ACI-API-Key': process.env.ACI_API_KEY, 'X-ACI-Secret-Key': process.env.ACI_SECRET_KEY, 'Idempotency-Key': 'OT-1024', 'Content-Type': 'application/json', }, body: JSON.stringify({ external_reference: 'OT-1024' }), });
Del sandbox a producción sin cambiar tu código: solo cambia la URL base y las credenciales.
Dentro del portal, en Configuración › Integración API. Se muestran una sola vez: guárdalas en el gestor de secretos de tu servidor.
Mismas rutas, otra URL base y credenciales que no se cruzan con producción. Puedes provocar el desenlace que quieras ensayar.
Manda tu external_reference en cada creación y usa Idempotency-Key para reintentar sin duplicar.
Cada tarjeta abre su sección dentro de la referencia completa.
Escríbenos y te acompañamos en la puesta en marcha.