Pagar con SERO, en cualquier web.

Demostración

Una tienda ficticia, el flujo real.

Arma un pedido y paga con SERO. Nada se cobra: la ventana es la misma que verá tu cliente y el teléfono simulado muestra lo que ocurre del otro lado.

Para quién es

Cualquier negocio que venda en una página web.

Si puedes agregar un fragmento de HTML a tu página, puedes aceptar pagos en USDT. El dinero llega completo a tu billetera SERO y tu cliente paga desde la suya, estén donde estén.

Integración

Tres pasos y estás cobrando.

¿No programas? Copia nuestro mensaje en Gemini, ChatGPT, Claude o un asistente abierto y revisa su trabajo con cinco comprobaciones: SERO Pay desde cero, con un asistente de IA.

1. Carga el archivo

   Una sola línea en el <head>. El canal v1 recibe correcciones sin cambios que rompan tu integración.

   <script src="https://web.sero.foundation/sdk/v1/sero-pay.js" defer></script>

   ¿Prefieres fijar la versión exacta con integridad verificada? Usa /sdk/1.0.2/sero-pay.js con integrity="sha384-BpDWHZ0QbMF/EsVMLMLcTZZG48sTJUppTz5t5jLZoDgK1W5BKFtxxKEofoqKSrcg" y crossorigin="anonymous".

2. Coloca el botón

   El componente <sero-pagar> dibuja el botón oficial y abre la ventana de pago. Para un monto único basta con monto; para un carrito, pasa los productos.

   <sero-pagar
     negocio="Tostadores del Ávila"
     direccion="0xTU_DIRECCION_SERO"
     monto="16.50"
     orden="A-1043">
   </sero-pagar>

   // Un carrito: la propiedad productos acepta la lista completa.
   document.querySelector("sero-pagar").productos = [
     { nombre: "Café de altura, 250 g", precio: "9.50", cantidad: 1 },
     { nombre: "Taza esmaltada", precio: "7.00", cantidad: 1 },
   ];

3. Entrega cuando llegue el pago

   Cuando el pago queda confirmado en la red, el botón emite sero:pagado con el recibo ya verificado.

   document.addEventListener("sero:pagado", (evento) => {
     const recibo = evento.detail;
     // recibo.referencia  número de referencia de la transacción (0x…)
     // recibo.pagador     billetera que pagó
     // recibo.monto       "16.50"
     // recibo.orden       "A-1043"
     fetch("/api/pedidos/A-1043/pagado", { method: "POST", body: JSON.stringify(recibo) });
   });

   Si vendes algo de valor, confirma también en tu servidor antes de entregar. Lo que ocurre en el navegador lo controla quien lo usa; lo que está en la red, no. Verificar en tu servidor.

const recibo = await SeroPay.pagar({
  negocio: "Tostadores del Ávila",
  direccion: "0xTU_DIRECCION_SERO",
  orden: "A-1043",
  productos: carrito.map((p) => ({ nombre: p.nombre, precio: p.precio, cantidad: p.cantidad })),
});
if (recibo) confirmarPedido(recibo);

Cómo funciona

El dinero va de billetera a billetera. Nadie en medio.

1. La orden. El archivo arma en el navegador una orden SERO idéntica a las que crea la app: productos, total y tu dirección. De ella sale una huella única de 24 bytes.
2. El cobro. Tu cliente elige cómo recibirla: con una notificación en su teléfono, que insiste hasta que la atienda, o con un QR que puede escanear ahora o guardar y escanear después desde su galería.
3. La aprobación. SERO le muestra la orden completa, a quién le paga y cuánto. Él la confirma en su teléfono con su rostro o su huella. Nada se mueve sin esa confirmación.
4. El pago. El contrato público de SERO transfiere los USDT de su billetera a la tuya y deja la huella de la orden grabada en la red.
5. La confirmación. Tu página pregunta por esa huella y comprueba el pago directamente en nodos públicos de BNB Smart Chain: destino, monto exacto y orden. Solo entonces emite sero:pagado.

Verificar en tu servidor

La última palabra la tiene la red.

El módulo sero-pay.mjs contiene el mismo núcleo sin interfaz. Funciona en Node 18 o superior, Deno, Bun y Cloudflare Workers. Descárgalo y guárdalo junto a tu código: sero-pay.mjs.

import { crearOrden, consultarPago } from "./sero-pay.mjs";

// La misma referencia y los mismos datos producen la misma orden que vio el cliente.
const orden = crearOrden({
  direccion: "0xTU_DIRECCION_SERO",
  orden: "A-1043",
  productos: pedido.productos,
});

const recibo = await consultarPago(orden, { bloques: 900 });
if (recibo) {
  // Pago confirmado en la red: destino, monto exacto y orden coinciden.
  await marcarPagado(pedido.id, recibo.referencia);
}

consultarPago pregunta por la huella y lee el recibo de la transacción en nodos públicos. Con bloques busca además en los bloques recientes, por si el aviso del teléfono del cliente no llegó. Para confirmar un número de referencia que ya tienes, usa verificarReferencia(orden, referencia).

¿Otro lenguaje? La especificación del protocolo describe cada byte: con ella se implementa en PHP, Python, Go o lo que uses.

Suscripciones

Mes a mes, con permiso cada vez.

