Packages
stripity_stripe
2.0.0-alpha.1
3.3.2
3.3.1
3.2.0
3.1.1
3.1.0
3.0.0
2.17.3
2.17.2
2.17.1
2.17.0
2.16.0
2.15.1
2.15.0
2.14.1
2.14.0
2.13.0
2.12.1
2.12.0
2.11.0
2.10.0
2.9.0
2.8.0
2.7.2
2.7.1
2.7.0
2.6.0
2.5.0
2.4.0
2.3.0
2.2.3
2.2.2
2.2.1
2.2.0
2.1.0
2.0.1
2.0.0
2.0.0-alpha.11
2.0.0-alpha.10
2.0.0-alpha.9
2.0.0-alpha.8
2.0.0-alpha.7
2.0.0-alpha.6
2.0.0-alpha.5
2.0.0-alpha.4
2.0.0-alpha.3
2.0.0-alpha.2
2.0.0-alpha.1
1.6.2
1.6.1
1.6.0
1.4.0
1.3.0
1.2.0
1.1.0
0.5.0
0.4.0
0.3.0
0.2.0
A Stripe client for Elixir.
Current section
Files
Jump to
Current section
Files
lib/stripe/subscription.ex
defmodule Stripe.Subscription do
@moduledoc """
Work with Stripe subscription objects.
You can:
- Create a subscription
- Retrieve a subscription
- Update a subscription
- Delete a subscription
Stripe API reference: https://stripe.com/docs/api#subscription
"""
alias Stripe.Util
@type t :: %__MODULE__{}
@type stripe_response :: {:ok, t} | {:error, Exception.t}
@type stripe_delete_response :: :ok | {:error, Exception.t}
defstruct [
:id, :application_fee_percent, :cancel_at_period_end, :canceled_at,
:created, :current_period_end, :current_period_start, :customer,
:discount, :ended_at, :livemode, :metadata, :plan, :quantity, :source,
:start, :status, :tax_percent, :trial_end, :trial_start
]
@plural_endpoint "subscriptions"
@valid_create_keys [
:application_fee_percent, :coupon, :customer, :metadata, :plan, :quantity,
:source, :tax_percent, :trial_end
]
@valid_update_keys [
:application_fee_percent, :coupon, :metadata, :plan, :prorate,
:proration_date, :quantity, :source, :tax_percent, :trial_end
]
@doc """
Create a subscription.
"""
@spec create(t, Keyword.t) :: stripe_response
def create(subscription, opts \\ []) do
Stripe.Request.create(@plural_endpoint, subscription, @valid_create_keys, %__MODULE__{}, opts)
end
@doc """
Retrieve a subscription.
"""
@spec retrieve(binary, Keyword.t) :: stripe_response
def retrieve(id, opts \\ []) do
endpoint = @plural_endpoint <> "/" <> id
Stripe.Request.retrieve(endpoint, %__MODULE__{}, opts)
end
@doc """
Update a subscription.
Takes the `id` and a map of changes.
"""
@spec update(t, map, list) :: stripe_response
def update(id, changes, opts \\ []) do
endpoint = @plural_endpoint <> "/" <> id
Stripe.Request.update(endpoint, changes, @valid_update_keys, %__MODULE__{}, opts)
end
@doc """
Delete a subscription.
"""
@spec delete(binary, list) :: stripe_delete_response
def delete(id, opts \\ []) do
endpoint = @plural_endpoint <> "/" <> id
Stripe.Request.delete(endpoint, opts)
end
end