Open Banking Gateway
تجريبية فقط

محفظة جوال · بنغلاديش

Nagad Customer API

محفظة Nagad الشخصية (بنغلاديش) — تسجيل دخول عبر PIN و OTP بالرسائل القصيرة مع خطوة اختيارية لتغيير الجهاز عبر ‎*167#‎، الرصيد، سجل المعاملات المُقسّم صفحات وتفاصيلها، التحقق من المستلم، معاينة الرسوم، تحويل الأموال P2P، وصيانة توفير/تحديث بيانات الاعتماد.

12 نقاط نهايةتجربة مجانية

بيئة تجريبية · الطلب

curl · POST /login/request-otp
curl -X POST 'https://www.openbankinggateway.com/api/sandbox/nagad-customer/login/request-otp' \
  -H 'Content-Type: application/json' \
  --data '{
  "account": "01900000002",
  "pinCode": "1234"
}'

مثال تجريبي توضيحي. لا يجري الاتصال بمزوّد، ولا تُرسل رسائل، ولا تُنقل أموال، ولا يُخصم رصيد.

مرجع الواجهة

تعرّف على الطلبات المتاحة.

الأساليب والمسارات وقواعد المعلمات من الدليل نفسه الذي يشغّل وحدة الاختبار. افتح نقطة نهاية لعرض حقولها.

مصادقة المحفظة

POST
/login/request-otp

Send the SMS OTP or signal the *167# device-change step

تجريبية فقط

/api/sandbox/nagad-customer/login/request-otp

POST login/request-otp · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
accountمطلوبstring

جسم JSON

استخدم محفظة مخوّلًا لك الوصول إليها. يجب ربط الهوية الفعلية بحساب الموقع عبر دخول المحفظة.

  • الصيغة: ^01\d{9}$
pinCodeمطلوبstring

جسم JSON

حساس · لا تضعه في الروابط

  • الصيغة: ^\d{4,6}$
POST
/login/verify-ussd-otp

Submit the *167# device-change USSD code

تجريبية فقط

/api/sandbox/nagad-customer/login/verify-ussd-otp

POST login/verify-ussd-otp · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
accountمطلوبstring

جسم JSON

استخدم محفظة مخوّلًا لك الوصول إليها. يجب ربط الهوية الفعلية بحساب الموقع عبر دخول المحفظة.

  • الصيغة: ^01\d{9}$
ussdOtpمطلوبstring

جسم JSON

حساس · لا تضعه في الروابط

  • الصيغة: ^\d{4,8}$
POST
/login/verify-otp

Verify the OTP and issue a session token

تجريبية فقط

/api/sandbox/nagad-customer/login/verify-otp

POST login/verify-otp · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
accountمطلوبstring

جسم JSON

استخدم محفظة مخوّلًا لك الوصول إليها. يجب ربط الهوية الفعلية بحساب الموقع عبر دخول المحفظة.

  • الصيغة: ^01\d{9}$
otpمطلوبstring

جسم JSON

حساس · لا تضعه في الروابط

  • الصيغة: ^\d{4,8}$
uidاختياريstring

جسم JSON

  • الصيغة: ^[A-Za-z0-9_-]{1,64}$

الحساب والنشاط

GET
/balance

Wallet balance

تجريبية فقط

/api/sandbox/nagad-customer/balance

GET balance · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$
GET
/transaction-history

Paged transaction history

تجريبية فقط

/api/sandbox/nagad-customer/transaction-history

GET transaction-history · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$
pageاختياريinteger

معلمة استعلام

  • النطاق: 0 … 1000
GET
/transaction-detail

Single transaction detail

تجريبية فقط

/api/sandbox/nagad-customer/transaction-detail

GET transaction-detail · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$
txnIdمطلوبstring

معلمة استعلام

  • الصيغة: ^[A-Za-z0-9]{4,32}$
approvalDateمطلوبstring

معلمة استعلام

  • الصيغة: ^\d{8}$

التحويلات

GET
/validate-account

Check that a recipient is a registered wallet

تجريبية فقط

/api/sandbox/nagad-customer/validate-account

GET validate-account · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$
destMobileمطلوبstring

معلمة استعلام

  • الصيغة: ^01\d{9}$
GET
/fee-commission

Preview fee, commission and net amount for a transfer

تجريبية فقط

/api/sandbox/nagad-customer/fee-commission

GET fee-commission · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$
destMobileمطلوبstring

معلمة استعلام

  • الصيغة: ^01\d{9}$
amountمطلوبdecimal

معلمة استعلام

  • النطاق: 1 … ∞
  • المنازل العشرية: 2
txTypeاختياريstring

معلمة استعلام

  • الصيغة: ^[A-Z_]{2,32}$
POST
/p2p

P2P send-money to another Nagad wallet

تجريبية فقط

/api/sandbox/nagad-customer/p2p

محاكاة تجريبية فقط. لا تتحرك أموال حقيقية، والتحويلات الفعلية غير مفعلة لهذا التكامل.

POST p2p · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$
destAccountNoمطلوبstring

