ຂ້າມໄປຫາເນື້ອຫາ
WQN Gateway ຈັດການການຊຳລະ
ເມນູເພີ່ມເຕີມ
ສູນຄວາມໜ້າເຊື່ອຖື ຫຼັກຖານ ແລະຂັ້ນຕອນຄວບຄຸມສຳລັບຮ້ານຄ້າ, ນັກພັດທະນາ ແລະພາກຮ່ວມ.
ກວດ KYC ເກັບລະຫັດລັບຝັ່ງເຊີບເວີ Webhook ມີລາຍເຊັນ ທົດສອບ Sandbox
ຄວາມປອດໄພ ກົດຄວາມສ່ຽງ, PCI checklist ແລະ access controls Sandbox ທົດສອບຜົນຂອງ checkout ໂດຍບໍ່ໃຊ້ເງິນຈິງ ຄູ່ມື API Endpoints, API keys ແລະ request/response examples ເສັ້ນທາງ Provider OneCloudPay live route ແລະ 2C2P reference ຕິດຕໍ່ ຊ່ວຍ onboarding ຮ້ານຄ້າ ແລະການເຊື່ອມຕໍ່
ເລີ່ມໃນ Sandbox

ແພລດຟອມນັກພັດທະນາ

API ສຳລັບນັກພັດທະນາ

API ການຊຳລະແບບ REST ພ້ອມລະຫັດປ້ອງກັນການສົ່ງຊ້ຳ, Webhook ທີ່ມີລາຍເຊັນ ແລະ session ໜ້າຊຳລະທີ່ໂຮສໃຫ້.

ຮັບລະຫັດ Sandbox ທົດສອບການຊຳລະ
REST API Webhook ມີລາຍເຊັນ ໜ້າຊຳລະ Hosted
01ເລີ່ມຈາກ Sandboxທົດສອບຜົນກ່ອນ live onboarding
02ເຫດການປອດໄພHMAC signatures ແລະ replay protection
03ປະຕິບັດການຊັດເຈນທຸລະກຳ, ລາຍງານ ແລະຊຳລະຍອດເຫັນຊັດ
04ສົ່ງຕໍ່ພາກພື້ນຈັດການການຊຳລະທີ່ພ້ອມ provider

ເລີ່ມທີ່ນີ້

ສ້າງ test payment ທຳອິດ.

ໃຊ້ Sandbox credentials, ສ້າງ payment intent, ສົ່ງລູກຄ້າໄປໜ້າຊຳລະທີ່ໂຮສໃຫ້ ແລະກວດ signed webhook ກ່ອນອັບເດດ order.
01
Quickstartເຮັດຕາມ integration sequence
 02
API referenceກວດ endpoints ທີ່ມີ
 03
Webhooksກວດ payment events ທີ່ມີລາຍເຊັນ
 04
Testing guideຈຳລອງ payment outcomes

Quickstart

v1
  1. 1ສ້າງບັນຊີຮ້ານຄ້າ
  2. 2ສ້າງລະຫັດ Sandbox
  3. 3ສ້າງຄຳຂໍຊຳລະ
  4. 4ສົ່ງຕໍ່ໄປໜ້າຊຳລະທີ່ໂຮສໃຫ້
  5. 5ກວດລາຍເຊັນ Webhook
  6. 6ກະທົບຍອດລາຍງານຊຳລະຍອດ

ໂມເດວຄວາມປອດໄພ

HMAC
  • WQN bearer API keys ຈະອອກໃຫ້ຫຼັງຈາກ document review approval ເທົ່ານັ້ນ.
  • Provider credentials ຢູ່ຝັ່ງ server ແລະບໍ່ສົ່ງໄປ merchant browsers.
  • Signed webhooks ພ້ອມ timestamp tolerance ແລະ replay protection.
  • Hosted checkout ເກັບ raw card ຫຼື wallet details ອອກຈາກ merchant systems.

Endpoints

