ກວດສອບສະຖານະທຸລະກຳ

ໃຊ້ API ນີ້ເພື່ອກວດສອບສະຖານະປັດຈຸບັນຂອງທຸລະກຳດ້ວຍ transactionId. ມີປະໂຫຍດເມື່ອແພລດຟອມຂອງທ່ານບໍ່ໄດ້ຮັບ webhook callback, ຫຼື ເມື່ອທ່ານຕ້ອງການຢືນຢັນການຊຳລະເງິນກ່ອນສົ່ງມອບສິນຄ້າໃຫ້ລູກຄ້າ.

1. Request

ພາຣາມິເຕີ	ຄ່າ
URL	`https://payment-gateway.phajay.co/v1/api/payment/check-transaction/status/:transactionId`
Method	`GET`
Authentication	`Basic Auth`

ຕົວຢ່າງ:

application/json

      {
      "Content-Type": "application/json",
      Authorization:`Basic ${Buffer.from(`${KEY}`).toString("base64")}`
     }

ໝາຍເຫດ: KEY ໝາຍເຖິງ Secret Key ຂອງທ່ານ ເຊິ່ງໃຊ້ເພື່ອອະນຸຍາດການເອີ້ນໃຊ້ API. ທ່ານສາມາດຊອກຫາ Secret Key ໄດ້ທີ່ໜ້າ Key Management ຂອງ PhaJay Portal ຫຼັງຈາກເຂົ້າສູ່ລະບົບ.

Path Parameters:

ຊ່ອງຂໍ້ມູນ	ປະເພດ	ຄຳອະທິບາຍ
transactionId	String	ລະຫັດລະບຸທຸລະກຳທີ່ບໍ່ຊ້ຳກັນ ເຊິ່ງສ້າງໂດຍລະບົບ (ໄດ້ຮັບເມື່ອສ້າງ Payment Link / Payment QR ແລະ ມີຢູ່ໃນຂໍ້ມູນ webhook).

ຕົວຢ່າງ Request:

cURL

KEY="your_secret_key"
 
curl --location 'https://payment-gateway.phajay.co/v1/api/payment/check-transaction/status/4d420686-18af-42db-9ad9-0b6e18d7c6db' \
  --header 'Content-Type: application/json' \
  --header "Authorization: Basic $(printf '%s' "$KEY" | base64)"

JavaScript (axios)

import axios from "axios";
 
const KEY = "your_secret_key";
const transactionId = "4d420686-18af-42db-9ad9-0b6e18d7c6db";
 
const response = await axios.get(
  `https://payment-gateway.phajay.co/v1/api/payment/check-transaction/status/${transactionId}`,
  {
    headers: {
      "Content-Type": "application/json",
      Authorization: `Basic ${Buffer.from(`${KEY}`).toString("base64")}`,
    },
  }
);
 
console.log(response.data);

2. Response

Response Data:

ຊ່ອງຂໍ້ມູນ	ປະເພດ	ຄຳອະທິບາຍ
message	String	ຜົນຂອງການເອີ້ນໃຊ້ API (`SUCCESSFULLY` ເມື່ອພົບທຸລະກຳ).
data.transactionId	String	ລະຫັດລະບຸທຸລະກຳທີ່ບໍ່ຊ້ຳກັນ ເຊິ່ງສ້າງໂດຍລະບົບ.
data.linkCode	String \| null	ລະຫັດລະບຸ payment link, ຖ້າທຸລະກຳຖືກສ້າງຈາກ Payment Link.
data.orderNo	String \| null	ເລກອໍເດີຂອງແພລດຟອມທີ່ກ່ຽວຂ້ອງກັບທຸລະກຳ, ຖ້າມີການລະບຸ.
data.status	String	ສະຖານະປັດຈຸບັນຂອງທຸລະກຳ (ເຊັ່ນ: `WAITING`, `EXPIRED`, `REFUNDED`, `DISPUTED`, `PAYMENT_COMPLETED`).
data.isPaid	Boolean	`true` ເມື່ອທຸລະກຳຖືກຊຳລະແລ້ວ, ຖ້າບໍ່ແມ່ນແມ່ນ `false`.
data.amount	Number	ຈຳນວນເງິນທຸລະກຳ.
data.currency	String	ສະກຸນເງິນຂອງທຸລະກຳ (ເຊັ່ນ: `LAK`).
data.description	String	ຄຳອະທິບາຍຂອງທຸລະກຳ.
data.paymentMethod	String	ທະນາຄານ / ວິທີການຊຳລະເງິນ (ເຊັ່ນ: BCEL, JDB, LDB, APB).
data.paymentTime	DateTime \| null	ເວລາທີ່ການຊຳລະເງິນສຳເລັດ; `null` ຖ້າຍັງບໍ່ໄດ້ຊຳລະ.
data.createdAt	DateTime	Timestamp ທີ່ບອກເວລາທີ່ທຸລະກຳຖືກສ້າງ.

ຕົວຢ່າງ Response ສຳເລັດ:

application/json

{
  "message": "SUCCESSFULLY",
  "data": {
    "transactionId": "4d420686-18af-42db-9ad9-0b6e18d7c6db",
    "linkCode": null,
    "orderNo": null,
    "status": "WAITING",
    "isPaid": false,
    "amount": 100000,
    "currency": "LAK",
    "description": "EV5lGcw20260928041738796",
    "paymentMethod": "BCEL",
    "paymentTime": null,
    "createdAt": "2026-09-28T04:17:38.973Z"
  }
}

ຕົວຢ່າງ Response ຂໍ້ຜິດພາດ:

ເມື່ອ transactionId ບໍ່ມີໃນລະບົບ:

application/json

{
  "message": "PAYMENT_NOT_FOUND"
}

⚠️ ໝາຍເຫດ:
ໃຫ້ຖືວ່າທຸລະກຳຖືກຊຳລະແລ້ວກໍຕໍ່ເມື່ອ isPaid ເປັນ true ເທົ່ານັ້ນ (status ເປັນ PAYMENT_COMPLETED).

ອັບເດດຫຼ້າສຸດ: 20 ມື້ກ່ອນ

ເຊື່ອມຕໍ່ Credit Card ກວດສອບ Webhook Signature