Usa claves API con seguridad
Las claves API permiten que sistemas externos se conecten a AtomicPay. Trátalas como credenciales sensibles porque pueden dar a los sistemas acceso a datos o acciones del negocio.
Esta guía cubre el flujo del vendedor y hábitos de seguridad. La referencia de endpoints, detalles de autenticación y ejemplos de payload permanecen en AtomicPay API Docs.
Cuándo usar la API
| Usa la API cuando | Usa el dashboard cuando |
|---|---|
| Un sistema backend necesita acceso automatizado. | Un miembro del equipo puede completar la tarea manualmente. |
| Necesitas sincronizaciones recurrentes de compras, suscripciones o clientes. | Solo necesitas una exportación o revisión rápida. |
| Necesitas conectar AtomicPay a herramientas internas. | Aún estás probando el proceso operativo. |
| Un flujo requiere cancelación o consulta programática. | La acción es poco frecuente y más segura por la UI. |
Seguridad de claves API
| Práctica | Por qué importa |
|---|---|
| Almacenar claves en variables de entorno | Evita exponer secretos en código o documentación. |
| Limitar quién puede ver claves | Reduce filtraciones accidentales. |
| Rotar claves regularmente | Limita el impacto de credenciales antiguas o expuestas. |
| Revocar claves no usadas | Elimina acceso de integraciones abandonadas. |
| Separar entornos | Evita mezclar flujos de prueba y producción. |
Crea y gestiona acceso API
- Confirma que la integración realmente necesita acceso API.
[Captura: Documento de requisitos de integración — decisión API vs dashboard registrada.]
- Revisa los datos o la acción requeridos.
[Captura: Documentación API — endpoint y alcance de permisos identificados.]
- Crea la clave API en el área de desarrollador o integración correspondiente.
[Captura: Página de claves API — acción crear clave y nueva clave generada.]
- Almacena la clave de forma segura fuera del código fuente.
[Captura: Variables de entorno — clave API almacenada en configuración del servidor, no en el repositorio.]
- Configura el sistema externo.
[Captura: Configuración del sistema externo — clave API de AtomicPay configurada.]
- Prueba con una solicitud de bajo riesgo.
[Captura: Llamada API de prueba — respuesta de bajo riesgo recibida con éxito.]
- Monitoriza errores y uso.
[Captura: Logs o monitorización API — errores y uso rastreados.]
- Rota o revoca la clave cuando cambie el acceso.
[Captura: Clave API revocada o rotada — clave antigua deshabilitada.]
Soluciona acceso API
- La clave se copió incorrectamente.
- La clave pertenece al negocio o entorno equivocado.
- El sistema externo usa el formato de autenticación incorrecto.
- La integración no tiene permiso para la acción intentada.
- La clave fue rotada o revocada.
- Los detalles del endpoint cambiaron o se están llamando incorrectamente.
FAQ
¿Dónde están documentados los endpoints API?
Usa AtomicPay API Docs para referencia de endpoints, autenticación, payloads y ejemplos técnicos.
¿Puedo poner una clave API en código frontend?
No. Almacena claves API de forma segura en el servidor o en variables de entorno protegidas. No las expongas en código del navegador, repositorios públicos ni capturas de pantalla.
¿Cuándo debo revocar una clave API?
Revócala cuando se retire una integración, un proveedor ya no necesite acceso, un compañero de equipo se vaya o sospeches que la clave fue expuesta.