Struct PaygateBuilder 

pub struct PaygateBuilder { /* private fields */ }

Available on crate feature server only.

Builder for constructing a Paygate with validated configuration.

Example

let gate = Paygate::builder(facilitator)
    .accept(price_tag)
    .resource(resource_info)
    .build();

Implementations

impl PaygateBuilder

pub fn accept(self, price_tag: PriceTag) -> Self

Adds a single accepted payment option.

pub fn accepts(self, price_tags: impl IntoIterator<Item = PriceTag>) -> Self

Adds multiple accepted payment options.

pub fn resource(self, resource: ResourceInfo) -> Self

Sets the resource metadata returned in 402 responses.

pub fn hooks<H>(self, hooks: H) -> Self

where H: PaygateHooks + 'static,

Attaches PaygateHooks for pre- and post-payment extensibility (Fix-8). Stored as an Arc<dyn> so hook state can be shared across cloned middleware instances without duplication.

pub fn hooks_dyn(self, hooks: Arc<dyn DynPaygateHooks>) -> Self

Attaches hooks that are already stored behind an Arc<dyn DynPaygateHooks>.

This avoids re-wrapping when the same hook object needs to be shared between the middleware layer and the paygate it constructs.

pub fn with_resource_hook( self, hook: impl ResourceServerHooks + 'static, ) -> Self

Registers a transport-agnostic ResourceServerHooks lifecycle hook.

pub fn with_settlement_tracker( self, tracker: BackgroundSettlementTracker, ) -> Self

Attaches a BackgroundSettlementTracker so background settlement tasks register with it. Used to await in-flight settlements during graceful shutdown via Paygate::settlement_tracker + BackgroundSettlementTracker::wait_for_drain.

pub fn build(self) -> Paygate

Consumes the builder and produces a configured Paygate.

Uses empty resource info if none was provided.