PaySheba Merchant Portal

Merchant Account

Merchant ID: - Email: -

Account Active

Monthly Transaction Quota

0 / 20

Free Plan Limit: 20 Txns

Monthly Volume Limit

৳ 0 / ৳ 50,000

Free Plan Volume: ৳50,000

Monthly Invoice Creation Quota

0 / 50

Free Plan Limit: 50 Invoices

Android Gateway App Status

Connected

App SMS Listener Running

Recent Merchant Transactions

TrxID	Provider	Amount	Sender Mobile	Status	Date & Time	Action
No transactions recorded yet

Invoice ID	Amount	Customer	Status	Created Date	Actions
Loading invoices...

Dynamic Payment Gateway Numbers & Account Settings

Company / Store Branding & Password

Company / Store Name

Change Account Password (Leave blank to keep current)

Binance Pay (Internal Transfer) Settings

Active / Enable Binance Pay

Receive USDT internal transfers directly to your Binance Pay ID with automated API matching.

Binance Pay ID (Required)

Binance Read-Only API Key (Required)

Binance Secret Key (Required)

Custom 1 USDT Rate in BDT (Optional - Admin Default used if blank)

Webhook URL (Instant Payment Callback IPN)

Default Redirect Return URL

Customer Support Link (Telegram / WhatsApp / Support Link) This link will open when customers click the Support button on your checkout page.

Telegram Chat ID (Instant Payment Alert Bot)

👉 Step 1: Telegram-এ বটের সাথে চ্যাট স্টার্ট করুন: @paysheba_bot (বটে গিয়ে /start প্রেস করুন)
👉 Step 2: তারপর আপনার Telegram Chat ID (যেমন: 123456789) অথবা Username (যেমন: @your_username) ইনপুট দিয়ে Save Gateway Settings করুন এবং Test Telegram Alert প্রেস করুন!

Interactive Developer API & Payment Intents Hub

Standard SMSPayBD & UddoktaPay REST API references with multi-language code snippets.

POST /api/v1/checkout/create

Create a new payment intent and generate a customer checkout URL.

Request Body Parameters:

Field Name	Data Type	Required	Description
`amount`	`Number`	Yes	Payment charge amount in BDT (e.g. `500`).
`customer_name`	`String`	Optional	Full name of customer.
`customer_email`	`String`	Optional	Email address of customer.
`redirect_url`	`String`	Optional	URL to redirect customer upon payment completion.
`webhook_url`	`String`	Optional	URL to receive instant JSON IPN callback.

curl -X POST "https://paysheba.com/api/v1/checkout/create" \
  -H "Authorization: Bearer YOUR_MERCHANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "customer_name": "Rahim Ahmed",
    "customer_email": "rahim@example.com",
    "redirect_url": "https://yourstore.com/success",
    "webhook_url": "https://yourstore.com/api/paysheba-webhook"
  }'

Sample Response (200 OK):

{
  "status": true,
  "message": "Payment initialised successfully",
  "merchant_id": "MCH-777888",
  "charge_id": "CHG_0376DD2B4E",
  "payment_url": "https://paysheba.com/checkout.html?charge_id=CHG_0376DD2B4E"
}

POST /api/v1/checkout/status (Also supports GET)

Check payment status using only Invoice ID (No Provider or TrxID required). Returns complete customer, amount, method, and transaction details.

# 1. Using POST with JSON:
curl -X POST "https://paysheba.com/api/v1/checkout/status" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_id": "CHG_0376DD2B4E"
  }'

# 2. Or using GET query:
curl "https://paysheba.com/api/v1/checkout/status?invoice_id=CHG_0376DD2B4E"

Sample JSON Response (Status Inquiry):

