PhaJay Credit Card Payment Gateway API

1. ພາບລວມ

ເອກະສານນີ້ອະທິບາຍຂັ້ນຕອນການເຊື່ອມຕໍ່ PhaJay Payment Gateway API. API ນີ້ໃຫ້ວິທີທີ່ປອດໄພໃນການດຳເນີນການຊຳລະເງິນອອນລາຍຜ່ານທະນາຄານຄູ່ຮ່ວມງານຂອງພວກເຮົາ ໂດຍໃຊ້ຂະບວນການ redirect ເຊິ່ງຮັບປະກັນການປະຕິບັດຕາມມາດຕະຖານ PCI ໂດຍການຈັດການຂໍ້ມູນບັດທີ່ລະອຽດອ່ອນຢູ່ໃນໜ້າຊຳລະເງິນທີ່ປອດໄພ.

1.1 ຂັ້ນຕອນການເຊື່ອມຕໍ່

ການເຊື່ອມຕໍ່ການຊຳລະເງິນຂອງ PhaJay ປະກອບດ້ວຍ 11 ຂັ້ນຕອນທີ່ປອດໄພ:

1. ຜູ້ຊຳລະກົດປຸ່ມຊຳລະເງິນ: ລູກຄ້າເລີ່ມການຊຳລະເງິນຢູ່ເທິງ Platform
2. Platform ສົ່ງຄຳຂໍຊຳລະເງິນ: Platform ຮ້ອງຂໍລິ້ງໜ້າຊຳລະເງິນຈາກ PhaJay
3. PhaJay ສົ່ງຄຳຂໍຕໍ່ໄປຍັງທະນາຄານ: Gateway ປະມວນຜົນ ແລະ ສົ່ງຕໍ່ໄປຍັງທະນາຄານຄູ່ຮ່ວມງານ
4.ທະນາຄານຕອບກັບລິ້ງໜ້າຊຳລະເງິນ: ທະນາຄານສົ່ງ URL ຊຳລະເງິນທີ່ປອດໄພຄືນມາ
5. PhaJay ສົ່ງຕໍ່ໄປຍັງ Platform: Gateway ສົ່ງລິ້ງຊຳລະເງິນຄືນໃຫ້ Platform
6. Platform ເປີດໜ້າຊຳລະເງິນໃຫ້ຜູ້ຊຳລະ: ລູກຄ້າຖືກສົ່ງໄປຍັງແບບຟອມຊຳລະເງິນທີ່ປອດໄພ
7. ຜູ້ຊຳລະຊຳລະເງິນສຳເລັດ: ລູກຄ້າປ້ອນຂໍ້ມູນບັດ ແລະ ສົ່ງການຊຳລະເງິນ
8. ທະນາຄານສົ່ງໄປຫາໜ້າສຳເລັດຂອງ PhaJay: ຫຼັງຈາກປະມວນຜົນແລ້ວ, ທະນາຄານສົ່ງໄປຍັງ gateway
9. ທະນາຄານແຈ້ງຂໍ້ມູນ callback ຜ່ານ webhook: ທະນາຄານສົ່ງຜົນການຊຳລະເງິນໄປຫາ Platform
10. PhaJay ສົ່ງໄປຫາໜ້າສຳເລັດຂອງ Platform: ລູກຄ້າເຫັນໜ້າສຳເລັດຂອງ Platform
11. Platform ໄດ້ຮັບການແຈ້ງເຕືອນ webhook: Platform ປະມວນຜົນການຢືນຢັນການຊຳລະເງິນສຸດທ້າຍ

1.2 ການຕັ້ງຄ່າ

ກ່ອນເຊື່ອມຕໍ່ກັບ PhaJay Payment Gateway, ທ່ານຕ້ອງຕັ້ງຄ່າສິ່ງຕໍ່ໄປນີ້ໃນ merchant portal ຂອງພວກເຮົາ: Portal.PhaJay.co

