Skip to main content
POST
x402 Pay
Negocie y complete un pago x402 para una URL objetivo. AgentWallex evalúa las políticas del agente, firma el pago mediante MPC y devuelve la información de pago necesaria para acceder al recurso pagado.

Cuerpo de la solicitud

string
requerido
El agente cuya billetera financiará el pago.
string
requerido
La URL habilitada para x402 por la que se pagará (por ejemplo, https://paid-api.example.com/v1/data).
string
ID de sesión opcional para deducir de un presupuesto de sesión existente. Consulte Sesiones x402.
string
Identificador de cadena CAIP-2 para la liquidación del pago (por ejemplo, eip155:84532). Si se omite, se usa la cadena predeterminada del agente.

Respuesta

Ejemplo

Response

Endpoints relacionados

Autorizaciones

X-API-Key
string
header
requerido

API key authentication. Keys are prefixed with awx_.

Cuerpo

application/json
agent_id
string
requerido

The agent whose wallet will fund the payment.

target_url
string<uri>
requerido

The x402-enabled URL to pay for (e.g., https://paid-api.example.com/v1/data).

session_id
string

Optional session ID to deduct from an existing session budget.

chain
string

CAIP-2 chain identifier for payment settlement (e.g., eip155:84532). If omitted, the agent's default chain is used.

Respuesta

Payment completed successfully.

Result of an x402 payment negotiation.

ledger_id
string

Internal ledger entry ID for this payment.

amount
string

Payment amount.

fee_amount
string

Platform fee deducted.

fee_rate
string

Fee percentage applied (based on tiered pricing).

token
string

Token used for payment (e.g., USDC).

chain
string

Chain used for settlement.

status
enum<string>

Payment status.

Opciones disponibles:
completed,
pending,
failed
payment_signature
string

The PAYMENT-SIGNATURE value to include in the retry request to the target URL.