{
  "status": true,
  "payment_status": "COMPLETED",
  "message": "Payment Successful",
  "invoice_id": "CHG_0376DD2B4E",
  "merchant_id": "MCH-777888",
  "tk_amount": 500.00,
  "usdt_amount": 4.17,
  "payment_method": "BKASH",
  "trx_id": "DGQ1QPFVOF",
  "sender": "017XXXXXXXX",
  "customer_name": "Tipu Sultan",
  "customer_email": "customer@example.com",
  "checkout_url": "https://paysheba.com/checkout.html?charge_id=CHG_0376DD2B4E",
  "redirect_url": "https://yoursite.com/payment-success",
  "created_at": "2026-08-19T05:04:00.000Z",
  "completed_at": "2026-08-19T05:05:00.000Z"
}

POST /api/v1/checkout/merchant (Also supports GET)

Fetch all active payment methods, phone numbers (bKash Personal/Merchant, Nagad, Rocket, Upay, CellFin), and Binance Pay ID for a specific Merchant using merchant_id.

# 1. Using POST with JSON:
curl -X POST "https://paysheba.com/api/v1/checkout/merchant" \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_id": "MCH-777888"
  }'

# 2. Or using GET query:
curl "https://paysheba.com/api/v1/checkout/merchant?merchant_id=MCH-777888"

Sample JSON Response (Merchant Available Methods & Numbers):

{
  "status": true,
  "merchant_id": "MCH-777888",
  "company_name": "ABC Store",
  "support_url": "https://t.me/yourtelegram",
  "usdt_rate": 120.0,
  "methods": [
    {
      "name": "bKash Personal",
      "provider": "BKASH",
      "type": "send_money",
      "number": "01799781726",
      "instruction": "Send Money to this personal bKash number and enter TrxID."
    },
    {
      "name": "bKash Merchant",
      "provider": "BKASH_MERCHANT",
      "type": "payment",
      "number": "01799781726",
      "instruction": "Make Payment to this bKash merchant counter number and enter TrxID."
    },
    {
      "name": "Nagad Personal",
      "provider": "NAGAD",
      "type": "send_money",
      "number": "01799781726",
      "instruction": "Send Money to this personal Nagad number and enter TrxID."
    },
    {
      "name": "Binance Pay",
      "provider": "BINANCE",
      "type": "crypto_usdt",
      "binance_pay_id": "578795699",
      "usdt_rate": 120.0,
      "instruction": "Send USDT to Binance Pay ID and submit your Binance Order ID."
    }
  ]
}

POST /api/v1/checkout/verify

Directly verify customer payment via API without opening the checkout page. Submit TrxID (for bKash, Nagad, Rocket, Upay, CellFin) or Order ID (for Binance Pay).

curl -X POST "https://paysheba.com/api/v1/checkout/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_id": "CHG_0376DD2B4E",
    "provider": "BKASH",
    "trx_id": "DGQ1QPFVOF"
  }'

Sample JSON Response (Direct Verification):

{
  "status": true,
  "payment_status": "COMPLETED",
  "message": "Payment Successful",
  "invoice_id": "CHG_0376DD2B4E",
  "merchant_id": "MCH-777888",
  "tk_amount": 500.00,
  "usdt_amount": 4.17,
  "payment_method": "BKASH",
  "trx_id": "DGQ1QPFVOF",
  "sender": "017XXXXXXXX",
  "customer_name": "Tipu Sultan",
  "customer_email": "customer@example.com",
  "checkout_url": "https://paysheba.com/checkout.html?charge_id=CHG_0376DD2B4E",
  "redirect_url": "https://yoursite.com/payment-success",
  "created_at": "2026-08-19T05:04:00.000Z",
  "completed_at": "2026-08-19T05:05:00.000Z"
}

Direct iFrame & Mobile App (WebView) Integration

মার্চেন্ট এপিআই কল করে পাওয়া সরাসরি payment_url লিংকটি আপনার নিজের ওয়েবসাইটের HTML iFrame ট্যাগে বসিয়ে দিন। কোনো জটিল স্ক্রিপ্ট ছাড়াই পেমেন্ট সম্পন্ন হওয়ার পর গ্রাহক স্বয়ংক্রিয়ভাবে আপনার redirect_url এ চলে যাবে!