ຂັ້ນຕອນທີ 1: ຕັ້ງຄ່າ Callback URL

ເຂົ້າສູ່ລະບົບບັນຊີຂອງທ່ານໃນ PhaJay web portal
ກົດ Settings > Callback URL
ປ້ອນ callback URL ຂອງທ່ານ
ກົດ Save

ຂັ້ນຕອນທີ 2: ຕັ້ງຄ່າ Webhook URL

ເຂົ້າສູ່ລະບົບບັນຊີຂອງທ່ານໃນ PhaJay web portal
ກົດ Settings > Webhook
ປ້ອນ webhook URL ຂອງທ່ານ
ກົດ Save

2. ຮັບລິ້ງໜ້າຊຳລະເງິນ

API Endpoint

URL: https://payment-gateway.phajay.co/v1/api/jdb2c2p/payment/payment-link
Method: POST
Authentication: Basic Auth

ຕົວຢ່າງ:

application/json

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

ໝາຍເຫດ :

- KEY ໝາຍເຖິງ secretKey ທີ່ທ່ານໄດ້ຮັບຫຼັງຈາກສຳເລັດ KYC ໃນ web portal.

- API ນີ້ຮອງຮັບສະເພາະບັດທີ່ເປີດໃຊ້ງານ 3D Secure (3DS) ເທົ່ານັ້ນ.

Request Body

ຊ່ອງຂໍ້ມູນ	ປະເພດ	ຄຳອະທິບາຍ
`amount`	Number	ຈຳນວນເງິນທີ່ຈະສ້າງສຳລັບທຸລະກຳ
`description`	String	ຄຳອະທິບາຍຂອງທຸລະກຳ ຫຼື ຈຸດປະສົງ
`tag1`	String	ຊ່ອງຂໍ້ມູນກຳນົດເອງທີ 1 ຂອງລະບົບລູກຄ້າ (ບໍ່ບັງຄັບ)
`tag2`	String	ຊ່ອງຂໍ້ມູນກຳນົດເອງທີ 2 ຂອງລະບົບລູກຄ້າ (ບໍ່ບັງຄັບ)
`tag3`	String	ຊ່ອງຂໍ້ມູນກຳນົດເອງທີ 3 ຂອງລະບົບລູກຄ້າ (ບໍ່ບັງຄັບ)

ຕົວຢ່າງ:

application/json

{
  "amount": 1000,
  "description": "Buy a Product",
  "tag1": "AppZap Shop",
  "tag2": "666bbb461732a2e46233fdf9",
  "tag3": "ORDER-0001"
}

Response Body

ຊ່ອງຂໍ້ມູນ	ປະເພດ	ຄຳອະທິບາຍ
`message`	String	ຂໍ້ຄວາມສະຖານະຂອງຂະບວນການທຸລະກຳ
`paymentUrl`	String	URL ທີ່ລູກຄ້າສາມາດຊຳລະເງິນຢ່າງປອດໄພ
`expirationTime`	DateTime	ເວລາໝົດອາຍຸຂອງ payment link ໃນຮູບແບບ ISO 8601 (UTC)
`transactionId`	String	ລະຫັດລະບຸທຸລະກຳທີ່ບໍ່ຊ້ຳກັນ
`status`	String	ສະຖານະປັດຈຸບັນຂອງທຸລະກຳ (ເຊັ່ນ: "WAITING" ໝາຍເຖິງລໍຖ້າ)

ຕົວຢ່າງ:

application/json

{
  "message": "SUCCESSFULLY",
  "paymentUrl": "https://payment.paco.2c2p.com/payment/?pid=a49881babe524387b179e142506d89f0&lang=en-US",
  "expirationTime": "2025-08-04T07:29:33",
  "transactionId": "2e87da27-4f8a-46fd-bea8-5e76dfb1e00d",
  "status": "WAITING"
}

3. ສົ່ງໄປຍັງ Payment Link

