Quickstart
Cuatro pasos para hacer tu primera consulta de transacciones.
Genera tus credenciales en el portal
Entra a Yappy Comercial → Integraciones → Generar credenciales. Obtendrás tres valores: API Key, Clave secreta y Código de semilla (Seed). Guárdalos en un lugar seguro — no se vuelven a mostrar. Ver guía detallada →
Genera el code HMAC-SHA256 para el login
El campo code del login no es un valor fijo — se calcula concatenando tu API Key + fecha de hoy (YYYY-MM-DD) y firmando con HMAC-SHA256 usando tu Seed como clave. Este cálculo debe hacerse en cada llamada a /session/login. Ver algoritmo completo →
Llama a /session/login para obtener el token
Envía tu api-key y secret-key en los headers, y el code calculado en el body. Recibirás un token JWT válido por 24 horas que debes incluir en el header authorization de todos los demás endpoints. Ver endpoint →
Consulta tu historial de transacciones
Con el token activo, llama a POST /movement/history con un rango de fechas (start_date, end_date) y el número de resultados por página (limit). La respuesta incluye un campo has_next_page para navegar páginas. Ver endpoint →
El token JWT expira exactamente a las 24 horas de haberse generado. Asegúrate de que tu integración detecte el vencimiento (Respuesta: Unauthorized) y llame de nuevo a /session/login para obtener uno nuevo antes de continuar.