Subzo Digital Gateway Reference

The Subzo REST API allows fintechs, credit card programs, and loyalty systems to programmatically provision OTT subscriptions and digital gift vouchers straight into cardholder experiences.

Base Production URLhttps://subzo.in/api

Authentication

Every request to Subzo endpoints must include your secret API key in the HTTP Authorization header as a Bearer token:

Authorization: Bearer sbz_live_sk_xxxxxxxxxxxxxxxx

POST

/api/provision

Trigger atomic subscription activation or reserve a FIFO vault coupon.

Request Example (curl)

curl -X POST https://subzo.in/api/provision \
  -H "Authorization: Bearer sbz_live_sk_948201948201" \
  -H "Content-Type: application/json" \
  -d '{
    "customerName": "Rahul Sharma",
    "msisdn": "+919876543210",
    "skuCode": "SKU-HOTSTAR-SUP",
    "skuName": "Disney+ Hotstar Super (Annual)",
    "amount": 865,
    "fulfillmentType": "COUPON_CODE"
  }'

Request Payload Parameters

FIELD	TYPE	REQUIRED	DESCRIPTION
skuCode	string	Required	Catalog identifier (e.g., SKU-HOTSTAR-SUP)
msisdn	string	Required	Subscriber phone number with country code (+91)
customerName	string	Optional	End-cardholder full name for order mapping
fulfillmentType	string	Required	DIRECT_API or COUPON_CODE

Response Schema (200 OK)

{ "success": true, "orderId": "ORD-49102", "partnerId": "PRT-101", "newBalance": 675180, "voucherCode": "HS-SUP-NOV-001", "fulfillmentType": "COUPON_CODE" }