Struct PaymentClient 

pub struct PaymentClient<S = FirstMatch> { /* private fields */ }

V2 payment client — scheme registry + selector + policies + hooks.

Mirrors Go/TS x402Client without V1 registration paths.

Implementations

impl PaymentClient<FirstMatch>

pub fn new() -> Self

Empty client with FirstMatch selection.

impl<S> PaymentClient<S>

pub fn register(self, scheme: impl SchemeClient + 'static) -> Self

Registers a V2 scheme client.

pub fn with_selector<P: PaymentSelector>(self, selector: P) -> PaymentClient<P>

Replaces the payment selector.

pub fn with_policy(self, policy: impl PaymentPolicy + 'static) -> Self

Appends a payment policy (applied in registration order).

pub fn with_hook(self, hook: impl ClientHooks + 'static) -> Self

Registers a client lifecycle hook.

pub fn scheme_count(&self) -> usize

Number of registered scheme clients.

pub fn hook_count(&self) -> usize

Number of registered hooks.

impl<S: PaymentSelector> PaymentClient<S>

pub fn candidates( &self, payment_required: &PaymentRequired, ) -> Vec<PaymentCandidate>

Collects candidates from every registered scheme client.

pub async fn create_payment( &self, payment_required: &PaymentRequired, ) -> Result<CreatedPayment, ClientError>

Creates a signed payment payload for a 402 challenge.

Runs before/after/failure hooks around selection + signing.

Errors

Propagates selection, signing, and before-hook abort errors.

pub async fn handle_payment_response( &self, ctx: &PaymentResponseContext, ) -> PaymentResponseResult

Dispatches ClientHooks::on_payment_response for every hook.

First recovered: true wins; remaining hooks still run (instrumentation).

Trait Implementations

impl<S> Debug for PaymentClient<S>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PaymentClient<FirstMatch>

fn default() -> Self

Returns the “default value” for a type.