Workflow ການເຊື່ອມຕໍ່
WQN Gateway ເຮັດວຽກແນວໃດ
ຂັ້ນຕອນຕັ້ງແຕ່ການຮັບຮ້ານຄ້າເຂົ້າລະບົບ, KYC, ຂໍ້ມູນລະຫັດ API, ໜ້າຊຳລະ, ການສົ່ງຕໍ່ຜູ້ໃຫ້ບໍລິການ, Webhook ໄປຫາການຊຳລະຍອດ.
REST API
Webhook ມີລາຍເຊັນ
ໜ້າຊຳລະ Hosted
POST /v1/payments
Sandbox
amount128.00
currencyUSD
methodhosted_checkout
Merchant→WQN→Provider
✓
payment.succeededReady for webhook delivery
200
01ເລີ່ມຈາກ Sandboxທົດສອບຜົນກ່ອນ live onboarding
02ເຫດການປອດໄພHMAC signatures ແລະ replay protection
03ປະຕິບັດການຊັດເຈນທຸລະກຳ, ລາຍງານ ແລະຊຳລະຍອດເຫັນຊັດ
04ສົ່ງຕໍ່ພາກພື້ນຈັດການການຊຳລະທີ່ພ້ອມ provider
01Hosted checkout
ສົ່ງລູກຄ້າໄປຫາ payment experience ທີ່ຈັດການໃຫ້ ໂດຍເກັບຂໍ້ມູນຊຳລະທີ່ອ່ອນໄຫວອອກຈາກແອັບ merchant.
02Server API
ສ້າງ payment intents, ແນບ merchant references, ເລືອກ routes ແລະຮັບ normalized status updates ຈາກ backend.
03Payment links
ກຽມເສັ້ນທາງເບົາສຳລັບທີມທີ່ຕ້ອງການ shareable checkout ໂດຍບໍ່ສ້າງ front end ຄົບຊຸດ.
ເສັ້ນທາງການເຊື່ອມຕໍ່
ທີລະຂັ້ນ
- 1
ສ້າງບັນຊີ merchantMerchant ເຂົ້າລະບົບ, ກວດ business profile ແລະກຽມຂໍ້ມູນ KYC/KYB.
- 2
ສ້າງ sandbox keysໃຊ້ publishable ແລະ secret keys ຈາກໜ້າ API ຂອງສະມາຊິກ.
- 3
ສ້າງ payment intentສົ່ງ amount, currency, metadata ແລະ Idempotency-Key ຈາກ merchant server.
- 4
Redirect ໄປ checkoutລູກຄ້າເລືອກບັດ, QR, wallet, bank, BNPL ຫຼື counter payment.
- 5
ກວດ webhookValidate HMAC signature, timestamp, request ID ແລະ event status.
- 6
ກະທົບຍອດ settlementExport transactions, fees, holds ແລະ payout batches ຈາກ reports.
Provider routing
ພ້ອມ 2C2P
- WQN ສ້າງ internal payment intent ກ່ອນ.
- Provider adapter ຂໍ payment token ເມື່ອເລືອກເສັ້ນທາງ 2C2P.
- Payment options ຖືກກອງຕາມ market, currency, device, method ແລະ risk rules.
- Provider notification ຖືກ normalize ເປັນ WQN events ສຳລັບ merchant webhooks.
- Status inquiry, refund, cancel/void ແລະ reconciliation ຖືກຈັດການຈາກ protected operations workflows.
Normalized payment flow
Merchant integration ດຽວ ພ້ອມ provider handoffs ທີ່ຄວບຄຸມໄດ້.
1Merchantສ້າງ payment intent
→ 2WQN Gatewayກວດ, ສົ່ງຕໍ່, normalize
→ 3ProviderAuthorize payment method
→ 4Webhookສົ່ງ signed status
Developer checklist
ກ່ອນ live
- ໃຊ້ server-side secret keys ເທົ່ານັ້ນຈຳເປັນ
- ສົ່ງ Idempotency-Key ສຳລັບ mutating requestsຈຳເປັນ
- ກວດ webhook HMAC signatureຈຳເປັນ
- ທົດສອບ approved, review, declined, refund ແລະ cancel scenariosຈຳເປັນ
Go-live gates
ອະນຸມັດ
- Provider contract ແລະ credentialsລໍຖ້າ
- Compliance ແລະ PCI scope reviewລໍຖ້າ
- Settlement bank verificationລໍຖ້າ
- Risk rules ແລະ approvalsລໍຖ້າ