Create a subscription plan
api-keyx-api-key<token>Your API key: ck_test_... for test mode, ck_live_... for live. Send it with x-api-secret (or Authorization: Bearer ).
x-api-secret?stringRecommended: API secret sent over HTTPS. You may send it as Authorization: Bearer instead. If supplied, x-timestamp and x-signature are not required.
x-timestamp?stringLegacy signed mode: Unix time in milliseconds; maximum clock skew five minutes.
x-signature?stringLegacy signed mode: HMAC-SHA256(secret, timestamp.METHOD.url.idempotencyKey.bodyHash).
x-idempotency-key*string1–128 letters/digits or ._:-. Same key and payload replay for 24 hours; conflicting, in-flight, or expired keys return 409. Never change a key to retry an uncertain payment.
application/json- body
name*stringlength <= 120description?stringlength <= 5000amountMinor*stringPositive integer minor units.
currency?string"NGN"billingCycle*string"WEEKLY""MONTHLY""QUARTERLY""BIANNUALLY""ANNUALLY"features?array<string>What's included, shown on the subscribe page. Start with "Everything in Basic" to build on a cheaper plan.
items <= 8highlight?stringOptional badge on the subscribe page. Empty to remove.
length <= 24application/json- response
id*stringenvironment*string"SANDBOX""LIVE"name*stringdescription*string|nullamountMinor*stringcurrency*stringbillingCycle*string"WEEKLY""MONTHLY""QUARTERLY""BIANNUALLY""ANNUALLY"status*string"ACTIVE""ARCHIVED"features*array<string>What's included (up to 8 lines).
highlight*|Badge on the subscribe page.
subscriptionId*|The subscription offering this plan.
position*numberDisplay order within the subscription.
createdAt*stringupdatedAt*stringcurl -X POST 'https://api.creddot.com/api/v1/subscription-plans' \ -H 'x-idempotency-key: string' \ -H 'Content-Type: application/json' \ -d '{ "name": "Business Pro", "amountMinor": "2000000", "billingCycle": "MONTHLY"}'{ "id": "string", "environment": "SANDBOX", "name": "string", "description": "string", "amountMinor": "string", "currency": "string", "billingCycle": "WEEKLY", "status": "ACTIVE", "features": [ "string" ], "highlight": "string", "subscriptionId": "string", "position": 0, "createdAt": "string", "updatedAt": "string"}