API de tarjetas de regalo

El código de la tarjeta de regalo, emitido desde la plataforma que la empresa ya usa.

Loyalty Rewards Latinoamérica expone una API para que el sistema de la empresa solicite un código digital, lo reciba de vuelta en la misma operación y consulte su estado y el saldo del programa. Catálogo multimarca por país, en diez países de Latinoamérica.

Una tarjeta de regalo que no obliga a salir del sistema

El área de sistemas no quiere otro portal, quiere una llamada que responda. La integración está pensada para que el programa de incentivos viva dentro de la plataforma que la empresa ya opera.

El código nace en la plataforma del cliente

La empresa no cambia de herramienta. La solicitud sale de su propio sistema y el código regresa ahí mismo, dentro de la experiencia que el colaborador ya conoce.

Catálogo multimarca, por país

La misma integración resuelve marcas y denominaciones distintas según el país del beneficiario, con la moneda local de cada uno.

Emisión en línea, no por lote del día siguiente

La solicitud se resuelve en el momento en que la plataforma del cliente la envía, de modo que el beneficiario ve su código en la misma sesión.

Conciliación contra el registro de la empresa

Cada emisión viaja con la referencia que la empresa use para identificarla, y el detalle por periodo se puede consultar para cuadrar contra su propio registro.

Lo que la plataforma del cliente puede pedir y recibir

Las operaciones de emisión viven detrás de credenciales por empresa y por ambiente. El alcance que se habilita para cada cliente se define por contrato.

Consulta de catálogo

Devuelve las marcas, denominaciones, países y monedas disponibles para el programa de la empresa.

Emisión de código

Solicita un código indicando marca, denominación, país, beneficiario y la referencia que la empresa use para conciliar.

Consulta de una emisión

Devuelve el estado de una solicitud, su fecha y la referencia con que la registró la empresa.

Consulta de saldo del programa

Devuelve el fondo disponible, para validar antes de emitir.

Reenvío de un código emitido

Vuelve a entregar un código ya emitido, sin generar una emisión nueva.

Aviso automático de eventos

Notifica a la plataforma del cliente cuando una solicitud cambia de estado.

Conciliación por periodo

Devuelve el detalle de lo emitido por periodo, marca, país y beneficiario.

Cancelación según política de la marca

Procesa la cancelación de un código cuando la marca emisora lo permite.

De la primera conversación a producción

El mismo recorrido en todos los casos. Lo que cambia es el alcance que cada empresa necesita.

  1. 1

    Alcance

    Se define con el área de sistemas de la empresa qué operaciones se necesitan, qué catálogo se expone, en qué países y con qué volúmenes.

  2. 2

    Credenciales de prueba

    Se emiten accesos del ambiente de pruebas para el equipo técnico del cliente, distintos a los de producción.

  3. 3

    Validación del cliente

    El equipo de la empresa recorre el flujo completo contra el ambiente de pruebas: emisión, consulta de estado, saldo y aviso de eventos.

  4. 4

    Habilitación de producción

    Se emiten las credenciales de producción y se acuerda la ventana de arranque con la empresa.

  5. 5

    Operación con seguimiento

    El ejecutivo asignado y el equipo técnico quedan como contacto para incidencias y para ampliar el alcance cuando la empresa lo requiera.

Lo que recibe el equipo técnico

Documentación de referencia

El detalle de cada operación, sus campos y sus respuestas, entregado al equipo técnico del cliente al activar la integración.

Credenciales por ambiente

Accesos separados para pruebas y para producción, emitidos a nombre de la empresa.

Formato del aviso de eventos

La estructura exacta del aviso y el destino donde la empresa quiere recibirlo.

Catálogo consultable

Las marcas y denominaciones vigentes se leen por la propia API, sin listas cargadas a mano.

Contacto técnico

Un canal con el equipo que operó la integración, no solo con el ejecutivo comercial.

Catálogo público sin credenciales

El catálogo de promocionales sí es abierto y sin registro: /api/catalogo. La emisión de tarjetas de regalo no.

Una integración, diez países

La solicitud indica el país del beneficiario y la emisión se resuelve con el catálogo y la moneda de ese país.

México

Moneda local: MXN

Guatemala

Moneda local: GTQ

Costa Rica

Moneda local: CRC

Panamá

Moneda local: USD

República Dominicana

Moneda local: DOP

Colombia

Moneda local: COP

Ecuador

Moneda local: USD

Perú

Moneda local: PEN

Chile

Moneda local: CLP

Argentina

Moneda local: ARS

Lo que pregunta el área de sistemas

¿Tienen API de tarjetas de regalo?

Sí. Loyalty Rewards Latinoamérica expone una API para que la plataforma de la empresa solicite códigos digitales de tarjeta de regalo y los reciba de vuelta dentro de su propia experiencia. El alcance de cada integración se define con el área de sistemas del cliente y se habilita por contrato.

¿Qué marcas se pueden emitir por API?

Las marcas del catálogo disponible en el país del beneficiario. El catálogo se consulta por la misma API, de modo que la plataforma de la empresa siempre lee las marcas y denominaciones vigentes sin depender de una lista cargada a mano.

¿Se puede emitir en varios países con una sola integración?

Sí. La misma integración atiende los diez países donde opera el programa. La solicitud indica el país del beneficiario y la emisión se resuelve con el catálogo y la moneda de ese país.

¿Cómo llega el código a la plataforma de la empresa?

El código y sus datos de canje regresan en la respuesta de la misma solicitud que lo pidió. La plataforma de la empresa los muestra dentro de su experiencia, sin que el colaborador salga de ella.

¿Hay avisos automáticos de eventos o webhooks?

Sí. Se notifica a la plataforma del cliente cuando una solicitud cambia de estado, sin que tenga que consultar de forma periódica. El destino del aviso lo define el área de sistemas de la empresa.

¿Qué autenticación usa la API?

Credenciales emitidas para cada empresa y para cada ambiente. Las operaciones de emisión no tienen acceso público. El detalle del esquema de autenticación se entrega al equipo técnico del cliente junto con las credenciales al activar la integración.

¿Hay un ambiente de pruebas?

Sí. El equipo del cliente valida el flujo completo contra un ambiente de pruebas antes de operar con beneficiarios reales, con credenciales distintas a las de producción.

¿Se integra con el ERP, el CRM o el sistema de recursos humanos que ya usa la empresa?

La integración se hace contra el sistema que la empresa indique. El equipo de sistemas del cliente conecta desde donde vive el proceso: su ERP, su CRM, su sistema de recursos humanos, su intranet o su portal de fuerza de ventas.

¿Qué pasa si un código no se entrega?

La plataforma del cliente puede consultar el estado de cualquier solicitud y pedir el reenvío de un código ya emitido. Si una solicitud no se resolvió, queda registrada con su estado y el ejecutivo asignado da seguimiento.

¿Se puede consultar el saldo del programa por API?

Sí. La plataforma del cliente consulta el saldo disponible del programa, de modo que puede frenar una emisión antes de intentarla si el fondo no alcanza.

¿Cuánto tarda una integración?

Depende de las operaciones que la empresa necesite y de la disponibilidad de su equipo técnico. El recorrido es el mismo en todos los casos: se acuerda el alcance, se entregan credenciales de prueba, el cliente valida, y se habilita producción.

Líneas relacionadasSSO y endpoints · Dispersión de comisiones e incentivos · Crear Gift Card