Subscription Request

There are two channels for consumers to do self subscribe for auto direct debit service.

• Channel 1 - EDC App / Web
• Channel 2 - Mobile Banking / iBanking of partnered banks

Subscribe from EDC App / Web

From EDC App / Web consumer able to subscribe multiple consumers at the same time.

Subscription Request

EDC App / Web request subscription to bank side.

Implemented by: Partner bank · Called by: EDC App / Web

Operation

Description	Value
URL	https://{domain}/directdebit/subscribe/request
Method	POST

Request Payload

Field	Type	Required	Remark
merchant_id	string	Yes	Merchant ID at bank side
merchant_secret	string	Yes	Merchant secret key at bank side
transaction_id	string	Yes	Transaction reference number from EDC
transaction_description	string	No	Transaction description
return_url	string	Yes	The URL that bank will redirect to EDC side after subscription on bank page completed. We will provide as web url when subscribe from web and deeplink when subscribe from mobile platform.
details	json list	Yes	List of consumers

Request Payload of "details"

Field	Type	Required	Remark
company_code	string	Yes	Company code
company_name	string	Yes	Company name
consumer_code	string	Yes	Consumer code
consumer_name	string	Yes	Consumer name
consumer_name_latin	string	No	Consumer name in Latin

Example Request Payload

{
    "merchant_id": "EDC",
    "merchant_secret": "xxxxxxxxxxxxxxxx",
    "transaction_id": "174952172035635",
    "transaction_description": "",
    "details": [
        {
            "company_code": "EDC-BTB",
            "company_name": "អគ្គិសនីបាត់ដំបង",
            "consumer_code": "73562510",
            "consumer_name": "លោក ជា សំណាង",
            "consumer_name_latin": "Mr. Chea Samnang"
        },
        {
            "company_code": "EDC",
            "company_name": "អគ្គិសនីកម្ពុជា",
            "consumer_code": "93533310",
            "consumer_name": "លោក លីសីហា",
            "consumer_name_latin": "Mr. Ly Seyha"
        }
    ]
}

Response Payload

Field	Type	Remark
code	string	Response code
message	string	Response message in English
data	json	Data object

Response Payload for "data"

Field	Type	Remark
web_payment_url	string	The URL to call web payment
mobile_deep_link	string	The deep link to call bank app

Example Response Payload

{
    "code": "000",
    "message": "",
    "data": {
        "web_payment_url": "https://bankdomain/payment/....",
        "mobile_deep_link": "bank://..."
    }
}