Custom Loyalty API integration

Cómo Obtener el JWT Token para la Integración Personalizada

Introducción

Para utilizar la API de integración personalizada de Kivly, necesitas un Bearer Token (JWT) que se utiliza para autenticar todas las peticiones a los endpoints.

Pasos para Obtener el JWT Token

1. Acceder al Dashboard de Kivly

1. Inicia sesión en tu cuenta de Kivly
2. Navega a la página de integraciones:

https://getkivly.com/dashboard/integrations

2. Localizar la Integración Personalizada

1. En la página de integraciones, busca la sección "Personalizada" (Custom)
2. Esta integración permite asignar balance y canjear recompensas a los clientes de forma automática

3. Copiar el Bearer Token

1. En la sección "Personalizada", encontrarás un campo etiquetado como "Bearer Token"
2. El token es una cadena larga que comienza con eyJhbGciOiJ... (formato JWT)
3. Haz clic en el icono de copiar (dos rectángulos superpuestos) que está al lado del token
4. Guarda el token de forma segura, ya que es tu credencial de autenticación

Información Adicional Disponible

En la misma página encontrarás:

URLs de los Endpoints

• URL para sincronizar clientes (GET):

https://api.getkivly.com/api/v1/loyalty/customer/{location_id}/{identifier}

• URL para envío de facturas (POST):

https://api.getkivly.com/api/v1/loyalty/{location_id}

Enlaces Útiles

• Más detalles: Información adicional sobre la integración
• Documentación: Acceso a la documentación completa de la API

Uso del JWT Token

Una vez que tengas el JWT Token, úsalo en todas las peticiones HTTP incluyéndolo en el header Authorization:

Authorization: Bearer {tu_jwt_token_aqui}

Ejemplo de Petición

Bash

curl -X GET "https://api.getkivly.com/api/v1/loyalty/customer/69550593c1ec4c33624894b7/[email protected]" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJpZCI6IjY5NTRmZ..." \
  -H "Content-Type: application/json"

Seguridad

⚠️ Importante:

• Nunca compartas tu JWT Token públicamente
• No lo incluyas en código fuente que se suba a repositorios públicos
• Si crees que tu token ha sido comprometido, contacta con soporte para generar uno nuevo
• El token tiene una validez limitada, si expira, necesitarás obtener uno nuevo desde el dashboard

Soporte

Si tienes problemas para obtener el token o necesitas ayuda adicional:

• Email de soporte: [email protected]
• Documentación: Consulta la sección "Documentación" en la página de integraciones

Notas

• El JWT Token es específico para tu cuenta y ubicación
• Cada ubicación puede tener su propio token
• El token se genera automáticamente cuando configuras la integración personalizada