Credenciales
Las Integraciones Yappy usan su propio set de credenciales, completamente independiente de las credenciales de Botón de Pago y Yappy en Caja.
Aunque tu comercio ya tenga credenciales de Botón de Pago o Yappy en Caja, debes generar credenciales separadas para Integraciones Yappy. Son distintos sets de acceso.
Cómo generar las credenciales
- Entra al portal de Yappy Comercial (UAT o Producción).
- En el menú lateral, navega a Integraciones.
- Haz clic en Generar credenciales.
- Si ya tenías credenciales previas, el sistema te mostrará una advertencia de que las anteriores quedarán desactivadas. Confirma con Sí, generar.
- El portal te mostrará los tres valores: Código de semilla, Clave secreta y API Key — cada uno con un botón de copiar.
- Cópialos todos y guárdalos de forma segura.
- Haz clic en Listo para cerrar el modal.
Los tres valores que obtienes
| Credencial | Dónde se usa | Descripción |
|---|---|---|
| API Key | Header api-key en todos los endpoints | Identificador único de tu comercio para estas APIs. |
| Clave secreta | Header secret-key en todos los endpoints | Clave de autenticación que va en cada request. |
| Código de semilla (Seed) | Cálculo HMAC para generar el code de login | Llave criptográfica — no va en ningún header, se usa solo para firmar el login. |
Clave secreta y Código de semilla (Seed) son dos valores distintos: la Clave secreta va en el header, y el Código de semilla (Seed) se usa solo para el cálculo del code utilizado en el login. El portal los genera como 3 valores separados, úsalos correctamente.
Una vez que cierras el modal, no podrás volver a ver los valores generados. Si los pierdes, deberás regenerar las credenciales — lo que desactivará inmediatamente cualquier integración activa que use las anteriores.
Regenerar credenciales
Puedes regenerar tus credenciales en cualquier momento desde el mismo panel. Ten en cuenta que:
- Las credenciales anteriores quedan desactivadas de inmediato y no hay período de gracia.
- Cualquier sistema que las use dejará de funcionar hasta que se actualicen.
- Coordina con tu equipo técnico antes de regenerar en producción para evitar una caída de servicio.
Validar credenciales
El portal tiene una opción Validar credenciales donde puedes pegar los tres valores y confirmar que son correctos antes de usarlos en tu integración. Útil para verificar que los copiaste bien sin tener que hacer una llamada real a la API.
Dónde usar cada credencial
POST /v1/session/login
api-key: {tu-api-key}
secret-key: {tu-clave-secreta}
Content-Type: application/json
{
"body": {
"code": "{hash HMAC-SHA256 generado con tu Seed}"
}
}
Todos los endpoints (excepto /session/login) también requieren el header authorization con el token JWT obtenido en el login:
GET /v1/collection-method
api-key: {tu-api-key}
secret-key: {tu-clave-secreta}
authorization: {token-jwt}