Web Checkout — ផ្ទាំងទូទាត់ប្រាក់រហ័សពី Bakong Relay

លំហូរការងារ និងការណែនាំរៀបចំ Web Checkouts

⚙️ប្រព័ន្ធ Dynamic Polling System

ប្រព័ន្ធ Web Checkouts របស់ពួកយើងដំណើរការដោយបច្គេកវិទ្យា Dynamic Polling System សម្រាប់ឆែកស្ថានភាពប្រតិបត្តិការ។ ប្រព័ន្ធនេះជួយគណនាពេលវេលាទៅតាមស្ថានភាពជាក់ស្តែង ដើម្បីការពារ និងជៀសវាស់ការប្រើប្រាស់កញ្ចប់ RBK Token របស់ User ច្រើនជ្រុលលើសកម្រិត (Overuse Rate Limit)។

⏱️កាលវិភាគ និងល្បឿនឆែកផ្អែកលើរយៈពេលកន្លងផុត (Dynamic Windows Matrix)

០ - ៥ នាទីដំបូង:
ឆែករហ័ស ៥ វិនាទីម្តង

នាទីទី ៥ - ១៥:
ពន្យារមក ១០ វិនាទីម្តង

នាទីទី ១៥ - ១ ម៉ោង:
ពន្យារមក ១៥ វិនាទីម្តង

លើសពី ១ ម៉ោងឡើងទៅ:
សម្រាកវែង ៥ នាទីម្តង (300s)

📐រូបមន្តសម្រាប់គណនា (Calculation Formula)

ចំនួន API Calls សរុប = Σ (រយៈពេលនៅក្នុងចន្លោះនីមួយៗ ÷ ល្បឿនសម្រាកក្នុងចន្លោះនោះ)

① ករណីសាកល្បង Timeout 5 នាទី (300 វិនាទី)

ស្ថិតនៅក្នុងចន្លោះទី ១ ទាំងស្រុង៖ ០ ដល់ ៣០០ វិនាទី

👉 គណនា៖ 300s ÷ 5s = 60 Calls

② ករណីទូទៅ Timeout 10 នាទី (600 វិនាទី)

៥ នាទីដំបូង (300s): 300s ÷ 5s = 60 Calls
៥ នាទីបន្ទាប់ (300s): 300s ÷ 10s = 30 Calls

👉 សរុបរួម៖ 60 + 30 = 90 Calls

⚠️តម្រូវការចាំបាច់៖ Whitelist Domain

ដើម្បីអាចប្រើប្រាស់ Web Checkouts នៅលើវេបសាយរបស់អ្នកបាន អ្នកត្រូវតែធ្វើការ Whitelist Domain ជាមុនសិន ដោយចូលទៅកាន់ Telegram Bot៖

🤖 @bakong_relay_bot ↗️

បន្ទាប់មកចុចម៉ឺនុយ Domains រួចចុច Add New Domain និងធ្វើតាមការណែនាំ។

១. បង្កើត Checkout Session (API Request)API Docs

POST https://api.bakongrelay.com/v1/web_checkouts/createHeader: Authentication Bearer RBK_TOKEN

Sample Payload

{
  "trans_id": "TRX12345678",
  "req_custom": {
    "lang": "km",
    "ttl": 5
  },
  "req_khqr": {
    "account_id": "your_name@bank",
    "merchant_name": "Your Name",
    "merchant_city": "Phnom Penh",
    "amount": 3000,
    "currency": "KHR"
  },
  "req_url": {
    "return_url": "https://your_site.com/store/",
    "webhook_url": "https://your_site.com/api/webhooks"
  }
}

Sample Response

{
  "data": {
    "checkout_url": "https://checkout.bakongrelay.com/pQOjr...",
    "id": "e3298cb2-ede4-449b-89e2-9cd81a88e303",
    "iframe_snippet": "<iframe id='bakong-relay...'></iframe>...\",
    "session_id": "pQOjrGGv1Xkr",
    "trans_id": "TRX123456"
  },
  "responseCode": 0,
  "responseMessage": "Web checkout session created."
}

២. កូដគំរូសម្រាប់ចាក់បង្កប់ផ្ទាំង Popup Iframe (Frontend JavaScript SDK)

អាជីវករអាចប្រើប្រាស់លីង `checkout_url` សម្រាប់បើកទំព័រទូទាត់ប្រាក់ផ្ទាល់ (Direct Link) ឬប្រើប្រាស់ JavaScript SDK ខាងក្រោមដើម្បីដំណើរការផ្ទាំង Popup Iframe បានយ៉ាងងាយស្រួល។

merchant_shop.html

<!DOCTYPE html>
<html lang="km">
<head>
    <title>Merchant Shop</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="Content-Security-Policy" content="connect-src 'self' https://checkout.bakongrelay.com wss://checkout.bakongrelay.com;">
    <script src="https://checkout.bakongrelay.com/static/js/checkout.min.js"></script>
