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

Get a cake by its ID
GET
Code examples
Params
C#
Curl
JS
PHP
200
Get a cake by its ID
GET
Code examples
Params
C#
JS
PHP
200

Importante: los datos opcionales a pesar de ser, justamente opcionales, deberían ser completados siempre que sea posible.

Get a cake by its ID
GET
Code examples
Params
C#
JS
PHP
200
Get a cake by its ID
GET
Code examples
Params
C#
JS
PHP
200

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
JSON

Nueva Operación

  • Tipo POST
  • Formato JSON
JSON