DigiZay Reseller API Reference

DigiZay Reseller API ကို ဘာအတွက် သုံးလဲ?

Wallet balance နဲ့ DigiZay ပစ္စည်းစာရင်းကို စက်အလိုအလျောက် ဝယ်ယူပြီး order result ပြန်ယူဖို့ သုံးပါတယ်။ အရင်ဆုံး GET /services ကိုခေါ်ပြီး response ထဲက လက်ရှိ product ID နဲ့ stock ကို သုံးပါ။ Store မှာ မရောင်းတဲ့ ပစ္စည်း (wallet မလုံ / SoftwarePays stock ပိတ်) ဒီစာရင်းမှာလည်း မပါပါ။

Base URL နဲ့ Authentication

Base URL က https://digizay.com/api/v1 ဖြစ်ပြီး request တိုင်းမှာ X-Api-Key: dz_your_key_here header ပို့ရပါတယ်။ API key ကို Telegram store သို့မဟုတ် Dashboard API tab မှာ တစ်ကြိမ်သာ ရယူနိုင်ပါတယ်။

Reseller REST also accepts Authorization: Bearer dz_.... Keep keys out of URLs.

AI assistants (MCP)

Manually connect to https://digizay.com/api/shop/mcp using Streamable HTTP. Guests need no key. Optional Authorization: Bearer dzm_... from Dashboard > API links orders to your account and cannot spend wallet balance. MCP purchases use MMQR after explicit confirmation. See the Shopping MCP setup guide.

အဓိက endpoints

• GET /balance — လက်ရှိ Wallet balance
• GET /services — ဝယ်နိုင်တဲ့ product ID၊ စျေးနှုန်းနဲ့ stock
• POST /order — product, qty နဲ့ လိုအပ်ရင် phone ပို့ပြီး order တင်ရန် (ATOM 097… / Mytel 096…)
• GET /order/:code — ကိုယ့် order status နဲ့ result စစ်ရန်

POST /order ကို JSON body ဖြင့် ပို့ပြီး ဝယ်ယူမှုတိုင်းမှာ မတူညီတဲ့ Idempotency-Key header ထည့်ပါ။ Retry လုပ်ရင် မူလ key နဲ့ parameters အတူတူကို ပြန်သုံးပါ။ Order processing ဖြစ်နေစဉ် အသစ်ထပ်မဝယ်ဘဲ GET /order/:code ဖြင့် စစ်ပါ။

Request limit က API key အလိုက် တစ်မိနစ်လျှင် default 60 ကြိမ်ဖြစ်ပြီး 429 response ရရင် Retry-After အတိုင်း စောင့်ပြီး ပြန်ခေါ်ပါ။