Enum PaygateError 

pub enum PaygateError {
    PaymentHeaderMissing,
    InvalidPaymentHeader,
    NoPaymentMatching,
    VerificationFailed(String),
    Settlement(Box<SettleResponse>),
    SettlementAborted(String),
}

Available on crate feature server only.

Payment gate error encompassing header, verification, and settlement failures.

Variants

PaymentHeaderMissing

The Payment-Signature header is missing from the request.

InvalidPaymentHeader

The payment header is present but malformed.

NoPaymentMatching

No accepted price tag matches the payment payload.

VerificationFailed(String)

The facilitator rejected the payment.

Settlement(Box<SettleResponse>)

Facilitator returned a structured SettleResponse::Failure.

The failure body is preserved end-to-end so the paygate can emit it via the Payment-Response HTTP header per x402 v2 §HTTP transport, giving browser clients access to the machine-readable error reason.

SettlementAborted(String)

Internal error before a structured settlement response could be obtained (timeout, panic in spawned task, malformed override, etc.). Renders as a 402 with no Payment-Response header.

Trait Implementations

impl Debug for PaygateError

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

Formats the value using the given formatter.

impl Display for PaygateError

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

Formats the value using the given formatter.

impl Error for PaygateError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.