Skip to content

docs: add official x402 facilitator and Blocky402 mainnet to x402 page#691

Open
piotrswierzy wants to merge 2 commits into
hashgraph:mainfrom
blockydevs:main
Open

docs: add official x402 facilitator and Blocky402 mainnet to x402 page#691
piotrswierzy wants to merge 2 commits into
hashgraph:mainfrom
blockydevs:main

Conversation

@piotrswierzy

Copy link
Copy Markdown
Contributor

Summary

Updates the Hedera facilitators section of the x402 payments page (solutions/ai/x402.mdx) to reflect facilitator support verified live on 2026-07-15.

Changes

  • Add the official x402 facilitator. https://x402.org/facilitator now advertises hedera:testnet (fee payer 0.0.9185802) and requires no setup or API key. Documented as the quickstart/testnet option.
  • Blocky402 mainnet is now live. Replaced the outdated "mainnet coming soon, will require an API key" note with a two-network table:
    • Testnet — https://api.testnet.blocky402.com, hedera:testnet, fee payer 0.0.7162784
    • Mainnet — https://api.blocky402.com, hedera:mainnet, fee payer 0.0.10571514
    • Both confirmed open-access (no API key).

Verification

All endpoints and fee-payer accounts were confirmed against each facilitator's live GET /supported response. Changes are external links/content only — no docs.json navigation change.

piotrswierzy and others added 2 commits July 15, 2026 16:31
Signed-off-by: Piotr Swierzy <piotr.swierzy@blockydevs.com>
docs: add official x402 facilitator and Blocky402 mainnet to x402 page
Comment thread solutions/ai/x402.mdx
| Advertised fee payer | `0.0.7162784` |
| Documentation | [blocky402.com/docs](https://blocky402.com/docs/) ([quickstart](https://blocky402.com/docs/quickstart/), [API reference](https://blocky402.com/docs/api-reference/), [networks](https://blocky402.com/docs/networks/)) |
| Advertised fee payer | `0.0.9185802` |
| API key | Not required |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| API key | Not required |
| API key | Not required |
<Warning>
The mainnet facilitator settles transactions with real HBAR. Test your integration against the testnet endpoint before switching to `https://api.blocky402.com`.
</Warning>

Comment thread solutions/ai/x402.mdx
| Hedera network | `hedera:testnet` | `hedera:mainnet` |
| Advertised fee payer | `0.0.7162784` | `0.0.10571514` |

Both expose the standard endpoints — `GET /supported`, `POST /verify`, and `POST /settle` — and are documented at [blocky402.com/docs](https://blocky402.com/docs/) ([quickstart](https://blocky402.com/docs/quickstart/), [API reference](https://blocky402.com/docs/api-reference/), [networks](https://blocky402.com/docs/networks/)).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Both expose the standard endpoints `GET /supported`, `POST /verify`, and `POST /settle` and are documented at [blocky402.com/docs](https://blocky402.com/docs/) ([quickstart](https://blocky402.com/docs/quickstart/), [API reference](https://blocky402.com/docs/api-reference/), [networks](https://blocky402.com/docs/networks/)).
Both expose the standard endpoints (`GET /supported`, `POST /verify`, and `POST /settle`) and are documented at [blocky402.com/docs](https://blocky402.com/docs/) ([quickstart](https://blocky402.com/docs/quickstart/), [API reference](https://blocky402.com/docs/api-reference/), [networks](https://blocky402.com/docs/networks/)).

@theekrystallee theekrystallee left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just a couple suggestions but other than that, LGTM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants