← Social Gust Mm API v1

Recharge API

Bot များမှ User ၏ Social Gust Mm အကောင့်သို့ ငွေဖြည့်ရန် API။ Key များကို Admin ကိုယ်တိုင်သာ Admin Panel မှ ထုတ်ပေးနိုင်သည်။

⚠️ API Key သည် ငွေဖြည့်ခွင့်ရှိသော လျှို့ဝှက်ချက် ဖြစ်သည်။ Bot ၏ server ပေါ်တွင်သာ သိမ်းပါ။

၁။ Endpoint နှင့် Authentication

Request အားလုံးကို POST ဖြင့် ပို့ပါ။

POST https://YOUR-PROJECT.supabase.co/functions/v1/recharge-api

Key ကို header ဖြင့် ပို့ပါ (အကြံပြု)။

X-API-Key: rk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

၂။ Actions

recharge — User အကောင့်သို့ ငွေဖြည့်

Parameterလိုအပ်ရှင်းလင်းချက်
action✅recharge
email / user_id✅ တစ်ခုUser ၏ email သို့မဟုတ် user_id
amount✅ငွေပမာဏ (MMK) — ၀ ထက်ကြီးသော ကိန်းပြည့်
reference✅ငွေလွှဲ ID (ထပ်မနေရ)
{"action":"recharge","email":"user@example.com","amount":5000,"reference":"TG-20261022-0001"}

balance — User ၏ လက်ကျန်ကြည့်

{ "action": "balance", "email": "user@example.com" }
→ { "ok": true, "balance": 12500 }

၃။ Error များ

HTTPcodeအဓိပ္ပာယ်
401invalid_keyKey မမှန်ပါ
403key_disabledKey ကို ပိတ်ထားသည်
404user_not_foundကိုက်ညီသော user မရှိ
409reference_conflictreference ထပ်နေပြီ
429daily_limit_exceeded၂၄ နာရီ limit ပြည့်

၄။ ဥပမာ Code (cURL)

curl -X POST "$RECHARGE_URL" \
  -H "X-API-Key: $RECHARGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"recharge","email":"user@example.com","amount":5000,"reference":"TG-001"}'