Money.Subscription.Plan (Money v5.5.3) View Source

Defines a standard subscription plan data structure.

Link to this section Summary

Types

A plan interval type.

A integer interval count for a plan.

t()

A Subscription Plan

Functions

Defines the structure of a subscription plan.

Returns {:ok, Money.Subscription.Plan.t} or an {:error, reason} tuple.

Returns {:ok, Money.Subscription.Plan.t} or raises an exception.

Link to this section Types

Specs

interval() :: :day | :week | :month | :year

A plan interval type.

Specs

interval_count() :: non_neg_integer()

A integer interval count for a plan.

Specs

t() :: %Money.Subscription.Plan{
  interval: interval(),
  interval_count: interval_count(),
  price: Money.t() | nil
}

A Subscription Plan

Link to this section Functions

Link to this function

%Money.Subscription.Plan{}

View Source (struct)

Defines the structure of a subscription plan.

Link to this function

new(price, interval, interval_count \\ 1)

View Source

Specs

new(Money.t(), interval(), interval_count()) ::
  {:ok, t()} | {:error, {module(), String.t()}}

Returns {:ok, Money.Subscription.Plan.t} or an {:error, reason} tuple.

Arguments

  • :price is any Money.t

  • :interval is the period of the plan. The valid intervals are :day,:week,:monthor ':year.

  • :interval_count is an integer count of the number of :intervals of the plan. The default is 1

Returns

A Money.Subscription.Plan.t

Examples

iex> Money.Subscription.Plan.new Money.new(:USD, 100), :month, 1
{:ok,
 %Money.Subscription.Plan{
   interval: :month,
   interval_count: 1,
   price: Money.new(:USD, 100)
 }}

iex> Money.Subscription.Plan.new Money.new(:USD, 100), :month
{:ok,
 %Money.Subscription.Plan{
   interval: :month,
   interval_count: 1,
   price: Money.new(:USD, 100)
 }}

iex> Money.Subscription.Plan.new Money.new(:USD, 100), :day, 30
{:ok,
 %Money.Subscription.Plan{
   interval: :day,
   interval_count: 30,
   price: Money.new(:USD, 100)
 }}

iex> Money.Subscription.Plan.new 23, :day, 30
{:error, {Money.Invalid, "Invalid subscription plan definition"}}
Link to this function

new!(price, interval, interval_count \\ 1)

View Source

Specs

new!(Money.t(), interval(), interval_count()) :: t() | no_return()

Returns {:ok, Money.Subscription.Plan.t} or raises an exception.

Takes the same arguments as Money.Subscription.Plan.new/3.

Example

iex> Money.Subscription.Plan.new! Money.new(:USD, 100), :day, 30
%Money.Subscription.Plan{
  interval: :day,
  interval_count: 30,
  price: Money.new(:USD, 100)
}