</head>
<body style="background-color: #104e4e;">

    <button onclick="BakongRelay.pay('pQOjrGGv1Xkr')" style="padding: 15px; background: #0b2447; color: white;">
        Checkout Now
    </button>

    <script>
        window.addEventListener('bakongPaymentSuccess', function(e) {
            console.log("Payment completed for:", e.detail.session_id);
        });
    </script
</body
</html}

៣. ពិនិត្យមើលព័ត៌មានលម្អិតនៃ Session (Session Details API)API Docs

POST https://api.bakongrelay.com/v1/web_checkouts/detailsHeader: Authentication Bearer RBK_TOKEN

Sample Payload

{
  "session_id": "4DJqg***cZGG"
}

Sample Response

{
  "data": {
    "created_at": "2026-05-21T09:01:04...",
    "data": {
      "amount": 1000,
      "currency": "KHR",
      "externalRef": "100FT#####072796",
      "fromAccountId": "bank_addr@bank",
      "hash": "70b16ec07bcac5a87dcc...",
      "toAccountId": "yourname@bank"
    },
    "id": "a0151aac-####-####-####",
    "status": "PAID",
    "trans_id": "TRX199288"
  },
  "responseCode": 0,
  "responseMessage": "Checkout session retrieved."
}

៤. ជំហានចុងក្រោយ៖ ប្រព័ន្ធទិន្នន័យ Webhook សម្រាប់កាត់ស្តុកទំនិញ

📢 ចំណាំសំខាន់បំផុត៖ ជំហានចុងក្រោយគឺ Webhook នឹងផ្ញើព័ត៌មានត្រឡប់ទៅកាន់ម៉ាស៊ីនមេ (Server Backend) របស់អ្នកភ្លាមៗ ដើម្បីបញ្ជាក់ជាផ្លូវការថាតើត្រូវ កាត់ស្តុកទំនិញ (Deduct Inventory Stock) ឬមិនកាត់ស្តុក។ ប្រព័ន្ធ Webhook ដំណើរការលើ ២ លក្ខខណ្ឌយ៉ាងច្បាស់លាស់គឺ៖

🟢 PAID : ទូទាត់បានជោគជ័យ (ប្រព័ន្ធផ្ញើទិន្នន័យត្រឡប់ទៅវិញ ដើម្បីឱ្យបងធ្វើការកាត់ស្តុកទំនិញ និងបញ្ជាក់ការទិញភ្លាមៗ)
🔴 EXPIRED : ហួសកំណត់ពេលវេលាទូទាត់ (ប្រព័ន្ធផ្ញើទៅដើម្បីប្រាប់ឱ្យដឹង និងមិនធ្វើការកាត់ស្តុកឡើយ)

● WEBHOOK PAYLOAD (STATUS: PAID)

{
  "id": "15f3d66a-e6d5-4370-b175-26d2713cc2a2",
  "status": "PAID",
  "created_at": "2026-05-27T02:30:57.085701+00:00",
  "req_khqr": {
    "account_id": "your_name@bank",
    "merchant_name": "Your Name",
    "merchant_city": "Phnom Penh",
    "amount": 3000,
    "currency": "KHR",
    "qr_string": "00020101021229190015your_name@bank5204...",
    "md5": "ab07984352550e7b107171fed3fdc792"
  },
  "updated_at": "2026-05-27T02:31:10.046675+00:00",
  "data": {
    "hash": "66afcc4f6102ff5198bea2482#######ac9e...",
    "fromAccountId": "bank_addr@bank",
    "toAccountId": "your_name@bank",
    "currency": "KHR",
    "amount": 3000,
    "externalRef": "100FT37804839898"
  },
  "req_url": {
    "return_url": "http://your_site.com/store/",
    "webhook_url": "https://your_site.com/api/webhooks"
  },
  "trans_id": "TRX12345678",
  "session_id": "pQOjrGGv1Xkr"
}

● WEBHOOK PAYLOAD (STATUS: EXPIRED)

{
  "id": "ae076b51-b175-40a6-9a80-559ea446406c",
  "status": "EXPIRED",
  "created_at": "2026-05-25T07:14:09.937732+00:00",
  "req_khqr": {
    "account_id": "your_name@bank",
    "merchant_name": "Your Name",
    "merchant_city": "Phnom Penh",
    "amount": 3000,
    "currency": "KHR",
    "qr_string": "00020101021229190015your_name@bank5204...",
    "md5": "f0adacf18ded4cd2ac0175de1920f7aa"
  },
  "updated_at": "2026-05-25T07:14:19.721181+00:00",
  "data": {},
  "req_url": {
    "return_url": "https://your_site.com/store/",
    "webhook_url": "https://your_site.com/api/webhooks"
  },
  "trans_id": "TRX12345678",
  "session_id": "pQOjrGGv1Xkr"
}

កំពុងដំណើរការ...

លំហូរការងារ និងការណែនាំរៀបចំ Web Checkouts

⚙️ប្រព័ន្ធ Dynamic Polling System

⏱️កាលវិភាគ និងល្បឿនឆែកផ្អែកលើរយៈពេលកន្លងផុត (Dynamic Windows Matrix)

០ - ៥ នាទីដំបូង:
ឆែករហ័ស ៥ វិនាទីម្តង

