CreateX402HandlerParams

Defined in: src/x402/server.ts:82

Parameters for createX402Handler.

Properties

facilitator

readonly facilitator: Facilitator

Defined in: src/x402/server.ts:84

Facilitator that performs verify and settle (self or HTTP-proxied).

---

handler

readonly handler: X402InnerHandler

Defined in: src/x402/server.ts:99

The protected business-logic handler. Invoked after settlement.

---

hooks?

readonly optional hooks?: ObservabilityHooks

Defined in: src/x402/server.ts:111

Optional observability callbacks. The handler emits onPaymentRequired each time it returns a 402, and onPaymentAccepted after a settled payment unlocks the inner handler. Hooks are fire-and-forget — see ObservabilityHooks.

---

requirementsFor

readonly requirementsFor: (request) => readonly X402PaymentRequirements[] | Promise<readonly X402PaymentRequirements[] | null> | null

Defined in: src/x402/server.ts:92

Returns the X402PaymentRequirements that apply to this request.

• Return one or more entries to require payment (client picks one).
• Return null or [] to skip the payment flow entirely for this request — the inner handler is invoked with context = null.

Parameters

request

Request

Returns

readonly X402PaymentRequirements[] | Promise<readonly X402PaymentRequirements[] | null> | null

---

resourceFor?

readonly optional resourceFor?: (request) => X402ResourceInfo | Promise<X402ResourceInfo>

Defined in: src/x402/server.ts:104

Optional builder for the X402ResourceInfo echoed in the 402 response. Defaults to { url: request.url }.

Parameters

request

Request

Returns

X402ResourceInfo | Promise<X402ResourceInfo>