Enum PaymentError 

#[non_exhaustive]
pub enum PaymentError {
    NotFound(Uuid),
    Declined {
        reason: String,
    },
    RefundFailed {
        reason: String,
    },
    CurrencyMismatch {
        expected: String,
        got: String,
    },
    InvalidTransition(StateTransitionError<String>),
    Other(Box<dyn Error + Send + Sync>),
}

Errors specific to payment operations.

Example

use stateset_core::errors::PaymentError;

let err = PaymentError::not_found(uuid::Uuid::nil());
assert!(err.to_string().contains("not found"));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotFound(Uuid)

Payment with the given ID was not found.

Declined

Payment was declined by the processor.

Fields

reason: String

The decline reason from the processor.

RefundFailed

Refund cannot be processed.

Fields

reason: String

The reason the refund failed.

CurrencyMismatch

Currency mismatch between payment and order.

Fields

expected: String

The expected currency code.

got: String

The actual currency code provided.

InvalidTransition(StateTransitionError<String>)

Invalid status transition for a payment.

Other(Box<dyn Error + Send + Sync>)

Extensibility.

Implementations

impl PaymentError

pub const fn not_found(id: Uuid) -> Self

Convenience constructor for NotFound.

pub fn declined(reason: impl Into<String>) -> Self

Convenience constructor for Declined.

pub fn refund_failed(reason: impl Into<String>) -> Self

Convenience constructor for RefundFailed.

pub fn currency_mismatch( expected: impl Into<String>, got: impl Into<String>, ) -> Self

Convenience constructor for CurrencyMismatch.

pub fn invalid_transition(from: impl Display, to: impl Display) -> Self

Convenience constructor for InvalidTransition.

Trait Implementations

impl Debug for PaymentError

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

Formats the value using the given formatter.

impl Display for PaymentError

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

Formats the value using the given formatter.

impl Error for PaymentError

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 #99301)

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

impl From<PaymentError> for CommerceError

fn from(source: PaymentError) -> Self

Converts to this type from the input type.