Struct FakePayments 

pub struct FakePayments { /* private fields */ }

An in-memory cratefield_core::Payments for module tests: records which calls were made and answers per its PaymentsMode. verify_webhook treats a signature header of "invalid" as a tampered event.

Implementations

impl FakePayments

pub fn new(mode: PaymentsMode) -> Self

pub fn calls(&self) -> Vec<PaymentsCall>

The calls recorded so far.

pub fn set_mode(&self, mode: PaymentsMode)

Trait Implementations

impl Clone for FakePayments

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for FakePayments

fn default() -> Self

Returns the “default value” for a type.

impl Payments for FakePayments

fn create_checkout<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 CheckoutRequest, ) -> Pin<Box<dyn Future<Output = Result<CheckoutSession, PaymentsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

A one-time hosted checkout. Returns the URL to redirect the browser to.

fn create_subscription_checkout<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 SubscriptionCheckoutRequest, ) -> Pin<Box<dyn Future<Output = Result<CheckoutSession, PaymentsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

A recurring hosted checkout against a configured Stripe Price.

fn create_connect_account_link<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 ConnectAccountLinkRequest, ) -> Pin<Box<dyn Future<Output = Result<ConnectAccountLink, PaymentsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

A Connect onboarding link for a coach’s account.

fn charge_with_transfer<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 TransferCharge, ) -> Pin<Box<dyn Future<Output = Result<Charge, PaymentsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

A destination charge with an application fee (the platform’s cut).

fn refund<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 RefundRequest, ) -> Pin<Box<dyn Future<Output = Result<Refund, PaymentsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Refunds a prior payment, in whole or in part.

fn verify_webhook<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, signature_header: &'life1 str, _body: &'life2 [u8], ) -> Pin<Box<dyn Future<Output = Result<WebhookEvent, PaymentsError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Verifies a webhook’s signature and timestamp and returns the event. signature_header is the raw Stripe-Signature header; body is the exact bytes received (verification is over the raw body). Returns PaymentsError::SignatureInvalid if verification fails.

fn report_usage<'life0, 'life1, 'async_trait>( &'life0 self, _report: &'life1 UsageReport, ) -> Pin<Box<dyn Future<Output = Result<UsageReported, PaymentsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Reports a metered usage amount to the billing provider (Stripe Billing Meters) idempotently: the UsageReport::identifier makes a repeated report a no-op at the provider, so retrying is safe and a second report of the same window comes back as UsageReported::already_reported rather than an error.

fn verify_webhook_request<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, headers: &'life1 HeaderMap, body: &'life2 [u8], ) -> Pin<Box<dyn Future<Output = Result<WebhookEvent, PaymentsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Verifies a webhook from its request headers and raw body. It exists because some providers sign over more than one header: Standard Webhooks (Polar, Svix) sends webhook-id, webhook-timestamp and webhook-signature, which one signature_header string cannot carry. A handler that calls this instead of verify_webhook stays the same whichever adapter is composed in.

fn create_portal_session<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 PortalSessionRequest, ) -> Pin<Box<dyn Future<Output = Result<PortalSession, PaymentsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

A hosted customer-portal session (issue #589). The default reports PaymentsError::Unsupported.

fn get_subscription<'life0, 'life1, 'async_trait>( &'life0 self, _subscription_ref: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Subscription, PaymentsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Reads one subscription by its provider id (issue #589): the lookup a billing module makes when a webhook was missed, arrived out of order, or left the module unsure of the current state. The default reports PaymentsError::Unsupported.

fn list_subscriptions<'life0, 'life1, 'async_trait>( &'life0 self, _customer_ref: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<Subscription>, PaymentsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Lists a customer’s subscriptions (issue #589): the poll a venture runs to reconcile what a webhook stream missed, including canceled subscriptions where the provider would otherwise hide them. The default reports PaymentsError::Unsupported.

fn get_dispute<'life0, 'life1, 'async_trait>( &'life0 self, _dispute_ref: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Dispute, PaymentsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Reads one dispute (issue #602). The default reports PaymentsError::Unsupported.

fn list_disputes<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 DisputeListRequest, ) -> Pin<Box<dyn Future<Output = Result<DisputePage, PaymentsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Lists disputes, newest first: the poll a venture runs on a schedule when its provider sends no dispute webhooks (Polar), or to reconcile missed ones. Dedup each result through Dispute::event_key. The default reports PaymentsError::Unsupported.

fn close_dispute<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _dispute_ref: &'life1 str, _idempotency_key: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Dispute, PaymentsError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Accepts a dispute, conceding the chargeback, which settles it as lost (issue #602). The default reports PaymentsError::Unsupported.