Skip to main content
Esta guía reúne los criterios generales que aplican a cualquier integración con Alignet One. Además de estos lineamientos, cada tipo de integración cuenta con sus propias recomendaciones técnicas, operativas y de seguridad.
Usa esta página como punto de partida. Luego revisa las buenas prácticas específicas según el canal que vas a implementar: E-commerce, Checkout Web o SDK Mobile.

​
Principios transversales

  • No expongas credenciales, Client Secret, API keys o tokens en el frontend.
  • Ejecuta operaciones sensibles desde tu backend mediante HTTPS.
  • Usa variables de entorno o un gestor seguro de secretos para almacenar llaves.
  • No confirmes una venta solo con la respuesta visual del checkout, SDK o navegador.
  • Valida el estado final desde backend usando los identificadores de operación.
  • Guarda la relación entre tu pedido interno y el identificador devuelto por Alignet One.
  • Completa pruebas por cada método de pago habilitado para tu comercio.
  • Valida escenarios aprobados, denegados, pendientes, expirados y errores controlados.
  • Solicita apoyo del equipo de integraciones cuando necesites validar simuladores o flujos especiales.
  • Registra errores, códigos de respuesta y payloads relevantes para trazabilidad.
  • Conserva evidencias de pruebas para facilitar la certificación.
  • Implementa alertas para rechazos inusuales, timeouts o fallas repetitivas.

​
Consejos por tipo de integración

E-commerce

Recomendaciones para plugins, plataformas de comercio, gestión de pedidos y operación diaria.

Checkout Web

Consejos para integrar Alignet One Flex, manejar nonce, callbacks, estilos y experiencia de pago web.

SDK Mobile

Buenas prácticas para apps Android e iOS, empaquetado, callbacks, sesiones y pruebas en dispositivos.

​
Ruta recomendada

1

Elige el tipo de integración

Define si usarás E-commerce, Checkout Web o SDK Mobile según tu canal y nivel de control técnico.
2

Revisa las buenas prácticas específicas

Ingresa a la guía correspondiente para aplicar recomendaciones propias de ese flujo.
3

Ejecuta pruebas completas

Valida credenciales, datos de prueba, respuestas esperadas, errores y trazabilidad antes de solicitar producción.
4

Completa la certificación

Confirma que tu integración cumple los requisitos técnicos, operativos y de seguridad solicitados por Alignet One.

Checklist de certificación técnica

Revisa los requisitos necesarios antes de solicitar credenciales o el pase a producción.