ໃນຂັ້ນຕອນນີ້, ຜູ້ໃຊ້ຖືກສົ່ງໄປຍັງໜ້າ payment link ທີ່ປອດໄພເພື່ອຊຳລະເງິນໃຫ້ສຳເລັດ.

ຂັ້ນຕອນທີ 1: ສົ່ງໄປຍັງໜ້າຊຳລະເງິນ

ຜູ້ໃຊ້ຖືກສົ່ງໄປຍັງໜ້າຊຳລະເງິນເພື່ອຊຳລະເງິນໃຫ້ສຳເລັດ.

ໝາຍເຫດ: API ນີ້ຮອງຮັບສະເພາະບັດທີ່ເປີດໃຊ້ງານ 3D Secure (3DS) ເທົ່ານັ້ນ

ຂັ້ນຕອນທີ 2: ການຢືນຢັນການຊຳລະເງິນ

ຫຼັງຈາກກົດປຸ່ມ "Continue", ທຸລະກຳຈະຖືກປະມວນຜົນ ແລະ ການແຈ້ງເຕືອນຈະຖືກສົ່ງໄປຍັງແອັບທະນາຄານຂອງເຈົ້າຂອງບັດເພື່ອອະນຸມັດ. ເມື່ອອະນຸມັດແລ້ວ, ທ່ານຈະ ຖືກສົ່ງໄປຍັງໜ້າສຳເລັດ. ຫຼັງຈາກ 5 ວິນາທີ, ລະບົບຈະສົ່ງໄປຍັງໜ້າສຳເລັດຂອງ PhaJay ໂດຍອັດຕະໂນມັດ. ຈາກນັ້ນ PhaJay ຈະສົ່ງຜົນການຊຳລະເງິນໄປຍັງແພລດຟອມຂອງທ່ານຜ່ານ webhook.

ໝາຍເຫດ: API ນີ້ຮອງຮັບສະເພາະບັດທີ່ເປີດໃຊ້ງານ 3D Secure (3DS) ເທົ່ານັ້ນ

ຂັ້ນຕອນທີ 3: ການຢືນຢັນການຊຳລະເງິນ

ຫຼັງຈາກປ້ອນຂໍ້ມູນທີ່ຈຳເປັນທັງໝົດແລ້ວ, ການກົດປຸ່ມ "Continue" ຈະສົ່ງໄປຍັງໜ້າຢືນຢັນ.

ຂັ້ນຕອນທີ 4: ການສົ່ງໄປຍັງຂັ້ນສຸດທ້າຍ ຜູ້ໃຊ້ສາມາດກົດ "Skip" ເພື່ອໄປຍັງໜ້າສຳເລັດຂອງແພລດຟອມຂອງທ່ານ, ຫຼື ລໍຖ້າການສົ່ງອັດຕະໂນມັດເມື່ອການນັບຖອຍຫຼັງຮອດ 0.

4. ການແຈ້ງເຕືອນ Webhook

ເມື່ອທຸລະກຳສຳເລັດ, PhaJay ຈະສົ່ງຂໍ້ມູນ callback ຄືນໄປຍັງແພລດຟອມຜ່ານ webhook ທີ່ຕັ້ງຄ່າໄວ້ໃນບັນຊີແພລດຟອມ (1.2 ) ຂໍ້ມູນນີ້ຖືກສົ່ງເປັນສ່ວນໜຶ່ງຂອງ HTTPS request (ໂດຍທົ່ວໄປແມ່ນ POST ) ຈາກບໍລິການໄປຍັງ webhook URL ທີ່ກຳນົດໄວ້ ແລະ webhook endpoint ຂອງແພລດຟອມຕ້ອງຕອບກັບດ້ວຍ HTTPS status code 200 ເພື່ອຢືນຢັນການໄດ້ຮັບ. API ນີ້ຮອງຮັບສະເພາະບັດທີ່ເປີດໃຊ້ງານ 3D Secure (3DS) ເທົ່ານັ້ນ

