Tu producto.
Un enlace para cobrar.

Empieza con tu tienda existente.

Esta versión reutiliza el catálogo, los pedidos y la billetera de tu tienda en el Mall. No requiere abrir otra cuenta de Kairos ni copiar claves privadas.

Añade un botón a tu proyecto.

Desde Mi tienda → Kairos Pay puedes elegir un producto y copiar su enlace, QR o botón. Para integrarlo por código necesitas el ID UUID de un producto real. No se solicita ninguna firma ni se crea un pedido al generar el enlace.

<script src="https://kairos777.com/kairos-pay.js?v=1.3.0"></script>
<div id="comprar"></div>
<script>
  const boton = KairosPay.createCheckoutButton({
    productId: 'UUID_DE_TU_PRODUCTO',
    label: 'Pagar con Kairos Pay'
  });
  document.getElementById('comprar').appendChild(boton);
</script>

Sustituye el marcador por un UUID válido de tu tienda. createCheckoutButton devuelve un enlace accesible y sólo admite productId y label. El destino, la cantidad final y el importe no se configuran en el SDK.

https://kairos777.com/pay-checkout?product=UUID_DE_TU_PRODUCTO

Los enlaces no aceptan redirecciones arbitrarias, un importe alternativo ni un destinatario de pago. No uses onSuccess del SDK antiguo como prueba de una venta del Mall.

Entrega sólo una venta confirmada.

Abrir una página de retorno, volver a la tienda o ver un hash no demuestra que el vendedor haya recibido el pago.

1. El comprador autoriza su pedido en la Wallet. Allí se revisan el importe final, la red y los costos aplicables.
2. Kairos comprueba el pago en la cadena. El pedido se acredita al verificar la transacción, su destinatario y la finalización requerida.
3. Tu servidor recibe order.paid. Comprueba firma, tienda e identidad del pedido antes de entregar el producto o licencia.
4. Procesa cada evento una sola vez. Guarda su id en tu base de datos y vincúlalo con tu operación local dentro de una transacción.

Conecta las notificaciones del negocio.

En Kairos Wallet, abre tu tienda y la sección Kairos Pay → Integraciones · webhooks. Registra la URL HTTPS pública de tu servidor. Guarda el secreto que se muestra una sola vez en la configuración segura del servidor.

Productos digitales y servicios

El catálogo distingue fisico, digital y servicio. La modalidad queda fijada al crear el pedido. Por compatibilidad, order.shipped también comunica una entrega digital registrada por el vendedor: comprueba datos.requiereEnvio y datos.tipoCumplimiento antes de tratarla como un envío físico. La nota privada de acceso se muestra únicamente al comprador autenticado, no en el webhook. La recepción del comprador es un paso separado.

Verificar la firma en Node.js

Conserva el cuerpo como Buffer antes de procesar JSON. El secreto hexadecimal se usa como texto, sin convertirlo a bytes hexadecimales. El reloj del servidor debe estar sincronizado.

const crypto = require('node:crypto');

function verifyKairosSignature(rawBody, signature, secret, now = Date.now()) {
  if (!Buffer.isBuffer(rawBody) || rawBody.length > 65536
      || typeof secret !== 'string' || secret.length < 32) return false;
  const parts = /^t=(\d+),v1=([a-f0-9]{64})$/.exec(String(signature || ''));
  if (!parts) return false;
  const timestamp = Number(parts[1]);
  if (!Number.isSafeInteger(timestamp)
      || Math.abs(now - timestamp) > 300000) return false;
  const expected = crypto.createHmac('sha256', secret)
    .update(parts[1] + '.').update(rawBody).digest();
  return crypto.timingSafeEqual(expected, Buffer.from(parts[2], 'hex'));
}

Esta función comprueba autenticidad y antigüedad; no procesa una venta. Después de validarla, analiza el JSON, exige que tienda sea tu dirección de vendedor, valida tipo y contrasta datos.pedidoId y el importe esperado con tu pedido. Registra el evento y la entrega de forma atómica para evitar entregar dos veces. Mantén los secretos fuera del navegador, del repositorio y de los logs.

Administración autenticada

La pantalla de tu tienda usa estas rutas existentes. Todas requieren la firma V2 de la wallet propietaria, vinculada al método, ruta, cuerpo y solicitud. No son endpoints públicos ni utilizan una clave global compartida.

Base: https://api.kairos777.com/api/tienda/mi-tienda/pagos

Pedidos, reintentos y devoluciones.

Qué puedes integrar hoy.

Antes de entregar un producto real, comprueba conexión de tienda, compra autorizada, confirmación, webhook duplicado, recuperación de un envío incierto y devolución en el entorno adecuado. Ninguna pantalla de presentación acredita fondos ni demuestra por sí sola aprobación del procesador.