Deposit လိပ်စာနှင့် ငွေပေးချေမှုများ
Deposit လိပ်စာများ (deposit-address mode)
Order တစ်ခုစီအတွက် invoice အစား customer တစ်ယောက်စီကို အမြဲတမ်း လိပ်စာ တစ်ခု ပေးပါ (wallet ငွေဖြည့်ခြင်း၊ subscription လက်ကျန်၊ …)။ ပမာဏ မည်မျှမဆို၊ အချိန်မရွေး ပို့နိုင်သည်။ Invoice လည်းမရှိ၊ သက်တမ်းလည်း မရှိ — ငွေလွှဲမှုတိုင်းသည် customer ၏ id ပါသော payment တစ်ခု ဖြစ်ပြီး payment.* webhook များက သင့်ကို အသိပေးသည်။
ဖန်တီးခြင်း သို့မဟုတ် ရယူခြင်း — POST /v1/addresses (scope addresses:write)
| Field | |
|---|---|
customer_id | မဖြစ်မနေ၊ ပုံနှိပ်နိုင်သော စာလုံး ≤ 128 — customer အတွက် သင့် id |
metadata | object၊ invoice များကဲ့သို့ပင်။ လိပ်စာ ဖန်တီးချိန်တွင်သာ သိမ်းသည် |
customer_id အလိုက် idempotent ဖြစ်သည် (Idempotency-Key မလို) — ဤ call က လိပ်စာကို ဖန်တီးလိုက်လျှင် 201၊ မဟုတ်လျှင် ရှိပြီးသား လိပ်စာဖြင့် 200။ လိပ်စာသည် ကျပန်း key ကို သုံးသည် (သင့် customer id မှ ဆင့်ပွားထားခြင်း မဟုတ်)။
curl -sS "$API/v1/addresses" -H "Authorization: Bearer $POLYSIA_API_KEY" -H "Content-Type: application/json" \
-d '{"customer_id":"cust-1001"}'{"object":"address","id":"addr_…","customer_id":"cust-1001","address":"0x…","metadata":{},
"received":"0.000000","received_units":"0","received_detected":"0.000000","payment_count":0,
"network":"polygon","chain_id":137,"token":"0xc2132D05D31c914a87C6611C10748AEb04B58e8F","livemode":true,"created_at":"…"}ကြည့်ခြင်း / စာရင်း (scope payments:read)
GET /v1/addresses/{id}— စုစုပေါင်းများနှင့်တကွ:received(အတည်ပြုပြီး)၊received_detected၊payment_countGET /v1/addresses?customer_id=cust-1001(+limit၊starting_after)
Customer ၏ လက်ကျန်ထဲသို့ payment.detected တွင် မဟုတ်ဘဲ payment.confirmed (finalized) တွင်မှ ထည့်ပါ။ သင့်စာရင်းတွင် ထပ်နေခြင်း မဖြစ်စေရန် payment id (pay_…) ကို key အဖြစ် သုံးပါ။
ငွေပေးချေမှုများ (payments)
Invoice သို့မဟုတ် customer လိပ်စာသို့ USDT လွှဲမှုတိုင်းသည် payment တစ်ခု ဖြစ်သည်။
| Field | |
|---|---|
id, object | pay_…၊ "payment" |
status | detected (တွေ့ပြီ၊ မအတည်သေး) → confirmed (finalized) — သို့မဟုတ် orphaned (reorg ကြောင့် ပျက်သွား၊ လျစ်လျူရှုပါ) |
amount, amount_units | |
invoice | inv_… သို့မဟုတ် null |
address, address_id, customer_id | လက်ခံသော လိပ်စာ။ customer လိပ်စာဖြစ်လျှင် addr_… နှင့် သင့် customer id ပါ ပါသည် |
late | invoice ၏ အချိန်ပြင်ပ ပေးချေမှု (received တွင် မဟုတ်ဘဲ late_amount တွင် ရေတွက်သည်) |
tx_hash, log_index, block_number, block_time, from | on-chain အသေးစိတ် (from သည် ပို့သူ — exchange ဖြစ်နိုင်သည်) |
detected_at, confirmed_at |
GET /v1/payments/{id};GET /v1/payments?invoice=inv_…&address=0x…&status=confirmed&created[gte]=…(scopepayments:read)- Webhook
payment.detected၊payment.confirmed၊payment.orphaned— ဤ object ကိုdataအဖြစ် ပါသည်။