REST
ພາບລວມ WQN Gateway API v1 endpoints.
MethodPathການໃຊ້ງານ
POST /api/v1/payments ສ້າງການຊຳລະແບບ live hosted-checkout ຜ່ານ WQN key ແລະເສັ້ນທາງ OneCloudPay
GET /api/v1/payments ສະແດງລາຍການຊຳລະຫຼ້າສຸດຂອງ merchant API key ທີ່ຢືນຢັນແລ້ວ
GET /api/v1/payments/{id} ອ່ານສະຖານະການຊຳລະ, checkout URL ແລະເລກອ້າງອີງຜູ້ໃຫ້ບໍລິການ
GET /api/v1/wallet ອ່ານຍອດກະເປົາເງິນຮ້ານຄ້າ ແລະລາຍການ ledger ຫຼ້າສຸດ
GET /api/v1/bank-accounts ສະແດງບັນຊີທະນາຄານແບບປິດບັງເລກທີ່ຜູກກັບ merchant
GET /api/v1/kyc ອ່ານສະຖານະໂປຣໄຟລ໌ KYC/KYB ຂອງຮ້ານຄ້າ
GET /api/v1/withdrawals ສະແດງຄຳຂໍຖອນເງິນຂອງຮ້ານຄ້າ
POST /api/v1/withdrawals ສ້າງຄຳຂໍຖອນເງິນ ແລະລັອກຍອດເພື່ອໃຫ້ຝ່າຍຈັດການອະນຸມັດ
GET /api/v1/settlements ສະແດງຊຸດຊຳລະຍອດຂອງຮ້ານຄ້າ
GET /api/v1/reports/summary ອ່ານຍອດລວມການຊຳລະ, wallet, settlement ແລະ withdrawal
GET /api/v1/notifications ສະແດງການແຈ້ງເຕືອນຂອງຮ້ານຄ້າ
GET /api/v1/support-tickets ສະແດງ support tickets ທີ່ຮ້ານຄ້າເປີດໄວ້
POST /api/v1/support-tickets ເປີດຄຳຂໍຊ່ວຍເຫຼືອສຳລັບ API, settlement, webhook ຫຼືບັນຫາການຊຳລະ
GET /api/v1/payment-links ສະແດງລິ້ງຊຳລະຂອງຮ້ານຄ້າ
GET /api/v1/qr-codes ສະແດງລະຫັດ QR ຊຳລະຂອງຮ້ານຄ້າ
GET /api/v1/webhooks ສະແດງ webhook endpoints ທີ່ຮ້ານຄ້າຕັ້ງຄ່າໄວ້
POST /v1/checkout/sessions ແນວທາງ session ໜ້າຊຳລະ Hosted ສຳລັບການສົ່ງຕໍ່ provider ໃນອະນາຄົດ
POST /v1/provider-routes/2c2p ເລືອກເສັ້ນທາງຮູບແບບ 2C2P ສຳລັບບັດ, wallet, QR, BNPL ຫຼື counter payment
POST /v1/providers/2c2p/payment-token ສ້າງ provider session token ກ່ອນ redirect, direct ຫຼື SDK payment
POST /v1/providers/2c2p/webhook ຮັບ provider notification ທີ່ເຂົ້າລະຫັດ/ມີລາຍເຊັນ ແລະ normalize ເປັນ WQN event
POST /v1/refunds ສ້າງຄຳຂໍຄືນເງິນເຕັມ ຫຼືບາງສ່ວນ
POST /v1/payments/{id}/cancel ຍົກເລີກ ຫຼື void provider transaction ທີ່ຍັງລໍຖ້າໄດ້
POST /v1/webhooks/test ສົ່ງ test webhook ທີ່ມີລາຍເຊັນໄປຫາ endpoint ຂອງ merchant
GET /v1/settlements ສະແດງ settlement batches ແລະ reconciliation files

ຕົວຢ່າງຄຳຂໍ

curl -X POST "https://gateway.wqnwqn.com/api/v1/payments" \
  -H "Authorization: Bearer wqn_sk_REPLACE_WITH_SECRET" \
  -H "Idempotency-Key: ORDER-1001-create" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50,
    "currency": "USD",
    "merchant_reference": "ORDER-1001",
    "description": "Order 1001",
    "return_url": "https://merchant.example.com/success",
    "cancel_url": "https://merchant.example.com/cancel"
  }'

ຕົວຢ່າງຄຳຕອບ

{
  "data": {
    "id": "wqn_pay_9a41c20bd1ee4552",
    "object": "payment",
    "status": "pending",
    "amount": 50,
    "currency": "USD",
    "merchant_reference": "ORDER-1001",
    "checkout_url": "https://gateway.wqnwqn.com/sandbox/checkout/...",
    "provider": "sandbox",
    "provider_payment_id": "pay_test_provider_..."
  }
}

ຂັ້ນຕອນສົ່ງ Webhook

ຄູ່ມືຄວາມປອດໄພ
  1. 1ຮັບ ແລະຢືນຢັນ provider event
  2. 2Normalize provider status ເປັນ WQN event
  3. 3ບັນທຶກ event ແບບ idempotent
  4. 4ລົງລາຍເຊັນ merchant webhook payload
  5. 5ສົ່ງ, ບັນທຶກ response ແລະ retry ຢ່າງປອດໄພ

ໝາຍເຫດຄວາມປອດໄພ Webhook

ຈຳເປັນ
  • ກວດ HMAC SHA-256 signature ກັບ raw request body.
  • ປະຕິເສດ stale timestamps ແລະເກັບ processed event IDs ເພື່ອກັນ replay.
  • ສົ່ງ successful response ຫຼັງຈາກ durable processing ຫຼື queueing ເທົ່ານັ້ນ.
  • ຮັບມື duplicate ແລະ out-of-order events ໂດຍບໍ່ເຮັດໃຫ້ payment state ຜິດ.
  • Retry transient failures ດ້ວຍ bounded exponential backoff.

ສ້າງດ້ວຍຄວາມໝັ້ນໃຈ

ສຳຫຼວດ API, ຈຳລອງຜົນການຊຳລະ ແລະກຽມ checklist ຄວາມພ້ອມ production ໃຫ້ຊັດເຈນ.
ເລີ່ມໃນ Sandbox ຕິດຕໍ່ຝ່າຍຊ່ວຍເຫຼືອ