Payment API Documentation

Integrate our payment verification system into your application

Dynamic API Overview

Both APIs are full-featured — they support the same parameters (products, discount, charge, etc). The difference is only which payment page URL the customer sees:

POST /pay.php → /pay/{order_id} POST /payment.php → /payment/{order_id}

Both APIs support the FULL feature set: products, discount, charge, currency, currency_rate, customer info, references, etc. The only difference is the endpoint and the resulting payment URL. The visual design the customer sees is controlled by the store's theme_1 / theme_2 settings.

POST

Theme 1 API - Create Payment

/pay.php

Full-featured — generates payment URL at /pay/{order_id}

https://epay.corp.com.bd/pay.php

Parameters

Parameter	Required	Description	Example
`store_key`	Required	Your store key	`C9065B5327F0`
`amount`	Required	Payment amount	`100.00`
`success_url`	Required	Success URL	`https://site.com/success`
`error_url`	Required	Error URL	`https://site.com/error`
`products`	Optional	JSON array of products	`[{"name":"VIP","price":250,"quantity":1,"icon":"fa-gem"}]`
`discount`	Optional	Discount amount	`50.00`
`charge`	Optional	Extra charge	`10.00`
`currency`	Optional	BDT / USD / USDT	`USD`
`currency_rate`	Conditional	Required for USD/USDT	`130`
`reference`	Optional	Store reference	`Order #123`
`reference_id`	Optional	Your internal order ID	`ORD-2026-001`
`cancel_url`	Optional	Cancel URL	`https://site.com/cancel`
`customer_name`	Optional	Customer name	`John Doe`
`customer_email`	Optional	Customer email	`john@example.com`
`customer_phone`	Optional	Customer phone	`01712345678`

Example cURL

# Theme 1 API — Full featured example
curl -X POST https://epay.corp.com.bd/pay.php \
  -d "store_key=C9065B5327F0" \
  -d "amount=610" \
  -d "success_url=https://yourdomain.com/success" \
  -d "error_url=https://yourdomain.com/error" \
  -d "discount=50" \
  -d "charge=10" \
  -d 'products=[
    {"name":"VIP Membership","price":250,"quantity":1,"icon":"fa-gem"},
    {"name":"Cloud Storage 100GB","price":150,"quantity":2,"icon":"fa-cloud"},
    {"name":"Premium Support","price":100,"quantity":1,"icon":"fa-headset"}
  ]' \
  -d "reference_id=ORD-2026-001" \
  -d "customer_name=John Doe" \
  -d "customer_email=john@example.com" \
  -d "customer_phone=01712345678"

✅ Theme 1 Success Response:

{
    "status": "success",
    "payment_url": "https://epay.corp.com.bd/pay/EBPAY7XK9M2Q",
    "order_id": "EBPAY7XK9M2Q",
    "reference_id": "ORD-2026-001",
    "amount": 610.00,
    "discount": 50.00,
    "charge": 10.00,
    "products": [...],
    "store_name": "My Store",
    "currency": "BDT"
}

POST

🌟 Theme 2 API - Create Payment

/payment.php

Full-featured — generates payment URL at /payment/{order_id}

https://epay.corp.com.bd/payment.php

🌟 Theme 2 API - Parameters (SAME as Theme 1)

Parameter	Required	Description	Example
`store_key`	Required	Your store key	`C9065B5327F0`
`amount`	Required	Payment amount	`100.00`
`success_url`	Required	Success URL	`https://site.com/success`
`error_url`	Required	Error URL	`https://site.com/error`
`products`	Optional	JSON array of products	`[{"name":"VIP","price":250,"quantity":1,"icon":"fa-gem"}]`
`discount`	Optional	Discount amount	`50.00`
`charge`	Optional	Extra charge	`10.00`
`currency`	Optional	BDT / USD / USDT	`USD`
`currency_rate`	Conditional	Required for USD/USDT	`130`
`reference`	Optional	Store reference	`Order #123`
`reference_id`	Optional	Your internal ID	`ORD-2026-001`
`cancel_url`	Optional	Cancel URL	`https://site.com/cancel`
`customer_name`	Optional	Customer name	`John Doe`
`customer_email`	Optional	Customer email	`john@example.com`
`customer_phone`	Optional	Customer phone	`01712345678`

📦 Product Fields

name *Required

Product name

"VIP Membership"

price *Required

Product price

250.00

quantity Optional

Quantity (default: 1)

2

icon Optional

FA icon or URL

"fa-gem" or "https://site.com/logo.png"

Example cURL

# Theme 2 API — Same features as Theme 1
curl -X POST https://epay.corp.com.bd/payment.php \
  -d "store_key=C9065B5327F0" \
  -d "amount=610" \
  -d "success_url=https://yourdomain.com/success" \
  -d "error_url=https://yourdomain.com/error" \
  -d "discount=50" \
  -d "charge=10" \
  -d 'products=[
    {"name":"VIP Membership","price":250,"quantity":1,"icon":"fa-gem"},
    {"name":"Cloud Storage 100GB","price":150,"quantity":2,"icon":"fa-cloud"},
    {"name":"Premium Support","price":100,"quantity":1,"icon":"fa-headset"}
  ]' \
  -d "reference_id=ORD-2026-001"

🌟 Theme 2 Success Response:

{
    "status": "success",
    "payment_url": "https://epay.corp.com.bd/payment/EBPAY7XK9M2Q",
    "order_id": "EBPAY7XK9M2Q",
    "reference_id": "ORD-2026-001",
    "amount": 610.00,
    "discount": 50.00,
    "charge": 10.00,
    "products": [...],
    "store_name": "My Store",
    "currency": "BDT"
}

GET

Check Order Status

Public - No API Key Required

https://epay.corp.com.bd/api.php?order_id={ORDER_ID}

✅ Paid Response:

{
    "status": "success",
    "order_id": "EBPAY7XK9M2Q",
    "reference_id": "ORD-2026-001",
    "amount": 100.00,
    "order_status": "paid",
    "trxid": "DG340IXYFY",
    "paid": true,
    "message": "Payment verified successfully"
}

Static API Overview

Verify payments using API key + MFS + amount + trxid.

GET /api.php ⚠️ API Key Required

Static API Parameters

Parameter	Required	Description	Example
`api_key`	Required	Your API key	`a1b2c3d4...`
`mfs`	Required	Gateway keyword	`bkash`
`bdt`	Required	Amount in BDT	`100.00`
`trxid`	Required	Transaction ID	`DG340IXYFY`
`type`	Optional	sendmoney/payment/cashout	`sendmoney`
`reference_id`	Optional	Your internal order ID	`ORD-2026-001`

Gateway Reference

Gateway	mfs	Types
bKash MFS	`bkash`	sendmoney payment cashout
BkashBQR BanglaQR	`bkashbqr`	(auto-detected)
DGePay BanglaQR BanglaQR	`dgepay`	(auto-detected)
InternationalCard MFS	`ecard`	sendmoney payment cashout
MTB Bank BanglaQR	`mtb`	(auto-detected)
Nagad MFS	`nagad`	sendmoney payment cashout
PathaoPay BanglaQR	`pathaopay`	(auto-detected)
Paystation MFS	`paystation`	sendmoney payment cashout
Pubali Bank BanglaQR	`pubalibank`	(auto-detected)
Rocket MFS	`rocket`	sendmoney payment cashout
TallyPay BanglaQR	`tallypay`	(auto-detected)
Upay MFS	`upay`	sendmoney payment cashout

Secured by Payment Gateway System • Powered by EcomBangla

API Version 2.0 • Last Updated: October 11, 2026