Create Subscription (Initiate)

POST

/partner-dcb/v1/subscriptions

Request

Authorization

API Key

Add parameter in header

X-Signature

Example:

X-Signature: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Accepted (async processing)

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/partner-dcb/v1/subscriptions' \
--header 'X-Partner-Id;' \
--header 'X-Api-Key;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "msisdn": "6287000000000",
  "product_id": "XL_SUBS_MIA1K",
  "partner_ref_id": "84909a1e-3b8d-4214-877a-cd2c09e218ad",
  "amount": 1110,
  "payment_method": "XL"
}'

Response Example

{
    "success": true,
    "correlation_id": "80030735-0005-2700-b63f-84710c7967bb",
    "code": "REQUEST_INITIATED",
    "message": "Request initiated",
    "data": {
        "transaction_id": "4c2821dc-61be-42a8-b211-baa65b845380",
        "partner_ref_id": "84909a1e-3b8d-4214-877a-cd2c09e218ad"
    }
}

Modified at 2026-05-13 04:05:48

Notes (Partner Guidance)

Confirm OTP