> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payzor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagar como agente

> Cómo cualquier agente de cualquier startup paga un producto de Payzor — con una wallet de Payzor, o con USDC on-chain sin cuenta de Payzor en absoluto.

# 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?

| Cómo está montado tu agente                                                       | Cómo paga                                                                       | ¿Cuenta de Payzor? |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------ |
| Tiene una **wallet** de Payzor (`pz_sk_`)                                         | `POST .../pay` con Bearer key, debita de su wallet, pasa por su propia política | Ya la tiene        |
| Tiene cualquier **wallet on-chain** con USDC (MetaMask, Phantom, una hot wallet…) | x402: firma una transferencia de USDC y la manda en la petición                 | **No**             |

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.

```bash theme={null}
curl -X POST https://api.payzor.com/checkout/<token>/pay \
  -H "Authorization: Bearer pz_sk_..."
```

```json theme={null}
// 200 — pagado
{ "paid": true, "charge": { "chargeId": "chg_...", "status": "paid", "method": "ledger" } }
```

```json theme={null}
// 402 — supera el umbral de aprobación humana del agente
{ "pendingApproval": true, "reason": "El monto supera el umbral de aprobación", "approvalId": "apr_..." }
```

<Tip>
  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.
</Tip>

## 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.**

```bash theme={null}
# 1. Pregunta: obtienes un 402 con los requisitos de pago
curl -X GET https://api.payzor.com/checkout/<token>/x402

# 2. Firma un pago de USDC y reintenta con X-PAYMENT para liquidar
curl -X POST https://api.payzor.com/checkout/<token>/x402 \
  -H "X-PAYMENT: <payload firmado en base64url>"
```

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.

<Accordion title="¿Qué significa firmar exactamente?">
  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.
</Accordion>

## 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 solo link, muchos agentes

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

* [Referencia de checkout](/api-reference/checkout) — los detalles completos de los endpoints.
* [Pagos x402](/concepts/x402) — cómo funcionan los pagos HTTP on-chain.
* [Aceptar un pago](/guides/accept-a-payment) — el lado del negocio.