Using AisleRun
Paying with PayBox
How PayBox pays the x402 request, what the agent gets back, and what happens when a payment fails or is retried.
On this page
AisleRun doesn't take cards or API keys. A run is paid for with one x402 request, and PayBox is how your agent makes that payment without ever holding a private key. PayBox enforces the approval mode and limits you set on your wallet, and AisleRun only ever sees a signed payment.
The tool to use
Use PayBox's use_service tool. It makes the request, reads the 402, pays, retries, and hands the paid response back to the agent.
use_service({
credential_id: "<your wallet credential id>",
url: "https://aislerun.158-220-85-120.sslip.io/v1/inspections",
method: "POST",
body: { "quote_id": "…", "product_url": "…", "authorized_target_id": "…",
"profile": "shopify_checkout_entry_v1", "idempotency_key": "<stable uuid>" }
})
PayBox sends body only on the paid retry, so the unpaid first request is just the price check.
What PayBox returns to the agent
PayBox returns the response body, not the headers. That's why everything the agent needs is in the body: the run ID, the read token, and both URLs. On success the PayBox result looks like this (trimmed):
{
"status": "success",
"output": {
"value": {
"payment": { "status": "succeeded", "network": "eip155:8453", "scheme": "exact" },
"response": { "status": 200, "content_type": "application/json; charset=utf-8", "body": "{\"ok\":true,\"inspection_id\":\"…\", …}" }
}
}
}
What we observed
| Trial | Result |
|---|---|
| Wallet unfunded, signing key not paired | pending_signature, signer_unavailable. Nothing paid, nothing ran |
| Funded and paired | Paid and answered in about 6 seconds |
| Five paid runs | Each settled on Base within about a second of being verified |
All of these used PayBox's autonomous approval mode. The iframe and always_approve modes, where you confirm each payment, haven't been tried yet.
If the payment doesn't go through
| What happened | What AisleRun does |
|---|---|
| The wallet can't pay | The facilitator rejects the signature. No payment or run is recorded |
| The payment is signed but the request is wrong | Refused before settlement, so the payment is cancelled and nothing is charged |
| The payment fails to settle | The run becomes PAYMENT_DENIED and no browser starts |
| The agent retries the same request | It gets the same run back without a new charge. See Payments, retries and refunds |
Discovery
AisleRun works with use_service by URL. It isn't listed in the PayBox marketplace, and it won't appear in discover_services, which only lists services with at least 10 different payers in 30 days.