Skip to main content

​
Pagar como agente

¿Necesitas una cuenta de Payzor para pagar? No. Cualquier agente de cualquier startup puede pagar un producto que un negocio vende. Hay dos vías, y cuál tomas depende solo de una cosa: ¿quieres pagar desde una wallet de Payzor, o desde una wallet on-chain cualquiera? La segunda fila es la clave. Un agente que no es usuario de Payzor paga on-chain, y no se autentica en Payzor en absoluto — demuestra quién es firmando dinero en la cadena. Sin tarjeta, sin crear cuenta, sin API key.

​
Requisitos

Necesitas la URL de checkout que te dio el negocio (/checkout/:token), y según la vía:
  • Vía wallet: una API key de agente de Payzor (pz_sk_...).
  • Vía on-chain: una wallet con USDC en una red que Payzor acepte, y la capacidad de firmar un payload de pago.

​
Vía A — Tienes una wallet de Payzor

Si tu agente ya corre en Payzor, paga desde su wallet. Su propia política de gasto aplica: el pago se evalúa contra topes por transacción, límites diarios y allowlists de categorías, y se pausa para aprobación humana si supera el umbral.
La API key ES la identidad. Quien la tenga gasta desde esa wallet, así que no la expongas en logs ni en la UI — y rótala si se filtra.

​
Vía B — No eres usuario de Payzor (on-chain)

Así es como cualquier agente de cualquier startup paga. Es nativo de HTTP: preguntas, el servidor responde con el precio, firmas una transferencia de USDC y reintentas, y se liquida. Sin cuenta, sin ciudadanía de Payzor, sin API key.
El facilitator de x402 verifica la firma y los fondos en cadena, y luego mueve el USDC desde tu wallet al negocio. Lo único que necesitabas era una wallet que pueda tener y transferir USDC — no una cuenta de Payzor.
Payzor no aloja ni conoce tu wallet. Cuando recibes el 402, incluye los requisitos de pago — monto, red, dirección de destino. Tu agente construye una autorización de transferencia de USDC, la firma con su propia clave de wallet (el mismo proceso que usaría para mover fondos a cualquier lado), y envía esa firma en la cabecera X-PAYMENT. Payzor verifica la firma contra la cadena, ve que los fondos están, y liquida. Tu wallet fue la identidad todo el tiempo.

​
Qué recibes de vuelta

Cualquiera de las dos vías liquida el mismo cargo en el lado del negocio y dispara un webhook (charge.succeeded / payment.succeeded). El recurso que pagaste es tuyo; el negocio se entera automáticamente. Al negocio no le importa qué vía usaste — el saldo se acredita igual. Un link de checkout es reutilizable: cada agente que paga materializa su propio cargo. Si diez agentes de diez startups distintas pagan el mismo link — algunos con wallet de Payzor, otros on-chain sin cuenta — obtienes diez cargos y el negocio ve diez liquidaciones.

​
Cómo elegir tu vía

  • ¿Quieres que el pago pase por tu política de gasto de Payzor (topes, categorías, aprobación humana)? Usa la Vía A.
  • ¿No tienes cuenta de Payzor pero sí una wallet con USDC? Usa la Vía B — esa es la vía de “cualquier startup”.

​
Checklist antes de pagar

  • Vía wallet: curl -X POST https://api.payzor.com/checkout/<token>/pay con pz_sk_.
  • Vía on-chain: ¿GET .../x402 devuelve un 402? Entonces firma y reintenta con X-PAYMENT.
  • ¿Supera tu propio umbral de aprobación? El pago se pausa hasta que un humano de tu startup lo apruebe — no se liquida solo.

​
Relacionado