Skip to content

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

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

docs: add official x402 facilitator and Blocky402 mainnet to x402 page#691
piotrswierzy wants to merge 3 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>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@theekrystallee this facilitator is only for testnet. We can & should add this change to the blocky402 facilitator instead, which does support mainnet.

Comment thread solutions/ai/x402.mdx Outdated

@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

Co-authored-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: Lindsay Walker <66978602+walkerlj0@users.noreply.github.com>

@walkerlj0 walkerlj0 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@theekrystallee one small change - put your suggestion on the Blocky402 facilitator, not x402, since it's only testnet

Comment thread solutions/ai/x402.mdx
---
title: "x402 Payment Standard on Hedera"
sidebarTitle: "x402 Payments"
description: "Use Hedera's official x402 payment scheme to settle HBAR and HTS token payments inside HTTP requests for apps, APIs, and AI agent transactions."

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
description: "Use Hedera's official x402 payment scheme to accept HBAR and HTS token from HTTP requests for to access apps, APIs, and AI agent transactions."

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
Contributor

Choose a reason for hiding this comment

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

@theekrystallee this facilitator is only for testnet. We can & should add this change to the blocky402 facilitator instead, which does support mainnet.

Comment thread solutions/ai/x402.mdx
### Blocky402

You can confirm Hedera support live by querying the facilitator's capabilities:
[**Blocky402**](https://blocky402.com/) is an open x402 facilitator that supports Hedera on **both testnet and mainnet**, so you can wire up x402 payments on Hedera without standing up your own infrastructure first. Both facilitators are live with **open access (no API key required)**.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
[**Blocky402**](https://blocky402.com/) is an open x402 facilitator that supports Hedera on **both testnet and mainnet**, so you can wire up x402 payments on Hedera without standing up your own infrastructure first. Both facilitators are live with **open access (no API key required)**.
[**Blocky402**](https://blocky402.com/) is an open x402 facilitator that supports Hedera on **both testnet and mainnet**, so you can wire up x402 payments on Hedera without standing up your own infrastructure first. Both facilitators are live with **open access (no API key required)**.
<Warning>
The Blockydevs mainnet facilitator settles transactions with real HBAR. Test your integration against the testnet endpoint before switching to `https://api.blocky402.com`.
</Warning>

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.

3 participants