جسم JSON

  • الصيغة: ^01\d{9}$
amountمطلوبdecimal

جسم JSON

  • النطاق: 1 … ∞
  • المنازل العشرية: 2
userRefMessageاختياريstring

جسم JSON

  • الطول: 0 … 64

صيانة الجلسة

POST
/refresh-card-data

Provision or refresh P2P payment credentials

تجريبية فقط

/api/sandbox/nagad-customer/refresh-card-data

POST refresh-card-data · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$
POST
/replenish-card

Refresh the transaction credential quota

تجريبية فقط

/api/sandbox/nagad-customer/replenish-card

POST replenish-card · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$
POST
/reinitialize-wallet

Re-provision an existing session for P2P

تجريبية فقط

/api/sandbox/nagad-customer/reinitialize-wallet

POST reinitialize-wallet · المعلمة
المعلمةالنوعالقواعد وطريقة الإرسال
tokenمطلوبstring

أرسل عبر X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

حساس · لا تضعه في الروابط

  • الصيغة: ^[A-Za-z0-9._~+/=-]{8,512}$

تُحفظ المعرّفات وأوصاف المزوّد المتخصصة بالإنجليزية لتطابق مواصفات الواجهة.

جرّب في البيئة التجريبية

طلب يمكنك فحصه.

تبدأ وحدة الاختبار بالوضع التجريبي؛ استخدم قيم الاختبار العامة فقط. التبديل للوضع الفعلي يغيّر الوجهة وقد يستخدم حسابات وأموالًا حقيقية.

بيئة تجريبية

افصل بين التجربة وصلاحيات الحساب والفوترة.

من أول طلب إلى الاتصال الفعلي.

  1. استكشف دون تسجيل الدخول

    اختر واجهة واستخدم قيم الاختبار الموثقة. البيانات التجريبية لا تحرّك الأموال ولا تتصل بالبنوك.

  2. أنشئ حسابك في المنصة

    سجّل الدخول عبر Google لتحصل على 1,000 رصيد وتنشئ مفتاح API. هذا دخول للموقع، لا للمحفظة.

  3. اتصل عندما تكون مستعدًا

    للواجهات الفعلية المدعومة، أكمل دخول المحفظة بشكل مستقل. كل طلب ناجح يكلّف رصيدًا واحدًا، والفشل لا يكلّف شيئًا.

1,000 رصيد ترحيبي · دون بطاقة

بداية بسيطة وتكلفة واضحة.

10 دولارات تشتري 10,000 رصيد. الطلب الفعلي الناجح يستهلك واحدًا، والفشل والتجربة لا يستهلكان رصيدًا. شراء الرصيد لا يفتح التكاملات التجريبية فقط.

اشترِ 10,000 رصيد

دليل التكامل

أضفه إلى تطبيقك.

الأمثلة التجريبية تستخدم قيمًا عامة، والفعلية تستخدم عناصر نائبة. احتفظ ببيانات الاعتماد على خادمك ولا تضعها في المستودع.

بيئة تجريبية

curl · POST
curl -X POST 'https://www.openbankinggateway.com/api/sandbox/nagad-customer/login/request-otp' \
  -H 'Content-Type: application/json' \
  --data '{
  "account": "01900000002",
  "pinCode": "1234"
}'

تجريبية فقط

الوصول المباشر غير مفعّل

تواصل معنا لتفعيل الوصول

يُفعَّل الاستدعاء المباشر لـ Nagad Customer لكل عميل على حدة. يبقى وضع بيئة الاختبار مجانيًا ولا يتطلب تسجيل الدخول.

حدود واضحة قبل أول طلب.

أمور تستحق المعرفة.

هل تستخدم البيئة التجريبية حسابات حقيقية؟

لا. تستخدم استجابات ثابتة وبيانات اختبار عامة، ولا تتصل بمزوّد مالي أو ترسل رمزًا أو تنقل أموالًا.

هل تدعم كل الواجهات الطلبات الفعلية؟

لا. الواجهات المعلّمة بالاتصال الفعلي فقط لها مزوّد متصل. غيرها تجريبية وتعيد LIVE_ACCESS_NOT_ENABLED في الوضع الفعلي. تواصل معنا للاستفسار عن الوصول.

متى يُخصم الرصيد؟

يُخصم رصيد واحد لكل طلب فعلي ناجح، والطلبات الفاشلة والتجريبية مجانية. راجع X-Credits-Charged بدلًا من حالة HTTP وحدها. إذا ظهر X-OBG-Settlement: unknown فنتيجة الفوترة غير محسومة؛ ولا يثبت X-Credits-Charged: 0 عدم حدوث خصم. راجع سجل الاستخدام وطابق النتائج قبل إعادة المحاولة.

هل يربط تسجيل Google محفظتي؟

لا. يدير تسجيل Google حساب الموقع والرصيد ومفاتيح API. دخول المحفظة عملية مستقلة وصريحة لتكامل مدعوم وحساب مخوّل لك استخدامه.

واصل الاستكشاف.