Cobra en USDT desde tu web, con ayuda de una IA.

Antes de empezar

Tres cosas, y diez minutos.

Paso 1

Copia este mensaje y pégalo en tu asistente.

Está escrito para que el asistente lea primero la documentación oficial y no improvise. Funciona igual en cualquiera.

Quiero agregar «Pagar con SERO» (SERO Pay) a mi web. Ayúdame paso a paso.

1. Antes de escribir código, lee la referencia oficial completa: https://web.sero.foundation/sdk/v1/referencia.txt. Si no puedes abrir enlaces, dímelo y te la pego. No inventes nada que no esté ahí.

2. Pregúntame qué uso (HTML, WordPress, Node, Python, PHP u otro), qué vendo y mi dirección SERO (empieza por 0x).

3. Empieza siempre con el atributo demostracion, para probar sin mover dinero.

4. Usa un número de orden único por venta, y que tenga dígitos (por ejemplo A-1043).

5. Si entrego algo de valor (un archivo, un acceso, un envío), el pago se confirma en mi servidor antes de entregar: con consultarPago de sero-pay.mjs, o con el protocolo de la sección 8 si mi servidor no usa JavaScript. Página y servidor deben crear la orden con los mismos datos: dirección, orden, negocio, concepto y monto o productos. Nunca entregues solo porque el navegador recibió el evento sero:pagado.

6. Si mi sitio tiene una política de seguridad de contenido (CSP), dime qué agregar según la sección 8.4.

7. Explícame cada paso en palabras sencillas y termina con una lista para comprobar que todo funciona antes de cobrar de verdad.

¿Tu asistente no abre enlaces? Los que corren sin internet, en tu computadora, no pueden. Copia la referencia completa y pégala en la misma conversación, después del mensaje.

Paso 2

Responde sus preguntas, con tus datos reales.

1. Dile qué usas y qué vendes

   «Tengo WordPress y vendo asesorías de 25 dólares» basta. Si vendes algo que se entrega solo, como un curso o un archivo, díselo: cambia cómo debe hacerlo.

2. Dale tu dirección SERO

   Es pública: sirve para recibir, no para gastar. Nunca le des tu secreto, tus 12 palabras ni tu llave privada. Ningún paso de esta integración los necesita.

3. Pega el código donde te diga

   Con el atributo demostracion puesto. Así puedes pagar de prueba todas las veces que quieras sin mover dinero.

Paso 3

Revisa lo que hizo la IA antes de cobrar.

Un asistente puede equivocarse con total seguridad. Estas cinco comprobaciones te dicen si quedó bien, aunque no leas el código.

1. El botón dice «Demostración»

   Ábrelo y busca el aviso «Demostración: nada se cobra de verdad». Si no aparece, todavía no lo pruebes.

2. Cada venta tiene su propio número

   El número de orden debe cambiar en cada compra y tener dígitos, como A-1043. Si es siempre el mismo o solo tiene letras, tu servidor no podrá confirmar el pago: pídele al asistente que lo corrija.

3. La prueba de la consola

   Si entregas algo automáticamente, abre tu página, pulsa F12 y, en la pestaña «Consola», pega esto:

   document.dispatchEvent(new CustomEvent("sero:pagado", { detail: { referencia: "0xfalso" } }))

   Si tu página entrega el producto, está mal: cualquiera podría llevárselo sin pagar. La entrega debe esperar la confirmación de tu servidor. Copia este párrafo al asistente y pídele que lo arregle.

4. Tu servidor dice «no pagado» cuando nadie pagó

   Pídele al asistente una forma de preguntarle a tu servidor por una orden que nadie pagó. Debe responder que no está pagada.

5. El primer cobro real, de 1 USDT

   Quita demostracion y págate 1 USDT desde otra billetera SERO. Si llega a tu billetera y tu página lo reconoce, estás listo.

Sin asistente

Las recetas, listas para copiar.

El botón, en cualquier página

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

<sero-pagar demostracion
  negocio="Tu negocio"
  direccion="0xTU_DIRECCION_SERO"
  monto="25.00"
  concepto="Sesión de asesoría">
</sero-pagar>

En WordPress va en un bloque de «HTML personalizado»: lo explica la guía de WordPress. Sin el atributo orden, cada visitante recibe una orden distinta: sirve para cobros que confirmas tú mismo en tu billetera. Si tu servidor va a confirmar el pago, es tu servidor quien crea el número de cada venta (A-1043, A-1044…) y lo pone en el botón.

La confirmación en tu servidor (Node)

// verificar.mjs, en tu servidor (Node 18 o más reciente).
// Descarga https://web.sero.foundation/sdk/v1/sero-pay.mjs y guárdalo junto a este archivo.
import { crearOrden, consultarPago } from "./sero-pay.mjs";

// Con los mismos datos con los que tu página creó el botón.
export async function pagoConfirmado(pedido) {
  const orden = crearOrden({
    direccion: "0xTU_DIRECCION_SERO",
    negocio: "Tu negocio",
    orden: pedido.id,          // por ejemplo "A-1043": único y con dígitos
    monto: pedido.monto,       // o productos, igual que en la página
    concepto: pedido.concepto,
  });
  return consultarPago(orden, { bloques: 900 }); // null mientras no haya un pago en la red
}

Para Python, la página del protocolo trae un ejemplo completo. Para PHP u otro lenguaje, pídele a tu asistente que implemente la sección 8 de la referencia: necesitará una librería de keccak256, porque hash('sha3-256') no sirve.

Sigue leyendo

Más sobre SERO Pay.