Documentación Técnica e Integración Programática API REST v1 de FinKilo
Bienvenido a la guía de referencia para ingenieros de software, arquitectos de sistemas y equipos de tecnología financiera que integran capacidades de emisión instantánea, recarga automatizada y visualización segura de medios de pago dentro de sus propias plataformas. Nuestra interfaz de programación de aplicaciones opera bajo principios RESTful con respuestas estandarizadas en formato JSON, baja latencia y alta disponibilidad.
Autenticación Criptográfica, Cabeceras y Flujo OAuth 2.0
Las solicitudes servidor a servidor para operaciones de tesorería se autentican mediante identificadores de cliente y llaves secretas empresariales obtenidas tras completar el registro en el portal corporativo de emisión B2B para empresas. Adicionalmente, para plataformas que permiten a sus usuarios finales vincular instrumentos existentes sin compartir llaves maestras, ofrecemos un flujo estándar de autorización delegada con tokens de alcance restringido.
Puntos de Conexión para Aprovisionamiento, Saldos y Control Operativo
Los recursos disponibles cubren el ciclo de vida completo de cada credencial: creación asíncrona con asignación inmediata de identificador único, dispersión de fondos desde la bóveda maestra de la organización, consulta en vivo de balances liquidados e historial detallado de movimientos comerciales, generación bajo demanda de códigos de verificación temporal con vigencia de doscientos cuarenta segundos, y bloqueo o reactivación preventiva en tiempo real.
Si desea explorar las características funcionales de cada nivel operativo desde la perspectiva del titular final, visite la portada principal del ecosistema de pagos digitales FinKilo.
Notificaciones de Eventos en Tiempo Real y Verificación HMAC-SHA256
Para garantizar consistencia eventual y conciliación instantánea sin necesidad de sondeo constante, nuestro motor despacha eventos HTTP POST hacia el punto de recepción configurado por su organización cada vez que se completa una emisión, se acredita una transferencia entrante o se registra una compra en comercio. Cada carga útil incluye una firma criptográfica calculada con su secreto compartido para validar la autenticidad e integridad del mensaje antes de procesarlo.
Componente Web Embebido y Aislamiento de Datos Sensibles
Nuestro visor interactivo encapsulado en Shadow DOM o marco aislado permite mostrar la numeración completa, fecha de vencimiento y código dinámico directamente al titular dentro de su aplicación web o móvil, personalizando colores, tipografías y bordes sin que sus servidores toquen información sujeta a normativas de seguridad de datos.
Cumplimiento Normativo, Privacidad y Condiciones de Uso de la Interfaz
Nuestra infraestructura de programación aplica políticas de control de tráfico equitativo, idempotencia en operaciones de dispersión de fondos y validación estricta de esquemas para prevenir duplicidades ante reintentos de red. Los códigos de estado estándar permiten distinguir con claridad entre confirmaciones inmediatas, procesos encolados en segundo plano, errores de validación sintáctica y rechazos por saldo insuficiente en la cuenta concentradora.
Además, los equipos de aseguramiento de calidad disponen de un simulador interactivo que reproduce el comportamiento exacto del componente visual utilizando identificadores de demostración, permitiendo verificar transiciones de estado, rotación de código de seguridad, congelamiento con matriz de coordenadas y adaptación responsiva en dispositivos móviles antes de desplegar cambios en producción.
El uso de las herramientas de desarrollo y entornos de producción se sujeta a las políticas detalladas en nuestro aviso integral de privacidad y resguardo criptográfico así como en los términos y condiciones generales de uso del servicio.