Subscription Confirm

Subscribe from Mobile Banking / iBanking

Subscription Confirm

This operation is to confirm the subscription at EDC side.

Implemented by: EDC Payment Gateway · Called by: Partner bank

Operation

Description	Value
URL	https://edc-sit-api.oone.bz/pg-directdebit-api/subscribe/v2
Method	POST

Headers

Key	Value	Remark
Accept	application/json
Content-Type	application/json
Authorization	Bearer	Will provide privately

Request Payload

Field	Type	Required	Remark
biller_code	string	Yes	Biller prefix code (Default is EDC)
ref_no	string	Yes	Full bank account number of the consumer
subscribe_date	string	Yes	Subscription date (ISO 8601)
subscribe_ref	string	No	Subscription reference number from EDC. Bank need to provide this field when subscribe from EDC channel
details	json list	Yes	List of consumers and subscribe tokens

Request Payload of "details"

Field	Type	Required	Remark
consumer_code	string	Yes	Consumer code
subscribe_token	string	Yes	Hash calculation field Base64(SHA-512(biller_code + consumer_code + ref_no + subscript_date[yyyyMMddHHmmss] + bank_token)) Note: Bank need to store this value in their side.

Example Request Payload

{
    "biller_code": "EDC",
    "ref_no": "001937779",
    "subscribe_date": "2022-02-18 15:30:12",
    "subscribe_ref": "1234567890",
    "details": [
        {
            "consumer_code": "73562510",
            "subscribe_token": "...Wk83giJmm3zQEqCoNUGXRUe+I5U7mSd0CCCGRa70aBw=="
        },
        {
            "consumer_code": "93533310",
            "subscribe_token": "...tk90giJmm3zQEqCoNUGXEEE+Y5U7mSd0CCCGDb98eAc=="
        }
    ]
}

Response Payload

Field	Type	Remark
code	string	Response code
message	string	Response message in English
message_kh	string	Response message in Khmer

Example Response Payload

{
    "code": "000",
    "message": "Direct Debit subscribed successfully.",
    "message_kh": "សេវាកម្មទូទាត់ប្រាក់ដោយស្វ័យប្រវត្តិត្រូវបានភ្ជាប់ដោយជោគជ័យ។"
}