LaNoti

Modo API

Para negocios con su propio sistema: tienda en línea, app de pedidos o delivery (como Musuq Delivery).

Quién hace qué

• El responsable del negocio, en la app: elige el modo 9, crea la llave y la envía a quien programa. Desde ahí también activa o desactiva conexiones y ve los cobros.
• Quien programa tu sistema, en esta página: pega la llave y sigue los ejemplos de abajo. No necesita entrar a la app.

Ventajas y límites

• Cada pedido se confirma solo al llegar el pago y tu sistema recibe el aviso al instante.
• Pagas según cuánto usas: S/ 10 al mes con 300 cobros pagados incluidos, S/ 0.05 por cada cobro extra y nunca más de S/ 50 al mes. Por ejemplo, 15 cobros al día (unos 450 al mes) son S/ 17.50.
• Desde 1100 cobros en el mes (donde llegas a los S/ 50, lo máximo que pagas) tu negocio ya procesa muchos pagos. No se corta nada: al crear un cobro, la respuesta trae un campo warning (muchos_cobros) que avisa que probablemente necesitas otro número de Yape o Plin, u otra forma de procesar tus pagos, porque con tantos cobros por un solo número se expone a que se confundan o se demoren. El mes es el del calendario, con hora de Perú.
• Los cobros extra se suman a tu siguiente renovación en la web, o los pagas aparte cuando ya junten S/ 5. La semana de prueba no cuenta cobros.
• Hasta 3 conexiones por negocio. La llave se muestra una sola vez; si se pierde, se crea otra.
• El celular con LaNoti debe estar prendido, con internet y con el permiso de notificaciones. Si se desconecta, los cobros se confirman cuando vuelva.
• El cliente debe pagar el monto exacto. Si dos clientes deben pagar el mismo monto a la vez, a uno se le pide un monto con céntimos.

Cómo funciona

1. En la app LaNoti, elige el modo 9, Modo API y toca Crear la llave. Copia la llave y el secreto: se muestran una sola vez.
2. Tu sistema crea un cobro: "pedido 123 por S/ 23.50".
3. El cliente paga ese monto exacto por Yape o Plin al celular del negocio.
4. Cuando llega el pago, el cobro pasa a pagado y tu sistema recibe el aviso en su webhook.

Si hay varios cobros pendientes del mismo monto, desempata el nombre de quien pagó (payerHint). Si aun así no se puede saber, el pago queda sin asignar y lo ves en la app.

Crear un cobro

POST https://yallego.musuqapp.com/v1/intents
Authorization: Bearer ylk_...
Content-Type: application/json

{
  "reference": "pedido-123",
  "amountCents": 2350,
  "expiresInMinutes": 30,
  "payerHint": "Juan Pérez",
  "sources": ["yape", "plin", "lemon"]
}

Responde con el cobro: id, amountCents, status ("pendiente") y expiresAt. La reference es tuya y no se repite.

Consultar o cancelar

GET  /v1/intents/:id           → { "status": "pendiente" | "pagado" | "expirado" | "cancelado", ... }
POST /v1/intents/:id/cancel

Aviso de pago (webhook)

Cuando llega el pago, LaNoti hace un POST a la dirección que pusiste en la app (debe empezar con https://). Si tu servidor no responde, se reintenta.

X-Yallego-Timestamp: 1791522757
X-Yallego-Signature: hex(HMAC-SHA256(secreto, "<timestamp>.<body>"))

{ "type": "cobro.pagado",
  "data": { "reference": "pedido-123", "status": "pagado", "amountCents": 2350,
            "payerName": "Juan Perez", "payerSource": "yape", "paidAt": "..." } }

Comprueba la firma con tu secreto antes de dar el pedido por pagado.

Requisitos

• El celular donde llegan los Yape o Plin del negocio tiene LaNoti abierto con el permiso de notificaciones.
• La cuenta en el Modo API (semana de prueba o pagada). Puedes tener hasta 3 conexiones activas.
• Si una llave se filtra, desactívala en la app y crea otra.

¿Dudas? Escríbenos por WhatsApp desde la app (Ajustes → Ayuda).