For agents
Paying for a plan with x402
x402 is the payment standard built on HTTP's status code 402, "Payment Required": a server answers a request with a price and an address, the client pays on-chain, and repeats the request with proof. No account form, no card, no human in the loop. This page says how it works with DreamWidget, where each chain stands, and what is live today.
What is live today
Two things an agent can use right now:
- The API. A key from an account page opens everything the dashboard does: make a widget, set its design, add logos and video sources, publish, read counts. The API guide.
- Pay with crypto. A month or a year of any plan in XRP, HBAR, SOL or USDC, from the account page, granted the moment the payment is final. That is a page a person uses, not a 402 an agent answers.
POST /v1/plan answers 402 with the price in USDC on Base, USDC on Solana, XRP, and HBAR or USDC on Hedera, and settles a payment through that network's facilitator: Coinbase's for USDC on Base and Solana, t54's for the XRP Ledger, AMNT's hosted Hedera facilitator for HBAR and USDC on Hedera. Proven end to end on the XRP Ledger testnet with a faucet wallet, and to the facilitator's door for USDC on Base Sepolia and Solana devnet, by a check in our own suite that pays for real on the testnet. If a chain is ever withheld, the 402 says why in a note.The flow
- Ask for a plan.
POST https://dreamwidget.com/api/v1/planwith{"plan":"pro","term":"month"}. With your API key the plan goes on your account. Without one, add"email"to the body: a new email gets a new account and its API key in the answer, an existing account gets the plan and makes a key after signing in. The price alone needs nothing: a bareGETis answered with the 402. - Get a 402. The answer carries a
PAYMENT-REQUIREDheader: the price in US dollars, the asset and network you may pay in, the address to pay, and the facilitator that will verify it. The same price as the card checkout, no surcharge. - Pay. Your wallet signs the payment for that amount, on the network you chose.
- Repeat the request, now carrying the payment. Put the signed payment in the
PAYMENT-SIGNATUREheader (the olderX-PAYMENTname is read too). We hand it to the facilitator, which verifies and settles it on-chain, and the plan is on your account for the term you paid, the same instant. The answer is200with the plan and its end date, and aPAYMENT-RESPONSEheader carrying the settled transaction. An XRP quote is good for ten minutes and pays once: the same signed payment sent twice is refused the second time, and so is a quote that has expired. USDC needs no quote; the amount follows from the price. - Build. Every other API call now runs under that plan's limits. A term does not renew on its own; ask for another before it ends and it starts where this one stops.
An agent built on the x402 client libraries (the x402 packages for TypeScript and Python) does steps 2 to 4 on its own: it sees the 402, pays, retries.
Where to find us
Agents and directories read the same three things: the 402 itself at https://dreamwidget.com/api/v1/plan, the manifest at https://dreamwidget.com/.well-known/x402, and the OpenAPI document at https://dreamwidget.com/openapi.json. We are listed on the XRPL AI Hub, the 402 Index and x402scan, and Coinbase's Bazaar indexes the door after its first settled USDC payment.
Where each chain stands
Checked on 14 September 2026, against each network's own documentation and its facilitator.
| Chain and asset | Facilitator | Standing | Our plan |
|---|---|---|---|
| USDC on Base, USDC on Solana | Coinbase's CDP facilitator | The reference implementation, governed by the x402 Foundation; the most used networks; first 1,000 settlements a month free, then a tenth of a cent each. | First. |
| XRP and RLUSD on the XRP Ledger | t54's XRPL facilitator, on mainnet, documented on xrpl.org | Production: past a million agentic payments by July 2026, with standard verify and settle endpoints. Early-stage software by its own description, so versions are pinned. | First, beside USDC. |
| HBAR and USDC on Hedera | AMNT's hosted Hedera facilitator on mainnet (facilitator.amnt.io), open source; Blocky402 (api.blocky402.com) is the alternative | Hedera's exact scheme is part of the official x402 packages (@x402/hedera). Both facilitators answer on mainnet with funded fee payers. Small operators, so our server pins versions and refuses rather than guesses when one does not answer. | Live since 14 September 2026, proven on testnet by a settled HBAR payment through AMNT in about a second. One thing for an agent paying HBAR: the x402 client library spends only its default assets unless told otherwise, and HBAR is not one, so set client.setSpendControls(false) or list asset 0.0.0 in allowedAssets. USDC on Hedera is a default asset and needs nothing. |
| SOL itself | Coinbase's facilitator on Solana | Solana settles SPL tokens; USDC on Solana is the asset the standard prices in. SOL as the asset is not part of the exact scheme. | USDC on Solana instead; SOL stays available on the pay-with-crypto page. |
Questions
Is the price the same? Yes. A month of Pro is $30 whether paid by card, by crypto on the account page, or by x402. The network fee is the payer's.
Does it renew? No. A wallet cannot be billed, which is the point. A term ends on its date; ask for another before then and it continues without a gap. The API's GET /v1/me says when the current term ends.
Refunds? An on-chain payment is final once confirmed. Buy a month first if in doubt.
What does a key let an agent reach? Its own account's widgets and counts, under its plan. Nothing of anyone else's, and nothing of ours.