Saltar al contenido principal

Cómo funciona

Los cupones y las giftcards los emite n1co, no tu comercio. El comprador los paga en n1coCupones y recibe un código. Ese código se presenta en tu punto de venta.

El flujo es el mismo para ambos. Lo específico de las giftcards está al final de esta página.

Flujo completo

El código

  • Es una cadena alfanumérica. El comprador la ve en pantalla, en su correo y en el pase que agrega a la billetera de su teléfono.
  • Se entrega también como QR, para comercios cuyas cajas puedan leerlo.
  • El canje es anónimo: no se identifica al portador. Quien presente el código puede usarlo, así que conviene tratarlo con el mismo cuidado que el efectivo.
  • Se consume una sola vez. El campo redemptionLimit que llega en la compra lo confirma.

Vigencia

Cada código viaja con su fecha de inicio y de vencimiento. Puedes respetarlas localmente, pero la fuente de verdad es la API de canje: tu copia puede quedar desactualizada si un código se anula después de habértelo enviado.

Disponibilidad tras la compra

n1co envía el webhook en el instante en que se confirma el pago. El tiempo que tarde en quedar disponible en tus cajas depende de tu propia arquitectura.

Comunica una ventana de activación

Si tu sistema carga los códigos por lotes o por sincronización periódica, define una ventana y comunícasela al comprador. n1coCupones puede mostrarla en la descripción del producto, para que nadie llegue a canjear antes de que su código esté disponible.

Giftcards

Todo lo anterior aplica igual. La diferencia es que una giftcard no representa una promoción concreta, sino un monto, y eso agrega dos consideraciones que un cupón no tiene.

El monto se descuenta de la cuenta

Un cupón define por sí mismo qué entregas. Una giftcard, en cambio, se comporta como un medio de pago: al canjearla aplicas su valor a la cuenta del cliente.

Ese valor llega en la compra, en el campo price. Tu sistema debe tomarlo de ahí y no pedírselo al cajero — ver cuál es el monto.

Canje total, sin saldo remanente

warning

Una giftcard se consume completa en una sola transacción. No existe consumo parcial ni saldo a favor: si la cuenta del cliente es menor al valor de la giftcard, la diferencia se pierde.

Pagos mixtos

Como es un medio de pago, puede convivir con otros. En una cuenta de $30 con una giftcard de $20, se aplican los $20 y los $10 restantes se cobran por otro medio. El orden en que se apliquen lo define tu comercio.