API های بابَرکت
با استفاده از API های بابَرکت میتوانید خرید شارژ، بستههای اینترنت، ارسال پیامک و واتساپ و پیگیری تراکنشها را به سادگی در سرویس خود پیادهسازی کنید.
شروع کار با API
برای استفاده از API های بابَرکت ابتدا باید در سامانه ثبتنام کرده و اطلاعات دسترسی خود را دریافت کنید.
Authorization: Bearer YOUR_TOKEN
دریافت اطلاعات پروفایل
دریافت اطلاعات حساب، موجودی و کلید اختصاصی
https://pay.babarkat.com/user/info
این درخواست اطلاعات حساب شما شامل نام، موبایل، کلید اختصاصی و موجودی کیف پول را برمیگرداند.
{
"data": {
"name": "نام",
"last_name": "نام خانوادگی",
"description": "",
"mobile": "09***",
"appKey": "xxxxxxxxxxxxxxxxxxxxxx",
"toman": 10000
},
"success": true
}
| پارامتر | توضیح |
|---|---|
name |
نام کاربر |
last_name |
نام خانوادگی |
mobile |
شماره موبایل ثبتشده |
appKey |
کلید اختصاصی برای انجام تراکنشها |
toman |
موجودی کیف پول به تومان |
خرید شارژ
ثبت تراکنش خرید شارژ سیمکارت
https://pay.babarkat.com/transaction/charge/add
این متد برای خرید شارژ خطوط تلفن همراه استفاده میشود.
پارامترهای ورودی
| پارامتر | نوع | توضیح |
|---|---|---|
appKey |
string | کلید اختصاصی دریافتشده از پروفایل |
type |
string | MTN، MCI، RTL یا SHT |
mobile |
string | شماره موبایل دریافتکننده |
value |
number | مبلغ شارژ به تومان |
otherData |
object | اطلاعات دلخواه برای لاگ و پیگیری |
{
"appKey": "کلید اختصاصی شما",
"type": "MTN",
"mobile": "09*****",
"value": 5000,
"otherData": {
"test": "545454545",
"array": [
"aaa"
]
}
}
پاسخ موفق
{
"data": {
"message": "خرید با موفقیت انجام شد",
"id": 1,
"otherData": {
"test": "545454545",
"array": ["aaa"]
},
"charge": {
"success": true,
"trackingId": 10,
"ref_id": 2,
"message": "خرید موفق بود",
"code": 1
}
},
"success": true
}
success
برابر
false
خواهد بود و پیام خطا در
data.message
قرار میگیرد.
{
"data": {
"message":
"مبلغ برای اپراتور MTN باید بین 1000 تا 200000 تومان باشد."
},
"success": false
}
خرید شارژ افغانستان
خرید شارژ از موجودی افغانی
https://pay.babarkat.com/transaction/charge/afghanistan/add
برای خرید شارژ خطوط افغانستان استفاده میشود و مبلغ از موجودی افغانی شما کسر خواهد شد.
{
"appKey": "کلید اختصاصی شما",
"mobile": "09*****",
"value": 100,
"otherData": {
"test": "545454545",
"array": ["aaa"]
}
}
پاسخ موفق
{
"data": {
"message": "خرید با موفقیت انجام شد",
"id": 1,
"otherData": {
"test": "545454545",
"array": ["aaa"]
},
"charge": {
"success": true,
"code": 1
}
},
"success": true
}
دریافت لیست بستههای اینترنت
دریافت بستههای فعال اپراتورهای مختلف
https://pay.babarkat.com/transaction/internet/list
دریافت لیست کامل بستههای اینترنت فعال از ایرانسل، همراه اول، رایتل و شاتل.
Body
{
"appKey": "کلید اختصاصی شما"
}
پاسخ موفق
{
"success": true,
"data": {
"list": [
{
"table_id": "19357",
"product_type": "internet",
"operator": "SHT",
"name": "2 ساعته - 4 گیگابایت",
"product_id": "854",
"gross_price": 12000,
"amount": 13200,
"periodicity": "hourly",
"days": "0",
"volume": "4",
"unit": "GB",
"sim_type": "credit",
"course": "full-time",
"type": "معمولی",
"amount_rial": 132000,
"gross_price_rial": 120000,
"internet_type": "hourly"
}
]
}
}
خرید بسته اینترنت
خرید بسته اینترنت برای شماره موبایل
https://pay.babarkat.com/transaction/internet/add
با استفاده از شناسه بسته دریافتشده از API لیست بستهها، میتوانید بسته اینترنت موردنظر را خریداری کنید.
| پارامتر | توضیح |
|---|---|
appKey |
کلید اختصاصی دریافتشده از پروفایل |
type |
MTN، MCI، RTL، SHT |
mobile |
شماره موبایل دریافتکننده |
internet_type |
hourly، daily، monthly، TDLTE و... |
sim_type |
credit یا permanent |
product_id |
شناسه بسته اینترنت |
otherData |
اطلاعات دلخواه برای پیگیری |
{
"appKey": "xxxxxxxxx",
"type": "MTN",
"mobile": "09*****",
"internet_type": "hourly",
"sim_type": "credit",
"product_id": "854",
"otherData": {
"order_id": "123456"
}
}
پاسخ موفق
{
"success": true,
"data": {
"message": "خرید با موفقیت انجام شد",
"id": 123,
"otherData": {
"order_id": "123456"
},
"charge": {
"success": true,
"trackingId": 987654,
"ref_id": 112233,
"message": "خرید موفق بود",
"code": 1
}
}
}
success: false
پاسخ داده میشود.
بسته اینترنت افغانستان
دریافت لیست بستهها و خرید بسته اینترنت اپراتورهای افغانستان
https://pay.babarkat.com/transaction/internet/afghanistan/list
۱. دریافت لیست بستهها
لیست بستههای اینترنت اپراتور انتخابشده را دریافت میکند. لیست در سمت سرویس کش میشود و هر ۱۲ ساعت یکبار بهروزرسانی میشود.
| پارامتر | نوع | توضیح |
|---|---|---|
appKey | string | کلید اپلیکیشن؛ همان کلید مورد استفاده برای شارژ افغانستان |
type | string | اپراتور: etisalat، atoma، roshan، awcc یا salam |
Body
{
"appKey": "YOUR_APP_KEY",
"type": "etisalat"
}
پاسخ موفق
{
"success": true,
"data": {
"list": [
{
"id": 1,
"type": "etisalat",
"package_id": 12,
"name": "550 MB هفته وار",
"amount": 56,
"validity": "Weekly",
"last_updated_at": "2026-10-08 10:00:00"
}
]
}
}
| فیلد | توضیح |
|---|---|
id | شناسه داخلی رکورد در لیست |
package_id | شناسه بسته برای خرید؛ در درخواست خرید از این فیلد استفاده کنید |
name | نام بسته |
amount | قیمت بسته به افغانی (AFN) |
validity | مدت اعتبار بسته |
last_updated_at | زمان آخرین بهروزرسانی اطلاعات بسته |
package_id استفاده کنید، نه id.
خرید فقط برای بستههای موجود در لیست امکانپذیر است.
https://pay.babarkat.com/transaction/internet/afghanistan/add
۲. خرید بسته اینترنت
برای خرید، شماره موبایل افغانستان و شناسه package_id
را از آخرین لیست بستهها ارسال کنید.
| پارامتر | نوع | الزامی | توضیح |
|---|---|---|---|
appKey | string | بله | کلید اپلیکیشن |
package_id | number | بله | شناسه بسته از لیست، نه فیلد id |
mobile | string | بله | شماره موبایل گیرنده در افغانستان |
otherData | object | خیر | اطلاعات دلخواه برای ذخیره و پیگیری تراکنش |
tableId | number | خیر | شناسه دلخواه جهت ذخیره کنار تراکنش |
Body
{
"appKey": "YOUR_APP_KEY",
"package_id": 12,
"mobile": "07821234567",
"otherData": {
"order_id": "123"
},
"tableId": 55
}
پاسخ موفق
{
"success": true,
"data": {
"id": 12345,
"message": "خرید با موفقیت انجام شد",
"otherData": {
"order_id": "123"
},
"charge": {
"success": true,
"code": "1",
"trackingId": "REF-9f8e7d..."
}
}
}
| فیلد | توضیح |
|---|---|
data.id | شناسه تراکنش در سامانه بابَرکت؛ برای پیگیری نگه دارید |
data.charge.code | مقدار رشتهای "1" به معنی خرید موفق است |
data.charge.trackingId | کد رهگیری اپراتور |
پاسخ ناموفق
{
"success": false,
"data": {
"message": "موجودی شما کافی نیست"
}
}
پیامهای خطا
| پیام | توضیح |
|---|---|
| appKey نامعتبر | کلید اپلیکیشن معتبر نیست |
| امکان خرید برای شما ممکن نیست | دسترسی خرید برای حساب فعال نیست |
| پکیج یافت نشد - لیست بستهها را بگیرید | بسته در لیست فعلی وجود ندارد؛ لیست را دوباره دریافت کنید |
| موجودی شما کافی نیست | موجودی افغانی کافی نیست |
| شماره موبایل معتبر نیست | شماره گیرنده معتبر نیست |
| خرید بسته ناموفق | جزئیات اصلی خطا در data.charge.error و پیام اپراتور در data.charge.message قرار دارد |
| خرید در انتظار | وضعیت خرید در انتظار است |
ارسال پیامک OTP
ارسال پیامک با قالب اختصاصی
https://pay.babarkat.com/sms/send/otp
Headers
Authorization: xxxxx.xxxxx.xxxx Content-Type: application/json
Body
{
"appKey": "xxxxxxxxx",
"mobile": "09150000000",
"template": "tempname",
"token": "20",
"token2": "1",
"token3": "2"
}
پاسخ موفق
{
"success": true,
"data": {
"message": "پیامک با موفقیت ارسال شد"
}
}
پاسخ خطا
{
"success": false,
"data": {
"message": "خطا در ارسال پیامک یا ذخیره اطلاعات"
}
}
| پارامتر | وضعیت | توضیح |
|---|---|---|
appKey |
اجباری | کلید اختصاصی اپلیکیشن |
mobile |
اجباری | شماره گیرنده با 09 یا +98 |
template |
اجباری | نام قالب پیامک |
token |
اجباری | متغیر اول پیامک |
token2 |
اختیاری | متغیر دوم پیامک |
token3 |
اختیاری | متغیر سوم پیامک |
ارسال WhatsApp OTP
ارسال پیام واتساپ با قالب اختصاصی
https://pay.babarkat.com/whatsapp/send/by/template
Headers
Authorization: xxxxx.xxxxx.xxxx Content-Type: application/json
Body
{
"appKey": "xxxxxxxxx",
"mobile": "989159999999",
"template": "tempname",
"token": "20",
"token2": "1",
"token3": "2"
}
پاسخ موفق
{
"success": true,
"data": {
"message": "پیام واتساپ با موفقیت ارسال شد"
}
}
پاسخ خطا
{
"success": false,
"data": {
"message": "ارسال پیام با خطا مواجه شد"
}
}
0
و
+
ارسال شود؛ مانند:
989159999999
پیگیری تراکنشها
دریافت حداکثر ۵۰ تراکنش اخیر
https://pay.babarkat.com/transaction/status
این API برای دریافت لیست تراکنشهای اخیر بر اساس شماره موبایل یا شماره میز استفاده میشود.
Headers
Authorization: Bearer YOUR_TOKEN Content-Type: application/json
Body
{
"appKey": "moa....",
"type": "mobile",
"data": "09037123456"
}
| پارامتر | مقادیر مجاز | توضیح |
|---|---|---|
appKey |
string | کلید اختصاصی اپلیکیشن |
type |
mobile / tableId | نوع جستجو |
data |
string | شماره موبایل یا شماره میز |
پاسخ موفق
{
"success": true,
"data": {
"list": [
{
"id": 14,
"isVisible": 0,
"tableId": null,
"price": 500,
"otherData":
"{\"test\":\"545454545\"}",
"code": 0,
"createdAt":
"2025-07-22 00:00:00"
}
]
},
"message":
"50 تراکنش اخیر شما"
}
نمونه cURL
curl -X POST https://pay.babarkat.com/transaction/status \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"appKey": "moa....",
"type": "mobile",
"data": "09037123456"
}'
otherData
به صورت JSON String برگردانده میشود.
در صورت نیاز باید آن را Decode کنید.
نکات مهم
نکات امنیتی و عمومی استفاده از API
active = 1
خواهد بود.
active = 0
به همراه جزئیات خطا ثبت میشود.