Init Subscription

POST

https://merchantapi-demo.bill24.io/direct_debit/subscription/init

NOTE

When customer need to subscribe biller need to call to this endpoint for init subscription and get back subscription no for use with sdk or URL for open web subscription page.

Request

Header Params

Body Params application/json

Example

{
    "subscription_ref": "DD000027",
    "redirect_url": {
        "web_url": "http://{merchant-domain}:3000",
        "deeplink_url": ""
    },
    "consumers": [
        {
            "consumer_code": "C0000001",
            "consumer_name": "នីម",
            "consumer_name_latin": "Nim",
            "additional_information": ""
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://merchantapi-demo.bill24.io/direct_debit/subscription/init' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subscription_ref": "DD000027",
    "redirect_url": {
        "web_url": "http://{merchant-domain}:3000",
        "deeplink_url": ""
    },
    "consumers": [
        {
            "consumer_code": "C0000001",
            "consumer_name": "នីម",
            "consumer_name_latin": "Nim",
            "additional_information": ""
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "000",
    "message": "success !",
    "message_kh": "ជោគជ័យ! ",
    "data": {
        "subscription_no": "12353454",
        "subscription_link": "https://demo.bill24.io:22034/checkoutv2/141C9AC362C7"
    }
}

Modified at 2025-08-14 03:39:51

Authorization

Inquiry Consumer validate