Create Subscription Plan

Creates a new subscription plan under the merchant's company account. Plans define the price, currency, items, and renewal interval that will apply to attached subscribers.

A freshly created plan has no subscribers and no billing activity. Use Add Subscribers to start onboarding clients onto the plan.

Two date fields in the response:

expiresAt — payment deadline for the current invoice: 7 days after it is issued (e.g. issued 2026-07-01 → expiresAt 2026-07-08). An unpaid invoice becomes expired after this date.
nextBillingAt — stays null until a subscriber's payment is received. It is then set to payment date + billing period − 4 days — the date the next renewal invoice is generated.

POST/api/subscriptionsAuth: Required

Request Body

namestringRequired

Subscription plan name.

intervalCountnumberRequired

Renewal period interval counter. Allowed range: 1–3650.

intervalUnitstringRequired

Renewal period interval unit. One of: day, week, month, year.

invoiceCurrencystringRequired

Items price currency. Can be eur, usd, or a crypto asset (usdt, usdc, btc, eth, ton, sol, bnb, bch, ltc, trx).

itemsarrayRequired

Provided items and their prices.

More attributes

POST/api/subscriptions

curl -X POST 'https://my.solopayment.com/api/subscriptions' \
  -H 'Authorization: Bearer YOUR_PUBLIC_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '<body>'

BODY

{
  "name": "Monthly plan",
  "intervalCount": 1,
  "intervalUnit": "month",
  "invoiceCurrency": "eur",
  "items": [
    { "name": "Account_access", "price": 100 }
  ],
  "paymentCurrency": "usdt",
  "isMerchantPaysFee": false,
  "redirectURL": "https://example.com/thanks"
}

EXAMPLE RESPONSE

{
  "id": "plan-uuid",
  "status": "active",
  "name": "Monthly plan",
  "createdAt": "2026-05-29T10:00:00.000Z",
  "expiresAt": "2026-06-05T10:00:00.000Z",
  "nextBillingAt": null,
  "billing": {
    "intervalCount": 1,
    "intervalUnit": "month"
  },
  "invoiceContent": {
    "invoiceCurrency": "eur",
    "items": [{ "name": "Account_access", "price": "100.00" }],
    "paymentCurrency": null,
    "isMerchantPaysFee": false,
    "invoiceAmount": "100.00"
  },
  "revenue": "0.00",
  "redirectURL": "https://example.com/thanks"
}

Request Body​

Request Body