Fidelización

el api de fidelización a diferencia de otros api requiere de 2 niveles de claves de acceso al servicio debido a que el mismo es un servicio operado y auditado a continuación se explica cómo generar un api key para acceder a mobbex y cómo obtener el audit key para acceder al módulo de fidelización audit key clave de auditoria para crear una clave de auditoria debería generar su empresa en mobbex, para ello luego de haber creado la cuenta en el punto anterior, dirijase a "crear entidad", ingrese su cuit y valide los datos una vez que la entidad se encuentre creada provea su cuit a la entidad operadora para que asocie su cuenta y genere su audit key una vez asociado a la entidad operadora podrá ver en su consola un nuevo item con su clave de auditoria aclaraciones generales la carga de puntos no depende ni dependerá de los medios de pago provistos por mobbex siendo responsabilidad del sistema ( entidad con audit key ) la implementación de limitaciones en caso de que la implementación lo requiera los números de tarjeta no poseen ningún tipo de limitaciones de caracteres aunque se recomienda que posean un número mínimo de 4 digitos por cuestiones de no colisión aunque esto será gestionado exclusivamente por el operador autorizado al uso del servicio la carga de puntos no es exclusiva de entidades registradas en mobbex pero si es exclusiva a la autorización del operador los operadores deberán autorizar previamente a los cuit que podrán sumar puntos mediante su sistema de fidelización utilizando la consola de mobbex todas las entidades autorizadas por el operador del sistema de fidelización podrán sumar puntos en las credenciales emitidas url del servicio https //api mobbex com/p/loyalty cabeceras (headers) x api key clave api de su aplicación x audit key clave de auditoria servicios importante los datos opcionales a pesar de ser, justamente opcionales, deberían ser completados siempre que sea posible enpoints restringidos las siguientes rutas requieren de permisos especiales y no podrán ser consultadas utilizando el audit key transacciones post https //api mobbex com/p/loyalty/transactions parámetros credential número de credencial obtenido usando la búsqueda consumo de puntos post https //api mobbex com/p/loyalty/points/discharge parámetros credential número de credencial obtenido usando la búsqueda points cantidad de puntos a consumir en la cuenta webhooks los webhooks son urls seguras mediante las cual mobbex notificará los diferentes eventos relacionados con el módulo de fidelización para configurar un webhook debe hacerlo desde la consola de mobbex en la sección fidelización, configuración el webhook debe ser https (tls 1 2 o superior) y debe poder recibir datos mediante el método post de http tipos nueva credencial nueva operación nueva credencial tipo post formato json { "type" "loyalty credential", "data" { "uid" "r18wgnqmm", "credential" "a1b2c3d4", "name" "juan perez", "identification" "12123123", "email" "juanperez\@email com" } } nueva operación tipo post formato json { "type" "loyalty transaction", "data" { "result" true, "view" { "type" "card" }, "payment" { "id" "rkwpx3yu6x", "status" { "code" "200", "text" "paid", "message" "aprobada" }, "total" 10, "currency" { "code" "ars", "text" "peso argentino" }, "currency data" { "value" "pts", "label" "puntos", "symbol" "$p" }, "source" { "name" "puntos", "type" "card", "number" "xxxxxxxxxxxx" }, "user" { "name" "juan perez", "email" "juanperez\@mobbex com" }, "reference" "hyjdik8tx" } } }