Pay with x402 on Hedera

​

Register the Hedera scheme

import { x402Client } from "@x402/core/client";
import { createClientHederaSigner } from "@x402/hedera";
import { ExactHederaScheme } from "@x402/hedera/exact/client";
import { PrivateKey } from "@hiero-ledger/sdk";

const signer = createClientHederaSigner(
  "0.0.1111",
  PrivateKey.fromString(process.env.HEDERA_PRIVATE_KEY!),
  { network: "hedera:testnet" }
);

// Register the scheme for any Hedera network and let the client
// auto-handle 402 responses by signing and retrying.
const client = new x402Client().register(
  "hedera:*",
  new ExactHederaScheme(signer)
);

​

Make a paid request

1. The client calls the resource (for example, GET /weather) without any extra headers.
2. The server replies with 402 Payment Required and the PaymentRequirements, including the facilitator feePayer.
3. The client builds, signs, and Base64-encodes a TransferTransaction to the payTo account.
4. The client resubmits the request with the PaymentPayload in the X-Payment header (or equivalent).

​

Requirements

• The client account must hold the asset being paid (HBAR or the relevant HTS token).
• For HTS tokens, the client account must be associated with that token.
• Use a facilitator that advertises the Hedera network you are paying on.

​

Further reading