Create subscription

Developing

POST

https://pay.bottercc.com/api/v1/subscription

Create a recurring subscription mandate session. Supports upfront trial tokenization (e.g., Pay ₹1 today, ₹199/month starting next month), flexible billing intervals, and auto-renewals.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "plan_name": "Pro Membership",
    "client_subid": "SUB_1001",
    "initial_amount": 1.00,
    "recurring_amount": 199.00,
    "interval_type": "monthly",
    "total_cycles": 12,
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone": "9876543210",
    "webhook_url": "https://yoursite.com/api/webhook"
  }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://pay.bottercc.com/api/v1/subscription' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "plan_name": "Pro Membership",
    "client_subid": "SUB_1001",
    "initial_amount": 1.00,
    "recurring_amount": 199.00,
    "interval_type": "monthly",
    "total_cycles": 12,
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone": "9876543210",
    "webhook_url": "https://yoursite.com/api/webhook"
  }'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
  "success": true,
  "sub_id": "sub_4fa9921b34e2c",
  "client_subid": "SUB_1001",
  "plan_name": "Pro Membership",
  "pricing": {
    "initial_amount": "1.00",
    "recurring_amount": "199.00",
    "currency": "INR",
    "interval": "monthly",
    "total_cycles": 12
  },
  "status": "pending_auth",
  "auth_url": "http://localhost:3000/pay/sub/sub_4fa9921b34e2c",
  "next_billing_at": "2026-09-20T08:00:00.000Z"
}

Modified at 2026-08-20 04:12:05

Payout status

subscription status