1. Subscriptions
XL DCB API for Partner
  • Getting Started
    • Introduction
    • Authentication
    • Headers
    • Recurring (Subscription)
    • On-Demand (One-Time Charge)
    • Callbacks (Webhooks)
    • Errors & Response Codes
    • Notes (Partner Guidance)
  • Subscriptions
    • Create Subscription (Initiate)
      POST
    • Confirm OTP
      POST
    • Unsubscribe
      POST
  • OnDemand
    • Create one-time charge (OTP flow)
      POST
    • Confirm OTP (execute charge)
      POST
    • Check transaction status
      GET
  1. Subscriptions

Create Subscription (Initiate)

POST
/partner-dcb/v1/subscriptions

Request

Authorization
API Key
Add parameter in header
X-Signature
Example:
X-Signature: ********************
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢202
application/json
Accepted (async processing)
Bodyapplication/json

Request 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 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
Previous
Notes (Partner Guidance)
Next
Confirm OTP
Built with