Struct SubscriptionOneTimeCharge

pub struct SubscriptionOneTimeCharge<'a> { /* private fields */ }

Request builder for creating a new one-time charge for a subscription.

Implementations

impl<'a> SubscriptionOneTimeCharge<'a>

pub fn new( client: &'a Paddle, subscription_id: impl Into<SubscriptionID>, ) -> Self

pub fn effective_from(&mut self, effective_from: EffectiveFrom) -> &mut Self

When one-time charges should be billed.

pub fn items( &mut self, items: impl IntoIterator<Item = TransactionItem>, ) -> &mut Self

List of one-time charges to bill for. Only prices where the billing_cycle is null may be added.

You can charge for items that you’ve added to your catalog by passing the Paddle ID of an existing price entity, or you can charge for non-catalog items by passing a price object.

Non-catalog items can be for existing products, or you can pass a product object as part of your price to charge for a non-catalog product.

pub fn on_payment_failure( &mut self, mode: SubscriptionOnPaymentFailure, ) -> &mut Self

How Paddle should handle changes made to a subscription or its items if the payment fails during update. If omitted, defaults to prevent_change.

pub async fn send(&self) -> Result<SuccessResponse<Subscription>, Error>

Send the request to Paddle and return the response.

Trait Implementations

impl<'a> Serialize for SubscriptionOneTimeCharge<'a>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.