ສ້າງລາຍການທຳລາຍກຳ (Create Transaction)

API ນີ້ໃຊ້ເພື່ອສ້າງລາຍການທຳລາຍກຳ (Topup/Transaction) ໃໝ່.

ເສັ້ນທາງ (Endpoint)

POST https://open-api.q23.co/termgame/{identify}/topup

ແທນທີ່ {identify} ດ້ວຍລະຫັດຂອງທ່ານ.

Header

ຊື່ Header	ຈຳເປັນ	ຄຳອະທິບາຍ
agent-token	✅	ລະຫັດຜ່ານສຳລັບການຢືນຢັນ

ຕົວຢ່າງ:

agent-token: agent_password

ຮ່າງກາຍຂໍ້ມູນ (Request Body)

{
  "selectPackage": "68223cdb7420ce4ea4acb91f",
  "amount": 1,
  "payload": [
    {
      "ref": "u_id",
      "value": "1"
    }
  ]
}

ຊື່ຄ່າ	ປະເພດ	ຄຳອະທິບາຍ
selectPackage	string	ລະຫັດ package ທີ່ຈະຊື້
amount	number	ຈຳນວນທີ່ຈະຊື້
payload	array object	ຂໍ້ມູນ payload ຕາມສິນຄ້າ

payload:

ຊື່ຄ່າ	ປະເພດ	ຄຳອະທິບາຍ
ref	string	ຊື່ຟິວລທີ່ຕ້ອງການ
value	string	ຄ່າຂອງຟິວລດັ່ງກ່າວ

ຄຳຕອບ (Response)

ຖ້າສຳເລັດ ຈະໄດ້ຮັບ JSON ດັ່ງນີ້:

{
  "code": "X0KGI4R2ERE1X7WA",
  "total": 19999,
  "agentCost": 0,
  "description": "create bill by agent api",
  "type": "ADMIN",
  "status": "CREATED",
  "userId": "67b4e295cac2201d41a87c3d",
  "businessId": "67b4e295cac2201d41a87c3d",
  "isDelete": false,
  "revelation": "PERSONAL",
  "_id": "682b00a731867e52284532a7",
  "createdAt": "2025-05-19T09:57:59.165Z",
  "updatedAt": "2025-05-19T09:57:59.165Z"
}

ຊື່ຄ່າ	ປະເພດ	ຄຳອະທິບາຍ
code	string	ລະຫັດບິນ/ທຳລາຍກຳ
total	number	ລາຄາລວມ
agentCost	number	ຕົ້ນທຶນຂອງ agent
description	string	ຄຳອະທິບາຍ
type	string	ປະເພດການສ້າງ
status	string	ສະຖານະ
userId	string	ລະຫັດຜູ້ໃຊ້
businessId	string	ລະຫັດທຸລະກິດ
isDelete	boolean	ສະຖານະການລຶບ
revelation	string	ປະເພດການເປີດເຜີຍ
_id	string	ລະຫັດທຳລາຍກຳ
createdAt	string	ວັນທີເວລາສ້າງ (ISO8601)
updatedAt	string	ວັນທີເວລາອັບເດດ (ISO8601)

ຕົວຢ່າງການໃຊ້ງານ

cURL

curl -X POST \
  'https://open-api.q23.co/termgame/{identify}/topup' \
  -H 'Content-Type: application/json' \
  -H 'agent-token: agent_password' \
  -d '{
    "selectPackage": "68223cdb7420ce4ea4acb91f",
    "amount": 1,
    "payload": [
      { "ref": "u_id", "value": "1" }
    ]
  }'

JavaScript

fetch("https://open-api.q23.co/termgame/{identify}/topup", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "agent-token": "agent_password",
  },
  body: JSON.stringify({
    selectPackage: "68223cdb7420ce4ea4acb91f",
    amount: 1,
    payload: [{ ref: "u_id", value: "1" }],
  }),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));