ငွေပေးချေရန် စာမျက်နှာ (hosted payment page)
pay_url (https://<your domain>/pay/pt_…) သည် customer အတွက် အသင့်ပြင်ထားသော စာမျက်နှာ ဖြစ်သည်။ Customer ကို ထိုနေရာသို့ ပို့ပါ (redirect သို့မဟုတ် link)၊ သို့မဟုတ် invoice ၏ address + amount ကို သုံး၍ ကိုယ်ပိုင် စာမျက်နှာ ဆောက်ပါ။
Customer မြင်ရသောအရာ
- သင့် business အမည် (dashboard → API → Invoice settings → Name on the payment page၊ မထည့်ထားလျှင် business အမည်) နှင့် invoice ၏
description။ - ပမာဏ နှင့် လိပ်စာကို စာသားအဖြစ် — တစ်ခုစီတွင် Copy ခလုတ်ပါ၊ network သတိပေးချက် ("Polygon PoS ပေါ်ရှိ USDT ကိုသာ ပို့ပါ")၊
expires_atအထိ ရေတွက်ပြသော နာရီနှင့် QR code။ - အခြေအနေ တိုက်ရိုက်ပြခြင်း: ငွေပေးချေမှုကို စောင့်နေသည် → Y အနက် X ရရှိပြီ — လိပ်စာတူထံသို့ Z ထပ်ပို့ပါ (တစ်စိတ်တစ်ပိုင်း) → ငွေရရှိပြီ — အတည်ပြုနေသည် → ပေးချေပြီး ✓ (ထို့နောက် ၅ စက္ကန့်အကြာ သင့်
redirect_urlသို့ ပြန်သွားသည်၊ သို့မဟုတ် "ဆိုင်သို့ ပြန်သွားရန်" ခလုတ်)။ သက်တမ်းကုန် / ပယ်ဖျက် / ငွေမပြည့် စာမျက်နှာများနှင့် သက်တမ်းကုန်ပြီးနောက် အချိန်တွင် လိပ်စာကို ဖျောက်ထားသည် ("ငွေမပို့ပါနှင့်")။ - စာမျက်နှာသည် ၎င်း၏ အခြေအနေကို ၅ စက္ကန့်တိုင်း (၁၀ မိနစ်ကျော်လျှင် ၁၅ စက္ကန့်တိုင်း) မေးမြန်းပြီး တစ်ခုခု ပြောင်းလျှင် ပြန်ဖွင့်သည်။ JavaScript မရှိလျှင် ၁၅ စက္ကန့်တိုင်း refresh လုပ်ပြီး Copy ခလုတ်များကို ဖျောက်ထားသည် (စာသားကို ရွေးကူးနိုင်ဆဲ)။
ကိုယ်ရေးလုံခြုံမှုနှင့် လုံခြုံရေး
/pay/pt_…ထဲရှိ token သည် ကျပန်း 128 bit ဖြစ်ပြီး invoice id နှင့် သီးခြားဖြစ်သည် — invoice ကိုလည်း business ကိုလည်း မဖော်ပြပါ။ Link ရှိသူ မည်သူမဆို ထိုစာမျက်နှာကို ကြည့်နိုင်သဖြင့် invoice ကိုယ်တိုင်ကဲ့သို့ ဆက်ဆံပါ (public နေရာတွင် မတင်ပါနှင့်)။- စာမျက်နှာနှင့်
GET /pay/{token}/statusသည် business ပြသမည့်အမည်၊ description၊ ပမာဏ၊ လိပ်စာ၊ network၊ သက်တမ်း၊ အခြေအနေ နှင့် ရရှိပြီး စုစုပေါင်းကိုသာ ပြသည်။order_id၊metadata၊ id များ၊ ပေးချေသူ လိပ်စာများ သို့မဟုတ် key များကို ဘယ်တော့မှ မပြပါ။ - တင်းကျပ်သော Content-Security-Policy (ကိုယ်ပိုင် script / style / ပုံများသာ၊ third-party request မရှိ၊ web font မရှိ)၊ cookie ကို မဖတ်၊ မသတ်မှတ်ပါ။
- Embed လုပ်ခြင်း (iframe) ကို မူလအားဖြင့် ငြင်းသည် (
frame-ancestors 'none')။ သင့်ဆိုင်ထဲ ထည့်လိုလျှင် dashboard → API → Invoice settings → Allow embedding the payment page in တွင် သင့် https origin များကို ထည့်ပါ (အများဆုံး ၅ ခု)။
ဘာသာစကားများ
English နှင့် မြန်မာ။ ?lang=my / ?lang=en၊ မပါလျှင် browser ၏ ပထမ Accept-Language ကို သုံးသည်။ စာမျက်နှာပေါ်တွင် ဘာသာပြောင်းခလုတ် ပါသည်။ မြန်မာစာသည် Unicode (Zawgyi မဟုတ်) ဖြစ်ပြီး system font ကို သုံးသည် (Android: Noto Sans Myanmar၊ Windows: Myanmar Text၊ iOS/macOS: Myanmar Sangam MN)။ Zawgyi font သာရှိသော ဖုန်းများတွင် စာလုံးများ ပျက်ပြမည် — ၎င်းသည် ဖုန်း၏ setting ဖြစ်ပြီး စာမျက်နှာက ပြင်ပေး၍ မရပါ။
QR code များ
Wallet တစ်ခုချင်းစီ QR မှ ဖတ်ယူပုံ မတူသဖြင့် ပမာဏနှင့် လိပ်စာကို စာသားဖြင့်လည်း အမြဲ ပြထားသည်။
| QR | ပါဝင်သည့်အရာ | မှတ်ချက် |
|---|---|---|
| လိပ်စာသာ (မူလ) | 0x… | wallet အားလုံး ဖတ်နိုင်သည်။ Customer က Polygon ပေါ်ရှိ USDT ကို ရွေးပြီး ပမာဏ ရိုက်ထည့်ရသည် |
ပမာဏပါ (link "QR with amount (MetaMask only)"၊ ?qr=eip681) | EIP-681 ethereum:<USDT>@137/transfer?address=…&uint256=… | ထောက်ပံ့သော wallet များတွင် token + ပမာဏကို ဖြည့်ပေးသည်။ ဘာမှ မပေးချေရသေးချိန်တွင်သာ (တစ်စိတ်တစ်ပိုင်း ပေးချေပြီးလျှင် ပမာဏ ပြောင်းသွားသည်) |
မစတင်မီ သင့် customer များ သုံးသော wallet များဖြင့် QR ကို စမ်းကြည့်ပါ။ ကျွန်ုပ်တို့ စမ်းသပ်မှုတွင် MetaMask mobile က ပမာဏပါ QR မှ token နှင့် ပမာဏကို ဖြည့်ပေးပြီး SafePal က လိပ်စာ QR ကိုသာ နားလည်သည်။
GET /pay/{token}/status (public၊ စာမျက်နှာက သုံးသည်)
{"state":"partial","final":false,"amount":"25.00","received":"10.00","received_raw":"10000000",
"remaining":"15.00","expires_at":"2026-11-18T12:30:00Z","seconds_left":1234}state: waiting၊ partial၊ confirming၊ closing (သက်တမ်းကုန်ပြီး နောက်ဆုံးစစ်ဆေးမှု လုပ်နေဆဲ)၊ paid၊ overpaid၊ underpaid၊ expired၊ cancelled။ သင့် server ကမူ API / webhook များကို သုံးသင့်သည်။