Struct PaymentMiddleware 

pub struct PaymentMiddleware {
    pub config: Arc<PaymentMiddlewareConfig>,
    pub facilitator: Option<FacilitatorClient>,
    pub template_config: Option<PaywallConfig>,
}

Axum middleware for x402 payments

Fields

config: Arc<PaymentMiddlewareConfig>

facilitator: Option<FacilitatorClient>

template_config: Option<PaywallConfig>

Implementations

impl PaymentMiddleware

pub fn new(amount: Decimal, pay_to: impl Into<String>) -> Self

Create a new payment middleware

pub fn with_description(self, description: impl Into<String>) -> Self

Set the payment description

pub fn with_mime_type(self, mime_type: impl Into<String>) -> Self

Set the MIME type

pub fn with_max_timeout_seconds(self, max_timeout_seconds: u32) -> Self

Set the maximum timeout

pub fn with_output_schema(self, output_schema: Value) -> Self

Set the output schema

pub fn with_facilitator_config( self, facilitator_config: FacilitatorConfig, ) -> Self

Set the facilitator configuration

pub fn with_testnet(self, testnet: bool) -> Self

Set whether this is a testnet

pub fn with_custom_paywall_html(self, html: impl Into<String>) -> Self

Set custom paywall HTML

pub fn with_resource(self, resource: impl Into<String>) -> Self

Set the resource URL

pub fn with_resource_root_url(self, url: impl Into<String>) -> Self

Set the resource root URL

pub fn config(&self) -> &PaymentMiddlewareConfig

Get the middleware configuration

pub fn with_facilitator(self, facilitator: FacilitatorClient) -> Self

Set the facilitator client

pub fn with_template_config(self, template_config: PaywallConfig) -> Self

Set the template configuration

pub async fn verify(&self, payment_payload: &PaymentPayload) -> bool

Verify a payment payload

pub async fn settle( &self, payment_payload: &PaymentPayload, ) -> Result<SettleResponse>

Settle a payment

pub async fn verify_with_requirements( &self, payment_payload: &PaymentPayload, requirements: &PaymentRequirements, ) -> Result<bool>

Verify payment with specific requirements

pub async fn settle_with_requirements( &self, payment_payload: &PaymentPayload, requirements: &PaymentRequirements, ) -> Result<SettleResponse>

Settle payment with specific requirements

pub async fn process_payment( &self, request: Request, next: Next, ) -> Result<PaymentResult>

Process payment with unified flow

Trait Implementations

impl Clone for PaymentMiddleware

fn clone(&self) -> PaymentMiddleware

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PaymentMiddleware

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

Formats the value using the given formatter.