Developer API Docs

API URL, API Key
সব পরিষ্কার

User dashboard থেকে API key/secret generate করবে। Payment Verify API-তে শুধু key লাগে; Order API-তে HMAC signature লাগে।

API URLs

Order Automation API URL
https://www.ai.sushanto.xyz/api/automation/process-order.php

Payment Verify API URL
https://www.ai.sushanto.xyz/api/payment_verify/verify.php

SMS/App Report URL
https://www.ai.sushanto.xyz/api/payment_verify/app-report.php

Payment Webhook URL
https://www.ai.sushanto.xyz/api/payment-webhook.php?gateway=GATEWAY_CODE

1) Order Automation Request

Header:

Authorization: Bearer YOUR_API_KEY
X-Signature: HMAC_SHA256(raw_json_body, YOUR_API_SECRET)
Content-Type: application/json

Body:

{
  "order_id": "ORD10001",
  "target_site_id": 1,
  "player_uid": "123456789",
  "product_code": "FREEFIRE_100",
  "package_name": "100 Diamonds",
  "quantity": 1,
  "callback_url": "https://your-main-site.com/callback"
}

2) Payment Verify API

Customer/merchant তার API Key দিয়ে transaction verify করবে।

GET https://www.ai.sushanto.xyz/api/payment_verify/verify.php?key=YOUR_API_KEY&method=bkash&trx=TXN123456&amount=100

Response success হলে transaction used হয়ে যাবে, তাই একই TRX বারবার verify হবে না।

3) Android/SMS App Report API

Merchant phone app transaction SMS detect করে এখানে পাঠাবে।

POST https://www.ai.sushanto.xyz/api/payment_verify/app-report.phpHeader: X-App-Secret: YOUR_SMS_APP_SECRET

method=bkash
trx_id=TXN123456
amount=100
sender=01XXXXXXXXX
received_at=2026-07-08 16:00:00

4) Payment Gateway Webhook Format

{
  "payment_id": 12,
  "transaction_id": "TXN123456",
  "status": "PAID",
  "amount": 500
}