Skip to main content

Recurring Fixed Fee Pricing

Preview Feature

Recurring Fixed Fee Pricing is currently in preview. Please contact our support team for access.

With Recurring Fixed Fee Pricing you can charge your customers a fixed rate for access to your products or services on a recurring basis. This is ideal for SaaS products with tiered plans, monthly memberships, or any service with predictable recurring charges.

When you subscribe a customer to a product with fixed fee pricing, Credyt automatically handles the billing cycle, invoicing, and payment collection according to the configuration you specify.

Creating a Monthly Fixed Fee Product​

API Reference

Before you can subscribe your customers, you need to create products with fixed fee prices. Products are created via the Products API.

Example​

In this example we create a new product glitch_pro that costs $20.00/month and requires payment upfront.

POST https://api.credyt.ai/products
{
  "name": "Glitch Pro Subscription",
  "code": "glitch_pro",
  "prices": [
    {
      "name": "Monthly Subscription",
      "type": "fixed",
      "billing_model": {
        "type": "recurring",
        "recurring": {
          "interval": "month"
        }
      },
      "pricing": [
        {
          "asset": "USD",
          "values": [
            {
              "unit_price": 20.0
            }
          ]
        }
      ]
    }
  ],
  "publish": true
}

Subscribing Customers​

API Reference

Once you've created your fixed fee product, you can subscribe customers by referencing this product code when creating the customer:

POST https://api.credyt.ai/customers
{
  "name": "John Doe",
  "external_id": "18991",
  "email": "j.doe@gmail.com",
  "subscriptions": [
    {
      "products": [
        {
          "code": "glitch_pro"
        }
      ]
    }
  ]
}

Response:

{
  "id": "cust_473cr1y0ghbyc3m1yfbwvn3nxx",
  "subscriptions": [
    {
      "id": "sub_411xhg4kqakf3d8ybezbzta558",
      "status": "pending",
      "products": [
        {
          "id": "prp_4e28n8kk41931f5yt5em49ecw7",
          "code": "glitch_pro",
          "version": "default"
        }
      ],
      "required_actions": [
        {
          "type": "payment",
          "redirect_url": "https://billing.credyt.ai/api/..."
        }
      ]
    }
  ]
}

When a subscription requires further action before it can be activated, such as collecting an initial payment, its status will be set to pending and it will contain one or more actions in the required_actions array.

When payment is required there will be a required action of type: payment with a corresponding redirect_url you should redirect your customer to.

This will typically be a link to the Billing Portal where your customer will be prompted to complete payment.

Webhook Notifications​

To receive a notification when the customer has completed the required actions, subscribe to the subscription.activated webhook.