🪙 Kairos Pay SDK v1.0

Acepta Crypto
en tu Sitio Web

2 líneas de código. Sin MetaMask. Sin complicaciones. Solo Kairos Wallet.

🛒 Demo — Tienda de Ejemplo

● EN VIVO
$49.99

Producto de ejemplo — Elige cómo pagar

⚡ Integración en 3 Pasos

Todo lo que el desarrollador necesita para aceptar pagos crypto.

1

Agrega el script

Una sola línea en tu HTML. Sin npm, sin build, sin dependencias.

<script src="https://kairos777.com/kairos-pay.js"></script>
2

Configura tu wallet

Reemplaza la dirección con la wallet donde quieres recibir los pagos.

<script>
  KairosPay.init({
    merchantWallet: '0xTU_WALLET_AQUI',  // Tu dirección BSC/EVM
    merchantId:     'mi_tienda',          // Nombre único (opcional)
    chain:          56,                     // 56=BSC (recomendado)
    currencies:     ['KAIROS', 'USDT', 'USDC'],
    theme:          'dark',                 // 'dark' o 'light'
    locale:         'es',                   // 'es' o 'en'
    onSuccess: function(payment) {
      // ✅ Pago confirmado en blockchain
      console.log('Pagado!', payment.txHash);
      // Aquí actualizas tu pedido en tu backend
    },
    onError: function(error) {
      console.log('Error:', error.message);
    }
  });
</script>
3

Abre el checkout

Llama a checkout() cuando el usuario quiera pagar.

// En tu botón de pago:
KairosPay.checkout({
  amount:   25.00,     // Monto en la moneda seleccionada
  currency: 'USDT',    // Opcional — si omites, el cliente elige
  memo:     'Orden #1234'
});

🔥 ¿Qué incluye?

📱
QR Code automático
El cliente escanea con Kairos Wallet y paga al instante.
🔗
Deep Link
En móvil, abre Kairos Wallet directamente con un tap.
Confirmación en tiempo real
SSE streaming — ves el status PENDING → CONFIRMED al instante.
🌐
5 Blockchains
BSC, Ethereum, Base, Arbitrum, Polygon.
🎨
Tema Dark / Light
Se adapta al diseño de tu sitio web.
🔒
Verificación HMAC
Cada pago es firmado y verificado. Anti-tampering.

📖 Referencia Completa

KairosPay.init(options)

ParámetroTipoRequeridoDescripción
merchantWalletstringDirección wallet que recibe pagos (0x...)
merchantIdstringIdentificador del negocio (default: 'kairos_merchant')
chainnumberChain ID: 56 (BSC), 1 (ETH), 8453 (Base), 42161 (ARB), 137 (Polygon)
currenciesstring[]Monedas aceptadas: ['KAIROS','USDT','USDC','BNB']
themestring'dark' o 'light'
localestring'es' o 'en'
expiresInnumberSegundos para expirar (default: 300 = 5 min)
onSuccessfunctionCallback cuando pago confirmado. Recibe objeto payment.
onErrorfunctionCallback en error/expiración.
onPendingfunctionCallback cuando la TX es enviada (antes de confirmar).

KairosPay.checkout(options)

ParámetroTipoRequeridoDescripción
amountnumberMonto a cobrar
currencystringSi omites, el cliente elige entre las monedas configuradas
memostringNota/referencia (ej: 'Orden #1234')

KairosPay.createButton(options)

Crea un botón estilizado que puedes insertar en tu HTML:

const btn = KairosPay.createButton({
  amount: 15.00,
  currency: 'USDT',
  memo: 'Suscripción mensual',
  label: 'Pagar Suscripción'
});
document.getElementById('my-container').appendChild(btn);

KairosPay.getStatus(reference)

Consulta el estado de un pago por su referencia:

const status = await KairosPay.getStatus('KPay-1709301234-abc123');
console.log(status);
// { reference, amount, currency, status: 'CONFIRMED', txHash, ... }

Objeto Payment (onSuccess callback)

// Lo que recibes en onSuccess:
{
  reference: 'KPay-1709301234-abc123',
  amount: '25.00',
  currency: 'USDT',
  chainId: 56,
  to: '0xWALLET_DEL_MERCHANT',
  status: 'CONFIRMED',
  txHash: '0xabc...def',
  fromAddress: '0xCLIENTE_QUE_PAGO',
  confirmedAt: 1709301340,
  blockNumber: 45123456,
  confirmations: 3
}

📋 Ejemplo Completo (Copy & Paste)

Esto es literalmente todo lo que necesitas pegar en el HTML de tu cliente:

<!-- 1. Agrega el SDK (antes de </body>) -->
<script src="https://kairos777.com/kairos-pay.js"></script>

<script>
  // 2. Configura (una vez al cargar la página)
  KairosPay.init({
    merchantWallet: '0xTU_WALLET_BSC',
    chain: 56,
    currencies: ['KAIROS', 'USDT', 'USDC'],
    theme: 'dark',
    locale: 'es',
    onSuccess: function(payment) {
      // Notifica a tu backend que el pago fue exitoso
      fetch('/api/confirm-order', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          orderId: 'tu_orden_id',
          txHash: payment.txHash,
          reference: payment.reference,
          amount: payment.amount,
          currency: payment.currency
        })
      });
      alert('✅ ¡Pago confirmado! TX: ' + payment.txHash);
    }
  });

  // 3. Cuando el usuario hace click en "Pagar con Crypto":
  function pagarConKairos(monto, ordenId) {
    KairosPay.checkout({
      amount: monto,
      memo: 'Orden #' + ordenId
    });
  }
</script>

<!-- 4. Tu botón de pago -->
<button onclick="pagarConKairos(49.99, '1234')">
  🪙 Pagar con Crypto
</button>

🌐 Cadenas Soportadas

ChainIDTokensFees
BNB Smart Chain56KAIROS, USDT, USDC, BNB~$0.05
Ethereum1KAIROS, USDT, USDC, ETH$2-10
Base8453KAIROS, USDC, ETH~$0.01
Arbitrum42161KAIROS, USDT, USDC, ETH~$0.02
Polygon137KAIROS, USDT, USDC, MATIC~$0.01