Enum SubscriptionBillingServiceError 

#[non_exhaustive]
pub enum SubscriptionBillingServiceError {
    Sql(Error),
    StorageTemporarilyUnavailable(Error),
    Attempt(PaymentAttemptStoreError),
    Application(SubscriptionEnrollmentApplicationError),
    HostChargeApplication(HostChargeApplicationError),
    HostChargeStore(HostChargeStoreError),
    Cancellation(SubscriptionCancellationError),
    Discount(SubscriptionDiscountOperationError),
    BillingTransaction(BillingTransactionError),
    BillingEvent(BillingEventWriteError),
    HostChargeUnavailable,
    IdempotencyConflict,
    AdmissionDenied {
        retry_after: Duration,
    },
    AdmissionTimeout,
    AdmissionUnavailable,
    GatewayConfigurationChanged,
    GatewayResolution(GatewayResolutionError),
    ResolvedGatewayIdentityMismatch,
    GatewayMutationCooldown {
        scope: GatewayMutationCooldownScope,
    },
    ReservationRejected(SubscriptionEnrollmentReservationRejection),
    SubmissionRejected(SubscriptionEnrollmentSubmissionRejection),
    HostChargeReservationRejected(HostChargeTargetRejection),
    HostChargeSubmissionRejected(HostChargeTargetRejection),
    RecoveryReservationRejected(SubscriptionRecoveryReservationRejection),
    RecoverySubmissionRejected(SubscriptionRecoverySubmissionRejection),
    RenewalReservationRejected(SubscriptionRenewalReservationRejection),
    PaymentMethodReplacementReservationRejected(SubscriptionPaymentMethodReplacementRejection),
    PaymentMethodReplacementSubmissionRejected(SubscriptionPaymentMethodReplacementSubmissionRejection),
    GatewayNotSubmitted(GatewayNotSubmittedError),
    GatewayReadiness(GatewayError),
    InvalidState(&'static str),
}

Failure returned by the high-level subscription billing facade.

This covers subscriber-owned enrollment, recovery, renewal, payment-method replacement, cancellation, discount mutations, reconciliation, and the optional host-charge capability.

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.

Sql(Error)

Generic SQL failure whose retry safety is not proven by the owning path.

StorageTemporarilyUnavailable(Error)

A provider-free local transaction could not acquire capacity or failed with an explicitly recognized transient SQLSTATE. Replaying the same idempotent operation after the failed transaction is discarded is safe.

Attempt(PaymentAttemptStoreError)

Canonical payment-attempt persistence failed.

Application(SubscriptionEnrollmentApplicationError)

A subscription payment outcome could not be applied atomically.

HostChargeApplication(HostChargeApplicationError)

A host-charge outcome could not be applied atomically.

HostChargeStore(HostChargeStoreError)

Canonical host-charge reservation or ledger storage failed.

Cancellation(SubscriptionCancellationError)

Subscriber cancellation failed.

Discount(SubscriptionDiscountOperationError)

Subscriber discount mutation failed.

BillingTransaction(BillingTransactionError)

The host-prepared billing transaction failed.

BillingEvent(BillingEventWriteError)

The typed event could not be appended to the host outbox.

HostChargeUnavailable

The optional host-charge target capability was not supplied.

IdempotencyConflict

The idempotency key already owns a different immutable request.

AdmissionDenied

Host admission denied the command with an exact retry delay.

Fields

retry_after: Duration

Exact delay supplied by the host admission implementation.

AdmissionTimeout

Host admission did not complete before its bound.

AdmissionUnavailable

Host admission could not evaluate the command.

GatewayConfigurationChanged

Durable gateway authority changed after the command was prepared.

GatewayResolution(GatewayResolutionError)

The host could not resolve canonical gateway authority.

ResolvedGatewayIdentityMismatch

The resolver returned a gateway for a different canonical identity.

GatewayMutationCooldown

A durable account or provider cooldown stopped submission.

Fields

scope: GatewayMutationCooldownScope

Canonical cooldown level that stopped the command.

ReservationRejected(SubscriptionEnrollmentReservationRejection)

Initial-enrollment reservation returned a semantic blocker.

SubmissionRejected(SubscriptionEnrollmentSubmissionRejection)

Initial-enrollment final admission returned a semantic blocker.

HostChargeReservationRejected(HostChargeTargetRejection)

Host-charge reservation returned a semantic blocker.

HostChargeSubmissionRejected(HostChargeTargetRejection)

Host-charge final admission returned a semantic blocker.

RecoveryReservationRejected(SubscriptionRecoveryReservationRejection)

Subscriber recovery reservation returned a semantic blocker.

RecoverySubmissionRejected(SubscriptionRecoverySubmissionRejection)

Subscriber recovery final admission returned a semantic blocker.

RenewalReservationRejected(SubscriptionRenewalReservationRejection)

Automatic-renewal reservation returned a semantic blocker.

PaymentMethodReplacementReservationRejected(SubscriptionPaymentMethodReplacementRejection)

Payment-method replacement reservation returned a semantic blocker.

PaymentMethodReplacementSubmissionRejected(SubscriptionPaymentMethodReplacementSubmissionRejection)

Payment-method replacement final admission returned a semantic blocker.

GatewayNotSubmitted(GatewayNotSubmittedError)

Gateway adaptation proved that the mutation was not submitted.

GatewayReadiness(GatewayError)

The gateway readiness query failed before mutation submission.

This error does not by itself prove that no durable attempt exists. If readiness fails after reservation, transient unavailability leaves the prepared attempt retryable, while a determinate readiness failure may terminalize it with an exact resolution code before returning this error. Replaying the same command and idempotency key recovers that canonical result before admission, resolution, or provider I/O.

InvalidState(&'static str)

Durable canonical state violated an invariant required by the facade.

Implementations

impl SubscriptionBillingServiceError

pub const fn disposition(&self) -> SubscriptionBillingServiceErrorDisposition

Returns the stable, conservative operational category for this error.

The category intentionally does not expose provider diagnostics, payment values, or durable identifiers.

pub const fn is_retryable(&self) -> bool

Returns whether it is safe to resubmit the same idempotent command.

A true result means only that Syrup Rail can safely accept another submission of that unchanged command and idempotency key. It does not promise that the next call will perform another payment; it may return a canonical terminal result. Do not create a new command or idempotency key merely because this returns true. Inspect the canonical result before deciding whether a later payment needs a newly issued key.

pub const fn is_conflict(&self) -> bool

Returns whether the command conflicts with an existing idempotency or authority snapshot.

Conflicts are not retryable as-is; reload current authority or reconcile the existing idempotency key before constructing another command.

pub const fn retry_after(&self) -> Option<Duration>

Returns an exact retry delay when the service was given one.

None does not imply that the error is non-retryable. For example, gateway/account cooldowns are temporarily unavailable but do not carry an exact delay that this API can safely fabricate.

Trait Implementations

impl Debug for SubscriptionBillingServiceError

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

Formats the value using the given formatter.

impl Display for SubscriptionBillingServiceError

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

Formats the value using the given formatter.

impl Error for SubscriptionBillingServiceError

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.

impl From<BillingEventWriteError> for SubscriptionBillingServiceError

fn from(source: BillingEventWriteError) -> Self

Converts to this type from the input type.

impl From<BillingTransactionError> for SubscriptionBillingServiceError

fn from(source: BillingTransactionError) -> Self

Converts to this type from the input type.

impl From<Error> for SubscriptionBillingServiceError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<GatewayResolutionError> for SubscriptionBillingServiceError

fn from(source: GatewayResolutionError) -> Self

Converts to this type from the input type.

impl From<HostChargeApplicationError> for SubscriptionBillingServiceError

fn from(source: HostChargeApplicationError) -> Self

Converts to this type from the input type.

impl From<HostChargeStoreError> for SubscriptionBillingServiceError

fn from(source: HostChargeStoreError) -> Self

Converts to this type from the input type.

impl From<PaymentAttemptStoreError> for SubscriptionBillingServiceError

fn from(source: PaymentAttemptStoreError) -> Self

Converts to this type from the input type.

impl From<SubscriptionCancellationError> for SubscriptionBillingServiceError

fn from(error: SubscriptionCancellationError) -> Self

Converts to this type from the input type.

impl From<SubscriptionDiscountOperationError> for SubscriptionBillingServiceError

fn from(error: SubscriptionDiscountOperationError) -> Self

Converts to this type from the input type.

impl From<SubscriptionEnrollmentApplicationError> for SubscriptionBillingServiceError

fn from(source: SubscriptionEnrollmentApplicationError) -> Self

Converts to this type from the input type.