🔐 ກ່ອນເຊື່ອຖືຂໍ້ມູນນີ້, ໃຫ້ກວດສອບວ່າ request ມາຈາກ PhaJay ຈິງ — ເບິ່ງ Verify Webhook Signature.

Response Body

ຊ່ອງຂໍ້ມູນ	ປະເພດ	ຄຳອະທິບາຍ
`message`	String	ຂໍ້ຄວາມສະຖານະຂອງຂະບວນການທຸລະກຳ
`transactionId`	String	ລະຫັດລະບຸທຸລະກຳທີ່ບໍ່ຊ້ຳກັນ
`linkCode`	String	ລະຫັດທີ່ໃຊ້ອ້າງອິງ ຫຼື ເຂົ້າເຖິງການຊຳລະເງິນ
`paymentMethod`	String	ວິທີການຊຳລະເງິນທີ່ໃຊ້ (CREDIT_CARD)
`status`	String	ສະຖານະປັດຈຸບັນຂອງການຊຳລະເງິນ
`userId`	String	ID ຂອງຜູ້ໃຊ້ທີ່ມີທຸລະກຳ (ID ໃນລະບົບ PhaJay)
`description`	String	ຄຳອະທິບາຍຂອງການຊຳລະເງິນ
`tag1` to `tag6`	String	Tag ເພີ່ມເຕີມຂອງທຸລະກຳ
`successURL`	String	Success callback URL
`txnAmount`	Number	ຈຳນວນເງິນທຸລະກຳ
`currency`	String	ສະກຸນເງິນຂອງຈຳນວນເງິນທຸລະກຳ (USD)
`cardType`	String	ປະເພດບັດເຄຣດິດທີ່ໃຊ້ (ເຊັ່ນ: "CC-VI" ສຳລັບ Visa)
`creditCardDetails`	Object	ລາຍລະອຽດຂໍ້ມູນຂອງເຈົ້າຂອງບັດ
`transactionAmount`	Object	ຂໍ້ມູນລາຍລະອຽດຈຳນວນເງິນທຸລະກຳ

ຕົວຢ່າງ:

application/json

{
  "message": "SUCCESS",
  "transactionId": "2e87da27-4f8a-46fd-bea8-5e76dfb1e00d",
  "linkCode": "2e87da27-4f8a-46fd-bea8-5e76dfb1e00d",
  "paymentMethod": "CREDIT_CARD",
  "status": "PAYMENT_COMPLETED",
  "userId": "686e113e59b2cbf66d72583d",
  "description": "CREDIT CARD PAYMENT: JAOL-Donation",
  "tag1": null,
  "tag2": null,
  "tag3": null,
  "tag4": null,
  "tag5": null,
  "tag6": null,
  "txnAmount": 1,
  "currency": "USD",
  "cardType": "CC-VI",
  "creditCardDetails": {
    "issuerCode": null,
    "cardHolderName": "KHAMSENG INTHAVONG",
    "cardNumber": "412639XXXXXX2372",
    "cardExpiry": "XXXX",
    "authenticationStatus": null,
    "eciValue": null,
    "xidValue": null,
    "cavvValue": null,
    "enrolledFlag": null
  },
  "transactionAmount": {
    "amountText": "000000000100",
    "currencyCode": "USD",
    "decimalPlaces": 2,
    "amount": 1
  }
}

⚠️ ໝາຍເຫດ:

ຮອງຮັບສະເພາະບັດທີ່ເປີດໃຊ້ງານ 3D Secure (3DS) ເທົ່ານັ້ນ

ອະນຸຍາດສະເພາະບັນຊີແພລດຟອມທີ່ KYC ໄດ້ຮັບການອະນຸມັດແລ້ວເທົ່ານັ້ນໃຫ້ໃຊ້ API ນີ້

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

ຍົກເລີກ Subscription ກວດສອບສະຖານະທຸລະກຳ