Skip to main content
POST
Cable Subscription
cable is the provider ID from List Cable Providers (e.g. 2 for DSTV); cable_plan is the plan ID from List Cable Plans. iuc is the customer’s IUC / SmartCard number. Set bypass to 0 to validate the IUC inline, or 1 to skip validation after a successful Verify Smartcard call. Pass your own request-id to make the purchase idempotent and to track it later via Requery.

Authorizations

Authorization
string
header
required

Send your API key as Token <your_api_key>.

Use your live key for real transactions, or your sandbox key (sk_test_…) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add "sandbox_status": "fail" to any sandbox request to simulate a failure.

Body

application/json
cable
integer
required

Cable provider ID (from GET /api/cable-plans)

Example:

1

cable_plan
integer
required

Cable subscription plan ID

Example:

12

iuc
string
required

IUC / SmartCard number

Example:

"1234567890"

bypass
enum<integer>
required

0 = validate IUC first; 1 = skip validation (only after a successful verify call)

Available options:
0,
1
Example:

0

request-id
string

Your unique reference (idempotency key). Reuse with GET /api/requery/{reference}. Optional - one is generated if omitted.

Example:

"Cable_1234567890"

Response

200 - application/json

Result