Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
  • Recurring Payment Apps
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
  • Recurring Payment Apps
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Recurring Payment Apps
  • Overview
  • Usage
  • Manage Subscriptions
  • Webhook Events
  • Change Log
  • Troubleshooting
  • APIs
    • Charge Subscription
      POST
    • Cancel Subscription
      DELETE
  1. Recurring Payment Apps

Manage Subscriptions

This section outlines the core endpoints for managing subscription-based orders through the Recurring Payments API. It explains how to initiate and process recurring payments, charge existing subscriptions, and manage their lifecycle.
These endpoints form the foundation of Salla’s recurring billing workflow, enabling seamless integration and automation within your application.
Important
Before using these endpoints, ensure your App in the Salla Partner Portal has the appropriate API scopes enabled, specifically:
Recurring Payments: subscriptions.read_write
Contact Salla Support via email or the Telegram group to enable these scopes for your App.

Payment and Subscription Creation#

When a cart includes one or more recurring items, the checkout process automatically performs the following actions:
1
Initiates a subscription creation request with the payment gateway.
2
Processes the first payment transaction.
3
Generates the initial order.
4
Emits a webhook event (subscription.created).
The subscription becomes active immediately after the first successful charge.

Charge an Existing Subscription#

You can programmatically trigger a new charge for an active subscription. Refer to the Charge a Subscription endpoint for complete endpoint details.

Process Flow#

✅ on Success
❌ On Failure
1
A new cart and order are created for the subscription items.
2
An invoice is created.
3
The payment is processed through the configured gateway.
4
A webhook event (subscription.charge.succeeded) is emitted.

Cancel a Subscription#

To stop future recurring charges, you can cancel an active subscription at any time. Refer to the Cancel a Subscription endpoint for full details. Once cancelled, a subscription cannot be reactivated. The customer must initiate a new subscription if they wish to continue service.
Modified at 2025-10-22 13:42:43
Previous
Usage
Next
Webhook Events