Skip to main content
Fintoc usa API keys para autenticar tus interacciones con la API. Si llamas a la API sin tu llave, o si usas una incorrecta, Fintoc devuelve un error. Cada cuenta de Fintoc tiene dos pares de llaves: un par corresponde al modo de pruebas, mientras que el otro par corresponde al modo en vivo. Cada recurso se almacena en el ambiente del modo de pruebas o en el del modo en vivo, y los recursos de un ambiente no pueden ser manipulados por recursos del otro ambiente. Además, hay dos tipos de API key: public key y secret key.
  • La public key solo se usa para identificar tu cuenta dentro de Fintoc. No es secreta, y la usarás para integrar el Widget.
  • La secret key te permite consultar la API de Fintoc. Como es secreta, úsala solo desde el backend de tu aplicación.
Al crearse, cada cuenta tiene un total de 4 llaves: una public key y una secret key para el modo de pruebas, y una public key y una secret key para el modo en vivo (el “ambiente de producción”).

​
Obtener tus API keys

Solo puedes acceder a tus secret keys del modo en vivo una vezSolo podrás copiar y ver tu secret key cuando la actives o la rotes. Asegúrate de almacenarla de forma segura en tu backend.
Puedes activar y administrar tus API keys desde tu Dashboard.

​
Rotar y revocar tus secret keys del modo en vivo

Te recomendamos rotar tus secret keys del modo en vivo al menos una vez al año. Puedes administrarlas desde la página de API keys de tu Dashboard. Para rotar una secret key del modo en vivo sin interrumpir tu integración:
  1. Haz clic en Crear secret key para crear una nueva secret key del modo en vivo.
  2. Actualiza tu backend para que use la nueva secret key.
  3. Abre el menú de tres puntos junto a la secret key antigua y haz clic en Revocar.
La revocación de una secret key es inmediata y no se puede deshacer. Cualquier aplicación que siga usando la secret key revocada deja de funcionar.
Solo puedes rotar o revocar secret keys del modo en vivoNo puedes rotar ni revocar las API keys del modo de pruebas ni las public keys. El Dashboard muestra el menú de tres puntos solo para las secret keys del modo en vivo.

​
Si tu secret key queda expuesta

Si tu secret key del modo en vivo queda expuesta, por ejemplo en un repositorio público, en código del cliente o en logs, reemplaza la secret key de inmediato:
  1. Ve a la página de API keys en el modo en vivo.
  2. Haz clic en Crear secret key para crear una nueva secret key del modo en vivo.
  3. Actualiza tu backend para que use la nueva secret key.
  4. Abre el menú de tres puntos junto a la secret key expuesta y haz clic en Revocar.
Si no puedes actualizar tu backend de inmediato, revoca primero la secret key expuesta. Las solicitudes que usen la secret key revocada fallan hasta que despliegues la nueva secret key. Si tu secret key del modo de pruebas queda expuesta, esto no afecta tus operaciones en vivo. Una secret key del modo de pruebas solo puede acceder a recursos del modo de pruebas, que no mueven dinero real. No puedes rotar ni revocar una secret key del modo de pruebas, así que elimínala del lugar donde quedó expuesta.

​
Restricciones de IP

Opcionalmente, puedes configurar Restricciones de IP para indicarle a Fintoc que solo acepte solicitudes desde direcciones IP específicas. Esto añade una capa adicional de seguridad a tus operaciones. Para configurar estas restricciones:
  1. Ve a dashboard.fintoc.com.
  2. Navega a la pestaña API keys en la barra lateral.
  3. Si tu organización tiene productos que permiten Restricciones de IP habilitadas, verás una sección de Restricciones de IP.
    Activa la opción de Restricciones de IP.
  4. Haz clic en el botón “Restricciones de IP” e ingresa las direcciones IP individuales o bloques CIDR desde los cuales harás solicitudes a nuestra API.

​
¿Qué son los bloques CIDR?

Los bloques CIDR (Classless Inter-Domain Routing) son una forma de definir un rango de direcciones IP. En vez de listar cada dirección IP individual, los bloques CIDR te permiten especificar un grupo de direcciones de forma compacta. Por ejemplo: 192.168.1.0/24 representa todas las direcciones IP desde 192.168.1.0 hasta 192.168.1.255. Si no estás seguro de cómo determinar tu bloque CIDR, consulta a tu administrador de red o equipo técnico. Ellos pueden ayudarte a identificar el rango correcto de direcciones IP a usar.
Asegúrate de agregar direcciones IP cuando actives la funcionalidad de Restricciones de IPSi activas la funcionalidad de Restricciones de IP pero no agregas ninguna dirección IP, Fintoc no aceptará ninguna solicitud.