পদ্ধতি ১: সরাসরি ওয়েব পেজে iFrame বসানো (Direct Page Embed):

আপনার ওয়েবসাইটের যেকোনো পেজে নিচে দেওয়া সাধারণ iFrame কোডটি পেস্ট করুন:

<!-- /api/v1/checkout/create থেকে পাওয়া payment_url টি src এ বসিয়ে দিন -->
<iframe 
  src="https://paysheba.com/checkout.html?charge_id=CHG_0376DD2B4E" 
  width="100%" 
  height="660px" 
  style="border: none; border-radius: 16px; box-shadow: 0 10px 30px rgba(0,0,0,0.08); max-width: 480px; display: block; margin: 0 auto;" 
  allow="clipboard-write">
</iframe>

পদ্ধতি ২: ওয়েবসাইটের উপরে পপ-আপ মোডাল (Simple Popup Modal):

যদি ওয়েবসাইটের উপরে পপ-আপ মোডাল হিসেবে দেখাতে চান, তাহলে নিচের সাধারণ HTML/CSS কোডটি ব্যবহার করুন:

<!-- ১. পপ-আপ মোডাল এইচটিএমএল -->
<div id="payshebaModal" style="display: none; position: fixed; inset: 0; background: rgba(15,23,42,0.75); backdrop-filter: blur(5px); z-index: 99999; justify-content: center; align-items: center; padding: 12px;">
  <div style="background: white; border-radius: 20px; width: 100%; max-width: 460px; height: 90vh; max-height: 680px; position: relative; overflow: hidden; box-shadow: 0 25px 50px rgba(0,0,0,0.3);">
    <button onclick="document.getElementById('payshebaModal').style.display='none'" style="position: absolute; top: 12px; right: 12px; z-index: 10; width: 32px; height: 32px; border-radius: 50%; border: 1px solid #e2e8f0; background: #f8fafc; font-weight: bold; cursor: pointer;">✕</button>
    <iframe id="payshebaIframe" src="" style="width: 100%; height: 100%; border: none;" allow="clipboard-write"></iframe>
  </div>
</div>

<!-- ২. পপ-আপ ওপেন করার সাধারণ স্ক্রিপ্ট -->
<script>
  function openPayModal(paymentUrl) {
    document.getElementById('payshebaIframe').src = paymentUrl;
    document.getElementById('payshebaModal').style.display = 'flex';
  }
</script>

<!-- ৩. পেমেন্ট বাটন -->
<button onclick="openPayModal('https://paysheba.com/checkout.html?charge_id=CHG_0376DD2B4E')">Pay ৳500 Now</button>

অটোমেটিক রিডাইরেক্ট (Zero Effort Redirect):
কাস্টমার পেমেন্ট সম্পন্ন করা মাত্রই PaySheba স্বয়ংক্রিয়ভাবে সম্পূর্ণ ব্রাউজার উইন্ডোটিকে আপনার ইনভয়েসে দেওয়া redirect_url লিংকে নিয়ে যাবে। আপনাকে কোনো অতিরিক্ত কোড বা ইভেন্ট হ্যান্ডলার লিখতে হবে না।

৩. মোবাইল অ্যাপ ইন্টিগ্রেশন (Flutter / React Native / Android WebView):

১. অ্যাপের ব্যাকএন্ড থেকে আপনার API Key দিয়ে /api/v1/checkout/create কল করে payment_url নিন।
২. অ্যাপের WebView কম্পোনেন্টে payment_url লিংকটি লোড করুন।
৩. পেমেন্ট শেষে ব্রাউজার স্বয়ংক্রিয়ভাবে redirect_url এ পৌঁছালে WebView ক্লোজ করুন এবং অর্ডার নিশ্চিতকরণ স্ক্রিন দেখান!

আপনার একাউন্টটি সাসপেন্ড করা হয়েছে!