docs
ဤစာမျက်နှာတွင်

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
metadataobject၊ 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_count
  • GET /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, objectpay_…၊ "payment"
statusdetected (တွေ့ပြီ၊ မအတည်သေး) → confirmed (finalized) — သို့မဟုတ် orphaned (reorg ကြောင့် ပျက်သွား၊ လျစ်လျူရှုပါ)
amount, amount_units
invoiceinv_… သို့မဟုတ် null
address, address_id, customer_idလက်ခံသော လိပ်စာ။ customer လိပ်စာဖြစ်လျှင် addr_… နှင့် သင့် customer id ပါ ပါသည်
lateinvoice ၏ အချိန်ပြင်ပ ပေးချေမှု (received တွင် မဟုတ်ဘဲ late_amount တွင် ရေတွက်သည်)
tx_hash, log_index, block_number, block_time, fromon-chain အသေးစိတ် (from သည် ပို့သူ — exchange ဖြစ်နိုင်သည်)
detected_at, confirmed_at
  • GET /v1/payments/{id}; GET /v1/payments?invoice=inv_…&address=0x…&status=confirmed&created[gte]=… (scope payments:read)
  • Webhook payment.detected၊ payment.confirmed၊ payment.orphaned — ဤ object ကို data အဖြစ် ပါသည်။