នាទីទី ៥ - ១៥:
ពន្យារមក ១០ វិនាទីម្តង

នាទីទី ១៥ - ១ ម៉ោង:
ពន្យារមក ១៥ វិនាទីម្តង

លើសពី ១ ម៉ោងឡើងទៅ:
សម្រាកវែង ៥ នាទីម្តង (300s)

📐រូបមន្តសម្រាប់គណនា (Calculation Formula)

① ករណីសាកល្បង Timeout 5 នាទី (300 វិនាទី)

ស្ថិតនៅក្នុងចន្លោះទី ១ ទាំងស្រុង៖ ០ ដល់ ៣០០ វិនាទី

👉 គណនា៖ 300s ÷ 5s = 60 Calls

② ករណីទូទៅ Timeout 10 នាទី (600 វិនាទី)

៥ នាទីដំបូង (300s): 300s ÷ 5s = 60 Calls
៥ នាទីបន្ទាប់ (300s): 300s ÷ 10s = 30 Calls

👉 សរុបរួម៖ 60 + 30 = 90 Calls

⚠️តម្រូវការចាំបាច់៖ Whitelist Domain

🤖 @bakong_relay_bot ↗️

បន្ទាប់មកចុចម៉ឺនុយ Domains រួចចុច Add New Domain និងធ្វើតាមការណែនាំ។

{ "trans_id": "TRX12345678", "req_custom": { "lang": "km", "ttl": 5 }, "req_khqr": { "account_id": "your_name@bank", "merchant_name": "Your Name", "merchant_city": "Phnom Penh", "amount": 3000, "currency": "KHR" }, "req_url": { "return_url": "https://your_site.com/store/", "webhook_url": "https://your_site.com/api/webhooks" } }

{ "data": { "checkout_url": "https://checkout.bakongrelay.com/pQOjr...", "id": "e3298cb2-ede4-449b-89e2-9cd81a88e303", "iframe_snippet": "<iframe id='bakong-relay...'></iframe>...\", "session_id": "pQOjrGGv1Xkr", "trans_id": "TRX123456" }, "responseCode": 0, "responseMessage": "Web checkout session created." }

<!DOCTYPE html> <html lang="km"> <head> <title>Merchant Shop</title> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta http-equiv="Content-Security-Policy" content="connect-src 'self' https://checkout.bakongrelay.com wss://checkout.bakongrelay.com;"> <script src="https://checkout.bakongrelay.com/static/js/checkout.min.js"></script> </head> <body style="background-color: #104e4e;"> <button onclick="BakongRelay.pay('pQOjrGGv1Xkr')" style="padding: 15px; background: #0b2447; color: white;"> Checkout Now </button> <script> window.addEventListener('bakongPaymentSuccess', function(e) { console.log("Payment completed for:", e.detail.session_id); }); </script </body </html}

{ "data": { "created_at": "2026-05-21T09:01:04...", "data": { "amount": 1000, "currency": "KHR", "externalRef": "100FT#####072796", "fromAccountId": "bank_addr@bank", "hash": "70b16ec07bcac5a87dcc...", "toAccountId": "yourname@bank" }, "id": "a0151aac-####-####-####", "status": "PAID", "trans_id": "TRX199288" }, "responseCode": 0, "responseMessage": "Checkout session retrieved." }

{ "id": "15f3d66a-e6d5-4370-b175-26d2713cc2a2", "status": "PAID", "created_at": "2026-05-27T02:30:57.085701+00:00", "req_khqr": { "account_id": "your_name@bank", "merchant_name": "Your Name", "merchant_city": "Phnom Penh", "amount": 3000, "currency": "KHR", "qr_string": "00020101021229190015your_name@bank5204...", "md5": "ab07984352550e7b107171fed3fdc792" }, "updated_at": "2026-05-27T02:31:10.046675+00:00", "data": { "hash": "66afcc4f6102ff5198bea2482#######ac9e...", "fromAccountId": "bank_addr@bank", "toAccountId": "your_name@bank", "currency": "KHR", "amount": 3000, "externalRef": "100FT37804839898" }, "req_url": { "return_url": "http://your_site.com/store/", "webhook_url": "https://your_site.com/api/webhooks" }, "trans_id": "TRX12345678", "session_id": "pQOjrGGv1Xkr" }

{ "id": "ae076b51-b175-40a6-9a80-559ea446406c", "status": "EXPIRED", "created_at": "2026-05-25T07:14:09.937732+00:00", "req_khqr": { "account_id": "your_name@bank", "merchant_name": "Your Name", "merchant_city": "Phnom Penh", "amount": 3000, "currency": "KHR", "qr_string": "00020101021229190015your_name@bank5204...", "md5": "f0adacf18ded4cd2ac0175de1920f7aa" }, "updated_at": "2026-05-25T07:14:19.721181+00:00", "data": {}, "req_url": { "return_url": "https://your_site.com/store/", "webhook_url": "https://your_site.com/api/webhooks" }, "trans_id": "TRX12345678", "session_id": "pQOjrGGv1Xkr" }