Skip to main content
Subscriptions enable automatic payment collection on a recurring schedule. They are created through the Payment Sessions API when subscription_options are passed during a first_in_series payment session. When the first payment succeeds, it acts as an authorisation and sets up the underlying mandates required for future charges. The subscription is then automatically activated and payments are collected according to the recurrence parameters defined at setup.

​
How it works

  1. Create a first_in_series payment session with subscription_options including the recurrence configuration.
  2. The customer completes the first payment, authorising future charges.
  3. Moment sets up the required mandates and activates the subscription.
  4. Subsequent payments are collected automatically on the schedule defined by the recurrence parameters.

​
Webhooks

The Subscriptions API emits events to notify you of changes to a subscription’s lifecycle.
EventDescription
subscription.createdFired when a subscription is created and activated after a successful first payment.
subscription.endedFired when a subscription reaches its end date and all scheduled payments have been collected.
subscription.cancelledFired when a subscription is cancelled before reaching its end date.