ASTHAPAY API v2.0
API Overview & Architecture
আস্থাপে RESTful API আপনাকে বিকাশ, নগদ, রকেট এবং ব্যাংক অ্যাকাউন্ট পেমেন্ট প্রক্রিয়াকে আপনার যেকোনো অ্যাপ্লিকেশন, মোবাইল অ্যাপ বা ই-কমার্স স্টোরের সাথে নির্বিঘ্নে যুক্ত করতে সক্ষম করে।
JSON Payloads সকল রিকোয়েস্ট ও রেসপন্স স্ট্যান্ডার্ড UTF-8 JSON ফরম্যাটে পাঠানো হয়।
TLS 1.3 Encryption সকল কমিউনিকেশন হাই-গ্রেড HTTPS এনক্রিপশনের মাধ্যমে সুরক্ষিত থাকে।
Authentication (অথেনটিকেশন)
প্রতিটি API রিকোয়েস্টের সাথে আপনার মার্চেন্ট Brand API Key এবং API Secret প্রেরণ করতে হবে। এটি মার্চেন্ট প্যানেলের Brand Settings থেকে সংগ্রহ করা যাবে।
HEADER Content-Type: application/json
Request Headers Example
POST /api/checkout/create HTTP/1.1Host: asthapay.comContent-Type: application/jsonAccept: application/json
Create Checkout URL
Primary Endpoint গ্রাহকের জন্য একটি সুরক্ষিত পেমেন্ট ইনভয়েস সেশন ও ইউআরএল তৈরি করুন। রেসপন্সে প্রাপ্ত payment_url এ গ্রাহককে রিডাইরেক্ট করে দিলে সে বিকাশ, নগদ, রকেট বা কার্ডে টাকা প্রদান করতে পারবে।
POST https://asthapay.com/api/checkout/create
Request Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Required | আপনার মার্চেন্ট ব্র্যান্ড API Key |
| api_secret | string | Required | আপনার মার্চেন্ট ব্র্যান্ড API Secret |
| amount | float | Required | পেমেন্টের পরিমাণ (BDT তে, যেমন: 500.00) |
| order_id | string | Required | আপনার ওয়েবসাইটের ইউনিক অর্ডার আইডি (যেমন: ORD-10928) |
| customer_name | string | Optional | গ্রাহকের পুরো নাম |
| customer_email | string | Optional | গ্রাহকের ইমেইল অ্যাড্রেস |
| webhook_url | string | Required | পেমেন্ট সম্পন্ন হওয়ার পর কলব্যাক পাওয়ার ইনস্ট্যান্ট URL |
| redirect_url | string | Required | পেমেন্ট শেষে গ্রাহক যে পেইজে রিডাইরেক্ট হবে |
JSON Response Example (200 OK)
{ "status": "success", "message": "Payment checkout initialized successfully", "order_id": "ORD-10928", "amount": 500.00, "payment_url": "https://asthapay.com/pay/checkout/ORD-10928"} Instant Webhooks & IPN
গ্রাহক পেমেন্ট সফলভাবে সম্পন্ন করলে AsthaPay ক্লাউড ইঞ্জিন আপনার প্রদত্ত webhook_url এ তাৎক্ষণিকভাবে নিচের JSON পে-লোড পোস্ট করবে।
Webhook Payload (HTTP POST)
{ "status": "COMPLETED", "order_id": "ORD-10928", "transaction_id": "BL7890XKZ1", "amount": 500.00, "gateway_channel": "bkash", "sender_number": "01712345678", "paid_at": "2026-09-12 05:18:35"}