অথেনটিকেশন

প্রতিটি রিকোয়েস্টে হেডার দিন: X-API-Key: আপনার_API_Key

API Key পেতে: অ্যাকাউন্ট খুলে API Client হন, অ্যাডমিন অনুমোদন দিলে Admin > API Accounts থেকে Key তৈরি হবে। Key একবারই পুরো দেখানো হয় — হারিয়ে গেলে নতুন Key নিতে হবে।

নিরাপত্তা: IP Whitelist, Rate Limit (৬০ কল/মিনিট), দৈনিক লিমিট, সব কল api_logs-এ রেকর্ড হয়।

১. রিচার্জ — POST /api/v1/recharge

{
  "mobile": "01712345678",
  "amount": 100,
  "idempotency_key": "order-12345"
}

অফার কিনতে amount-এর বদলে package_id দিন। idempotency_key একই হলে ডাবল রিচার্জ হবে না।

{
  "status": "success",
  "transaction_id": "TT202611150001ABC",
  "operator": "Grameenphone",
  "amount": 100,
  "commission": 2,
  "mode": "simulated"
}

ফেইল হলে টাকা Main Balance-এ অটো রিফান্ড হয়।

২. ব্যালেন্স — GET /api/v1/balance

{
  "status": "success",
  "main_balance": 9850.00,
  "commission_balance": 120.50,
  "min_balance": 5000,
  "plan": "starter",
  "currency": "BDT"
}

৩. অফার — GET /api/v1/offers

/api/v1/offers?operator=Grameenphone&type=internet — রিয়েল-টাইম লিস্ট।

{
  "status": "success",
  "count": 2,
  "offers": [
    {"id": 1, "operator": "Grameenphone", "type": "internet",
     "title": "GP 10GB Internet — 30 দিন", "price": 249, "validity": "30 দিন"}
  ]
}

PHP / cURL উদাহরণ

<?php
$ch = curl_init('https://teletaka.fwalletpay.shop/api/v1/recharge');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode([
    'mobile' => '01712345678',
    'amount' => 100,
    'idempotency_key' => 'order-12345',
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'X-API-Key: YOUR_API_KEY',
  ],
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
var_dump($res);