Struct Paygate 

pub struct Paygate<TFacilitator> { /* private fields */ }

Available on crate feature server only.

V2-only payment gate for enforcing x402 payments.

Handles the full payment lifecycle: header extraction, verification, settlement, and 402 response generation using the V2 wire format.

Construct via PaygateBuilder (obtained from Paygate::builder).

To add lifecycle hooks (before/after verify and settle), wrap your facilitator with HookedFacilitator before passing it to the payment gate.

Implementations

impl<TFacilitator> Paygate<TFacilitator>

pub const fn builder(facilitator: TFacilitator) -> PaygateBuilder<TFacilitator>

Returns a new builder seeded with the given facilitator.

pub fn accepts(&self) -> &[PriceTag]

Returns a reference to the accepted price tags.

pub const fn resource(&self) -> &ResourceInfo

Returns a reference to the resource information.

impl<TFacilitator> Paygate<TFacilitator>

where TFacilitator: Facilitator + Sync,

pub async fn handle_request<ReqBody, ResBody, S: Service<Request<ReqBody>, Response = Response<ResBody>>>( self, inner: S, req: Request<ReqBody>, ) -> Result<Response, Infallible>

where S::Response: IntoResponse, S::Error: IntoResponse, S::Future: Send,

Handles an incoming request, processing payment if required.

Returns 402 response if payment fails. Otherwise, returns the response from the inner service.

Errors

This method is infallible (Infallible error type).

pub async fn enrich_accepts(&mut self)

Enriches price tags with facilitator capabilities (e.g., fee payer address).

pub async fn handle_request_fallible<ReqBody, ResBody, S: Service<Request<ReqBody>, Response = Response<ResBody>>>( &self, inner: S, req: Request<ReqBody>, ) -> Result<Response, PaygateError>

where S::Response: IntoResponse, S::Error: IntoResponse, S::Future: Send,

Handles an incoming request, returning errors as PaygateError.

This is the fallible version of handle_request that returns an actual error instead of turning it into 402 Payment Required response.

Errors

Returns PaygateError if payment processing fails.