Una suscripción SERO es una orden por periodo. Cada mes tu servidor envía el cobro y el suscriptor lo aprueba desde su teléfono. Nadie retira dinero sin su confirmación, y dejar de pagar es tan simple como rechazar el cobro.

1. El alta: el primer pago

   El botón con plan y cliente cobra el mes en curso. El recibo trae la billetera que pagó: guárdala con el suscriptor.

   <sero-pagar
     negocio="Tostadores del Ávila"
     direccion="0xTU_DIRECCION_SERO"
     plan="club-cafe"
     plan-nombre="Club del Café"
     monto="12.00"
     cliente="cliente-881">
   </sero-pagar>

2. Cada mes: el cobro desde tu servidor

   Una tarea programada recorre a tus suscriptores. La orden de un periodo es siempre la misma, así que repetir la tarea nunca cobra dos veces.

   import { ordenDeSuscripcion, consultarPago, enviarCobro, periodoActual } from "./sero-pay.mjs";
   
   const periodo = periodoActual(); // "2026-10"
   for (const s of suscriptores) {
     const orden = ordenDeSuscripcion({
       negocio: "Tostadores del Ávila",
       direccion: "0xTU_DIRECCION_SERO",
       plan: { id: "club-cafe", nombre: "Club del Café", precio: "12.00" },
       cliente: s.id,
       periodo,
     });
     if (await consultarPago(orden)) continue;        // ya pagó este mes
     const envio = await enviarCobro(orden, s.billetera);
     if (!envio.ok) avisarPorCorreo(s, envio.mensaje); // por ejemplo, sin notificaciones activas
   }

3. Y si no lo aprueba

   El cobro insiste cuatro veces en diez minutos y vence a los treinta. Puedes volver a enviarlo más tarde o mandarle el QR por correo con qrSvg(await enlaceCorto(orden)). Si el suscriptor rechaza y bloquea, tus cobros dejan de llegarle: esa es su forma de darse de baja.

Referencia

Todo lo que expone el archivo.

También en texto plano, pensado para leerlo de corrido o entregárselo a un asistente de programación.

Atributos de <sero-pagar>

Eventos

Funciones de SeroPay y de sero-pay.mjs

Límites

• Total mínimo de una orden: 1.00 USDT. Montos con hasta dos decimales.
• Hasta 100 líneas por orden; nombres de hasta 40 caracteres.
• Una misma billetera recibe como máximo 6 cobros por hora. No hay límite por comercio.
• Un cobro insiste al enviarse y a los minutos 1, 3 y 10, y vence a los 30 minutos.
• La billetera del cliente necesita las notificaciones activas para recibir cobros; sin ellas, paga escaneando el QR.

Política de seguridad de contenido

Si tu web define una CSP, agrega estos orígenes:

script-src https://web.sero.foundation;
connect-src https://gate-latam.sero.foundation https://bsc-rpc.publicnode.com https://bsc-dataseed.bnbchain.org https://bsc-dataseed1.binance.org https://1rpc.io;

La ventana usa Shadow DOM y hojas de estilo construidas: los estilos de tu web no la alteran y no requiere 'unsafe-inline'.

Especificación del protocolo

Cada byte, por escrito.

Para implementar SERO Pay en otro lenguaje o auditar el archivo. Todo lo que sigue es público y verificable.

1. La orden

JSON con estos campos, en este orden exacto, codificado en UTF-8 y luego en base64url sin relleno:

{"v":1,"id":"A-1043","number":1043,"status":"enProceso","total":"16.50","currency":"USDT",
 "merchantAddress":"0x…(minúsculas)","products":[{"id":"p1","name":"Café de altura, 250 g",
 "price":"9.50","quantity":1,"subtotal":"9.50"}]}

Montos como texto con dos decimales. total es la suma exacta de los subtotal. Luego:

canonico = "SERO-ORDER-V1." + base64url(json)
suma      = primeros 10 caracteres hexadecimales, en mayúsculas, de keccak256(canonico)
token     = canonico + "." + suma
huella    = primeros 48 caracteres hexadecimales de keccak256("SERO-ORDEN-HUELLA-V1|" + token)

keccak256 es el de Ethereum, no SHA3-256.

2. El pago en la red

La app de quien paga usa como clientTxId la huella seguida de 8 bytes al azar. El contrato SERO 0xc872fcbc4Df48187454798Ebc94176A258832F4D en BNB Smart Chain (cadena 56) emite:

PaymentExecuted(bytes32 indexed clientTxId, address indexed user, address indexed recipient,
                uint256 amount, uint256 fee, uint256 nonce, address relayer, address treasury)
topic0 = 0x101bbd0b71609893cf7095fdbebe9b6e9e097866134ccb8d28e9ce3d309b14e4

Un pago corresponde a una orden cuando la transacción tiene estado 0x1, el log viene de ese contrato y ese topic0, los bytes 1 a 24 de topic1 son la huella, topic3 es tu dirección y amount (primeros 32 bytes de data) es exactamente total × 10¹⁸.

3. La pasarela

Base: https://gate-latam.sero.foundation. JSON en ambas direcciones, CORS abierto, sin credenciales.

La pasarela solo guarda lo que la cadena ya muestra en público y, mientras dura un cobro, a qué billetera se envió. Nunca decide si un pago es válido: esa comprobación se hace siempre contra la red.

Más sobre SERO Pay

Guías para cada tipo de negocio.