Defining Subscription Plan Details

Learn how to configure subscription plans with the right pricing, billing frequency, and settlement options.

Overview

Subscription plans are the foundation of your subscription service. They define how customers will be billed, what they’ll pay, and how you’ll receive the funds. Properly configuring your plans ensures smooth recurring billing and accurate settlement.

Create subscription plan in merchant dashboard

Plan Fields Reference

Required Fields

Field	Type	Description
Name	string	The short description of the plan
Code	string	The unique identifier of the plan (no spaces)
Interval	enum	The frequency of billing (Monthly / Yearly)
Amount	object	The base amount to be billed every interval

Optional Fields

Field	Type	Description
Description	string	A explanation of the details of the plan
Duration	number	The number of intervals the subscription will run until expiration. For example, if the frequency is monthly and the duration is 12, the subscription will expire after a year
Transaction	object	Solana Only - the on-chain transaction to be used for the payments
Settlement Type	enum	How you receive funds: USDC, EUROe, or Fiat

Creating a Plan via API

1 // API Reference: /api-reference/api-reference/merchant-subscription/create-plan
2 
3 const response = await fetch(
4   'https://api-sandbox.coinflow.cash/api/merchant/subscription/plans',
5   {
6     method: 'POST',
7     headers: {
8       'Authorization': 'YOUR_API_KEY',
9       'Content-Type': 'application/json'
10     },
11     body: JSON.stringify({
12       name: 'Premium Monthly Plan',
13       code: 'premium-monthly',
14       description: 'Access to all premium features with monthly billing',
15       interval: 'Monthly',
16       duration: null,
17       amount: {
18         currency: 'USD',
19         cents: 2999
20       },
21       settlementType: 'USDC'
22     })
23   }
24 );
25 
26 const plan = await response.json();

Best Practices

Plan Naming

Keep names short and descriptive
Include billing frequency for clarity
Use customer-friendly language

Plan Codes

Use lowercase with hyphens (e.g., premium-monthly)
Make it URL-safe
Keep it memorable for developers

Pricing

Use psychological pricing (.99 endings)
Consider offering both monthly and yearly options
Yearly plans typically offer 15-20% discount

Settlement Types

Choose based on your business needs:

USDC/EUROe: Best for crypto-native businesses
Fiat: Best for traditional businesses with simpler accounting

1	// API Reference: /api-reference/api-reference/merchant-subscription/create-plan
2
3	const response = await fetch(
4	'https://api-sandbox.coinflow.cash/api/merchant/subscription/plans',
5	{
6	method: 'POST',
7	headers: {
8	'Authorization': 'YOUR_API_KEY',
9	'Content-Type': 'application/json'
10	},
11	body: JSON.stringify({
12	name: 'Premium Monthly Plan',
13	code: 'premium-monthly',
14	description: 'Access to all premium features with monthly billing',
15	interval: 'Monthly',
16	duration: null,
17	amount: {
18	currency: 'USD',
19	cents: 2999
20	},
21	settlementType: 'USDC'
22	})
23	}
24	);
25
26	const plan = await response.json();

Overview

Plan Fields Reference

Required Fields

Optional Fields

Creating a Plan via API

Best Practices

Plan Naming

Plan Codes

Pricing

Settlement Types

Related Resources

Overview

Plan Fields Reference

Required Fields

Optional Fields

Creating a Plan via API

Best Practices

Plan Naming

Plan Codes

Pricing

Settlement Types

Related Resources