CAM2 Pay API Documentation - ABA KHQR Gateway (cam2.cc)

⚡ Production Ready & Official ABA KHQR Standard

CAM2 Pay API Reference

ស្វាគមន៍មកកាន់ឯកសារបច្ចេកទេសផ្លូវការរបស់ CAM2 Pay (cam2.cc)។ ប្រព័ន្ធផ្គត់ផ្គង់ API បង្កើត Dynamic ABA KHQR ឥតដែនកំណត់ គាំទ្រទាំង Web Redirect, Popup Modal, Mobile App, Telegram Bot និង Instant Webhook Callback។

យក Profile ID & Secret Key

ចុះឈ្មោះគណនី Merchant លើ CAM2 Pay ដើម្បីទទួលបាន Profile ID (API Key) និង Secret Key សម្រាប់បង្កើត Security Hash Signature។

ផ្ញើ Request បង្កើត Checkout

ផ្ញើ POST request ជាមួយ Amount និង Order ID មកកាន់ Endpoint របស់ CAM2 Pay ដើម្បីទទួលបាន Dynamic KHQR ឬ Checkout URL ភ្លាមៗ។

ទទួលស្គាល់ការបង់លុយ (Webhook)

នៅពេលអតិថិជនស្កេនបង់លុយជោគជ័យ ប្រព័ន្ធ CAM2 Pay នឹងបាញ់ Webhook POST មក Server របស់អ្នកដោយស្វ័យប្រវត្តិដើម្បី Confirm Order។

⚡

API Endpoints & Integration Standards

Profile ID (API Key):

YOUR_PROFILE_ID

Secret Key:

YOUR_SECRET_KEY

Primary Checkout Endpoint:

POST https://cam2.cc/api/payment/checkout/:profile_id

Popup Modal Plugin:

/plugins/cam2-pay.js

📖

Code Examples & Client SDKs

📦 Download PHP Sample (.zip)

PHP SDK (PayWayApiCheckout.php)

Loading code sample...

🟢 Example JSON Response (HTTP 200 OK)

{
  "success": true,
  "status": "success",
  "checkout_url": "https://cam2.cc/pay/SES-1791614907485",
  "session_id": "SES-1791614907485",
  "data": {
    "qr": "00020101021229500016...041005802KH5912CAM2PAY6010PHNOM PENH6304D1B9",
    "qr_url": "https://cam2.cc/api/qr-image/SES-1791614907485",
    "deeplink": "https://link.payway.com.kh/ABAPAYwd542327q?amount=1.00"
  }
}

📋

Parameters Specification & Protocol Reference

1. Checkout Request Payload (POST /api/payment/checkout/:profile_id)

ប៉ារ៉ាម៉ែត្រដែលត្រូវផ្ញើក្នុង JSON Body ពេលហៅ API បង្កើតការទូទាត់ប្រាក់៖

Field Name	Type	Status	Description & Example
`transaction_id`	String	Required	លេខវិក្កយបត្រ ឬ Order ID ផ្ទាល់ខ្លួនរបស់អ្នក (ឧ. `INV-10023`)។ មិនត្រូវស្ទួនឡើយ។
`amount`	String / Float	Required	ចំនួនទឹកប្រាក់គិតជា USD (ឧ. `1.00`, `2.50`)។ កម្រិតអប្បបរមា 0.01។
`success_url`	String	Required	Link គេហទំព័ររបស់អ្នកដែលត្រូវឱ្យ Customer redirect ត្រឡប់មកវិញក្រោយពេលបង់លុយរួច។
`cancel_url`	String	Optional	Link ត្រឡប់មកវិញក្នុងករណីដែល Customer ចុចបោះបង់ការទូទាត់។
`remark`	String	Optional	សម្គាល់ការទូទាត់ (ឧ. `Order #10023 - MLBB 86 Diamonds`)។
`hash`	String	Required	Security SHA-1 Hash Signature គណនាដោយ៖ `sha1(secret_key + transaction_id + amount + success_url + remark)`
`custom_fields`	String (Base64)	Optional	ទិន្នន័យបន្ថែម (ឧ. Player ID, Server ID) ដែលត្រូវ encode ជា Base64។ Gateway នឹងបញ្ជូនត្រឡប់មកវិញក្នុង Webhook។

2. Webhook Callback Payload (Incoming POST to Merchant Server)

ទិន្នន័យដែល Gateway CAM2 Pay នឹងបាញ់ (POST JSON) ទៅកាន់ Webhook URL របស់ Merchant ពេលអតិថិជនបង់លុយជោគជ័យ៖

Field Name	Type	Description
`status`	String	ស្ថានភាពការទូទាត់៖ `SUCCESS`
`transaction_id`	String	លេខ Order ID ដើមដែល Merchant បានផ្ញើមក
`amount`	Float	ចំនួនទឹកប្រាក់ដែលទទួលបានពិតប្រាកដ (USD)
`tran_id`	String	លេខកូដប្រតិបត្តិការធនាគារផ្លូវការ (Bank Reference / Bakong Hash)
`req_time`	String	Timestamp នៃពេលវេលាដែលប្រព័ន្ធផ្ញើ Webhook
`hash`	String	HMAC SHA-256 Signature ដើម្បីផ្ទៀងផ្ទាត់ថា Callback មកពី CAM2 Pay ពិតប្រាកដ
`custom_fields`	String	ទិន្នន័យ Player / Custom metadata ដើមដែល Merchant បានភ្ជាប់មក