Queremos que integrar Koywe sea fácil, por lo que si solo quieres una rampa cripto, puedes integrar nuestro widget o embeber un iFrame en tu aplicación sin ninguna credencial.

Si quieres hacer modificaciones más profundas o conectarte por API, contáctanos a hola@koywe.com o agenda una llamada!

Una vez que estés creado como partner, tendrás 2 parámetros para la integración:

  • Client Id: el identificador único de tu empresa en Koywe. Se va a ver algo así 63631a561f41f8fd18f8c3e0

  • Secret: Un string secreto (no lo compartas) que nos permitirá determinar que en verdad eres tú, como una contraseña.

Con estos 2 parámetros podrás autenticarte en la API y hacer llamados a los endpoints privados.

Cuando te autenticas exitosamente, nuestra API te responderá un JWT que deberás incluir en los headers de todos los llamados que hagas a la API. Este JWT durará 24 horas antes de expirar.

Nota

Hay 2 formas de autenticarse, que puedes revisar en los API docs: con email o sin email. Al autenticarte con un email, todos los llamados a la API tendrán ese email de usario asociado. Algunos endpoints exigen forzozamente un email en el JWT, por lo que recomendamos autenticarse de esta forma.

Si estás integrándote a través de un widget o iFrame, nuestro frontend manejará la autenticación enviando un correo electrónico al usuario e iniciando una sesión que durará 12 horas.

SDK: La integración por SDK permite el ingreso de un Client ID, de manera que nuestra API pueda identificar los requests que vengan desde tu integración. Si no pones o no tienes un Client ID, la API pensarás que estás llegando desde Koywe.com