الرجاء عدم مشاركة معلومات بطاقتك مع أي شخص آخر، علماً أن FIB لن يطلب أبداً معلومات بطاقتك.

المدفوعات عبر الإنترنت

ادمج تطبيق الويب الخاص بك مع خدمات الدفع من مصرف العراق الأول - FIB، واسمح لعملائك بالدفع باستخدام حساباتهم في مصرف العراق الأول - FIB.

مرحباً بك في وثائق الدفع عبر الإنترنت من FIB. مع خدمة FIB للمدفوعات عبر الإنترنت يمكنك بسهولة قبول المدفوعات بسرعة وسهولة على متجرك الإلكتروني. كل ما عليك القيام به هو الاتصال بنقاط نهاية إنشاء الدفع والتحقق من الحالة أو يمكنك تزويدنا بعنوان URL لرد الاتصال (سنقوم بالاتصال به عند تغيير الحالة). تستهلك نقاط النهاية أجسام طلبات JSON وتنتج استجابات JSON. كخطوة أولى، يُرجى التسجيل في بيئة الحماية الخاصة بنا. نطلب منك التفضل بالتجول في واجهة برمجة التطبيقات الخاصة بنا ومحاولة إنشاء مدفوعات والتحقق من حالة المدفوعات. عندما تشعر بالارتياح لقبول المدفوعات في بيئة الإنتاج الخاصة بك، يرجى ملء استمارة طلب التكامل مع FIB حتى نزودك ببيانات الاعتماد لحسابك. بعد التقدم بطلب للحصول على بيانات الاعتماد، سيقوم المصرف العراقي الأول بتزويدك ببيانات الاعتماد المطلوبة والتي يجب إضافتها كخصائص للإنتاج. بعد نجاح التكامل، ستكون جاهزًا لتقديم "الدفع مع مصرف العراق الأول" لعملائك، وسترى جميع المعاملات الناجحة من متجرك في تطبيق مصرف العراق الأول.

مخطط عملية التكامل

مرجع API

تم تنظيم واجهة برمجة التطبيقات (API) الخاصة بنا حول REST، ولديها عناوين URL يمكن التنبؤ بها وموجهة نحو الموارد، وتقبل نصوص الطلبات المشفرة بـ JSON، وتعيد استجابات مشفرة بـ JSON، وتستخدم رموز استجابة HTTP القياسية والمصادقة والأفعال. يمكنك استخدام واجهة برمجة التطبيقات (API) الخاصة بـ مصرف العراق الأول - FIB في بيئة الاختبار، والتي لا تؤثر على بياناتك المباشرة أو تتفاعل مع الشبكات المصرفية. تحدد بيانات اعتماد الحساب التي تستخدمها لمصادقة الطلب ما إذا كان الطلب في الوضع المباشر أو وضع الاختبار.

تتكون بيانات الاعتماد من:

1. client_id

2. client_secret

الطلبات

يجب مصادقة جميع الطلبات باستخدام رمز الوصول الذي تم الحصول عليه باستخدام OAuth2 Client Credentials Grant Flow معclient_id وclient_secret التي حصلت عليها منا.

ملاحظة: يجب إجراء جميع طلبات API عبر HTTPS وإلا ستفشل. يجب عليك المصادقة لجميع الطلبات.

تدفق API

1. Authentication
مصادقة المستخدم وبيانات الاعتماد التي تم منحها لك، مما يمنحك رمزًا لطلباتك المستقبلية.

2. Payment Creation
يستخدم لإنشاء دفعة والحصول على رموز QR وروابط ديناميكية لإعادة توجيه المستخدم إلى شاشة الدفع.

3. Checking payment status
يستخدم للتحقق من حالة الدفع.

4. Payment Cancellation
يستخدم لإلغاء دفعة نشطة لم يتم دفعها بعد.

ملاحظة: يرجى الانتباه إلى أن الأمثلة أدناه ستعرض فقط المعلومات ذات الصلة في الطلب. قد يؤدي النسخ واللصق البسيط للطلب إلى حدوث أخطاء في منتجك.

التخويل

مثال على التعليمات البرمجية

نسخ تم النسخ
 https://fib.stage.fib.iq/auth/realms/fib-online-shop/protocol/openid-connect/token

1.clientId : المعرف الفريد لحساباتك. سيتم إعطاؤه لك من قبل FIB.

2.clientSecret : مفتاح سري يتم تخزينه في مكان آمن على تطبيقك. سيتم إعطاؤه لك من قبل FIB.

الجسمUrlencoded
grant_typeclient_credentials
client_idمعرف العميل المقدم من مصرف العراق الأول
client_secretكلمة مرور العميل المقدمة من مصرف العراق الأول

مثال على التعليمات البرمجية

نسخ تم النسخ
curl --location --request POST 'https://fib.stage.fib.iq
/auth/realms/fib-online-shop/protocol/openid-connect/token' \
--data-urlencode 'grant_type=client_credentials' \ 
--data-urlencode 'client_id=Your client ID - Provided by FIB' \ 
--data-urlencode 'client_secret=Secret - Provided by FIB'

مثال على التعليمات البرمجية

نسخ تم النسخ
{
    access_token:
        "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJPdjBsNEJGOVRmVDlWNTEtVjZBeTRmYlVoQ0dMbTZXUVpxcXQ4S3lLOGhnIn0.eyJleHAiOjE2NDM2MzA4MDgsImlhdCI6MTY0MzYzMDc0OCwianRpIjoiOWE5ZmRmMGItMGRjMS00ZTdhLWI2NTMtM2MyMzg5ZDRiODg5IiwiaXNzIjoiaHR0cHM6Ly9maWIuZGV2LmF6dXJlLmxhd3JlbmNlLXNwcmluZy5jb20vYXV0aC9yZWFsbXMvZmliLW9ubGluZS1zaG9wIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6ImMxNmQ3YWM2LTc5NGUtNDViZi1hYzA3LWNhYTRiYmNjZjU5YiIsInR5cCI6IkJlYXJlciIsImF6cCI6Im9ubGluZS1zaG9wIiwic2Vzc2lvbl9zdGF0ZSI6IjMzZDdlZTk3LTc0NDQtNDg1ZC1iY2I3LTI1YWY1Njc5N2MwNyIsImFjciI6IjEiLCJyZWFsbV9hY2Nlc3MiOnsicm9sZXMiOlsib2ZmbGluZV9hY2Nlc3MiLCJ1bWFfYXV0aG9yaXphdGlvbiIsIkZJQl9QQVkiXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6ImVtYWlsIHByb2ZpbGUiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsImFjY291bnRfaWQiOiJmZmZkNmU4NC1hMTcyLTQ5YzctYmZlOC0yMjk4ZGQzYThlMjAiLCJjbGllbnRIb3N0IjoiOTMuOTEuMjAwLjE5OCIsInByZWZlcnJlZF91c2VybmFtZSI6InNlcnZpY2UtYWNjb3VudC1vbmxpbmUtc2hvcCIsImNsaWVudEFkZHJlc3MiOiI5My45MS4yMDAuMTk4IiwiY2xpZW50X2lkIjoib25saW5lLXNob3AifQ.LuwNH2A5eYoxlY1ylDRVrl8PIkx3Fcf-LVRZSIE1hG5ZtylHcfYDmx7b2yftjOyKyj2dMMOuciYh89_9UKM9C1AAbdKKyDKTdKYrRlRS-k-oW-lLht0e3E_Y5uTRtyok7QwNBXBTwT8BKW1JCp67nUGL8a3KlM5RMK1tsPKUYeUaGYxcj8ogg6cJjMh0KkG3AVCrjxpJ7sD5A1H7OeQzONbZnwYreK2xDgNhS3JLnKcyjNEqiZheV5KM5FX-V_Tfw_UlY5FIZ_XIvyBJxUOshMYDgZlllB6uOeMZejPoxQYxrZnSn1dlVXB8d7seOOttto3vdCxUjDXOcLhnjoLhIg",
     expires_in: 60,
    refresh_expires_in: 1800,
    refresh_token:
        "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJhZGQ5MWM2MC1mOTE3LTQ4NDItYTM5OC05OGNiNWFlNDYxN2IifQ.eyJleHAiOjE2NDM2MzI1NDgsImlhdCI6MTY0MzYzMDc0OCwianRpIjoiY2M4M2YxNGEtNGIxYS00ZDFjLTliNWYtMmU4YTJhMDEwMjEwIiwiaXNzIjoiaHR0cHM6Ly9maWIuZGV2LmF6dXJlLmxhd3JlbmNlLXNwcmluZy5jb20vYXV0aC9yZWFsbXMvZmliLW9ubGluZS1zaG9wIiwiYXVkIjoiaHR0cHM6Ly9maWIuZGV2LmF6dXJlLmxhd3JlbmNlLXNwcmluZy5jb20vYXV0aC9yZWFsbXMvZmliLW9ubGluZS1zaG9wIiwic3ViIjoiYzE2ZDdhYzYtNzk0ZS00NWJmLWFjMDctY2FhNGJiY2NmNTliIiwidHlwIjoiUmVmcmVzaCIsImF6cCI6Im9ubGluZS1zaG9wIiwic2Vzc2lvbl9zdGF0ZSI6IjMzZDdlZTk3LTc0NDQtNDg1ZC1iY2I3LTI1YWY1Njc5N2MwNyIsInNjb3BlIjoiZW1haWwgcHJvZmlsZSJ9.YsExgjevG_8vAA-UhaT16rQLzyDC5fAcuBWMSK6i9qs",
    token_type: "bearer",
    "not-before-policy": 0,
    session_state: "33d7ee97-7444-485d-bcb7-25af56797c07",
    scope: "email profile",
  }

إنشاء دفعة

مثال على التعليمات البرمجية

نسخ تم النسخ
 https://fib.stage.fib.iq/protected/v1/payments

هيئة الطلب:

1.monetaryValue.amount : مبلغ الدفعة;
2.monetaryValue.currency : عملة الدفع؛ وحاليًا يتم دعم الدينار العراقي فقط;
3.statusCallbackUrl : (اختياري) عنوان URL لرد الاستدعاء الذي سنرسل إليه طلب POST عندما تتغير حالة الدفعة التي تم إنشاؤها. يجب أن يكون عنوان URL الخاص برد الاتصال قادرًا على التعامل مع طلبات POST مع نص الطلب الذي يحتوي على خاصيتين:
أ. المعرف: سيكون هذا هو معرف الدفعة؛
ب. الحالة: ستكون هذه هي حالة الدفعة.

يجب أن يكون رمز الاستجابة كما يلي:

  1. HTTP 202 - مقبول؛
  2. HTTP 406 - غير مقبول؛
  3. HTTP 500 - خطأ عام.

مثال الاستجابة موجود في قسم نقطة نهاية حالة التحقق من الوثائق:

description : (اختياري) وصف المدفوعات لمساعدة العميل على التعرف عليها في تطبيق FIB، بحد أقصى 50 حرفًا.

الاستجابة المتوقعة:

1.paymentId : مُعرّف فريد للدفع، يُستخدم لاحقًا للتحقق من الحالة؛

2.qrCode : عنوان URL للبيانات المشفرة بـ base64 لصورة رمز QR التي يمكن للمستخدم مسحها ضوئيًا باستخدام تطبيق FIB للهاتف المحمول؛

3.readableCode : رمز الدفع الذي يمكن للمستخدم إدخاله يدويًا في حال عدم تمكنه من مسح رمز QR؛

4.businessAppLink : رابط يمكن للمستخدم النقر عليه على هاتفه المحمول للانتقال إلى شاشة الدفع المقابلة في تطبيق FIB Business.

5.corporateAppLink : رابط يمكن للمستخدم النقر عليه على هاتفه المحمول للانتقال إلى شاشة الدفع المقابلة في تطبيق FIB Corporate.

6.validUntil : سلسلة تاريخ ووقت بتنسيق ISO-8601، تمثل لحظة انتهاء صلاحية الدفعة.

التخويلرمز حامل
Token<token>
الجسمRAW

مثال على التعليمات البرمجية

نسخ تم النسخ
{
  "monetaryValue": {
    "amount": "500.00",
    "currency": "IQD"
  },
  "statusCallbackUrl": "https://URL_TO_UPDATE_YOUR_PAYMENT_STATUS",
  "description": "Lorem ipsum dolor sit amet."
}

مثال على التعليمات البرمجية

نسخ تم النسخ
{
  curl --location --request POST  'https://fib.stage.fib.iq/protected/v1/payments' 
 --header 'Content-Type: application/x-www-form-urlencoded' 
 --header 'Authorization: Bearer token you recieved with the Authorization endpoint' 
 --data-raw '{
  "monetaryValue": {
    "amount": "500.00",
    "currency": "IQD"
  },
  "statusCallbackUrl": "https://URL_TO_UPDATE_YOUR_PAYMENT_STATUS",
  "description": "Lorem ipsum dolor sit amet."
}

مثال على التعليمات البرمجية

نسخ تم النسخ
{
{
  "paymentId": "9dfa724f-4784-4487-811b-63057b540503",
  "readableCode": "S3LE-NZ2S-ZNGF",
  "qrCode": "data:image/png;base64,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
  iBcXOKmL8z64Qen59rLBy+d2RfeKuV0/fGj5+ld24XktDH+xuAb/gPTKoTSK2CtwMmL+W41ZrNzaev306V+8d3AETy0F/g
  K6OG+Fm3Pba7FuWTp46WBXQ/3xz1e+e+AAHtx4+Avo4rwVbs4NXqw/GUqjiL0CJyPma78xumTOjEb7d6sfOFj6b7n4C+ji
  vBVuzm2zxRouY7Fqzty0Hs9uMPwFdHHeCjfnBi/WFUNpFLFX4GTE/E3Dcy4emHE4XjUvu37xLMVJi2ZdMdjNg7lfGEp3v/
  MWHt9I+Avo4rwVbs5tr8V6avfvbl02dNFAp9eHd+7AYeKdAwce2PH8dxyFdzz9OA40Ev4CujhvhZtz22uxauwbGZm8/snL
  53RdOLtTsbYua3f/DoeLqK3XD1ct54brFvQdOHgQ0w2Dv4Auzlvh5tzgxbp8bhpF7BU4GTefs/W1V79//+ILZncqXjS78z/
  WPPz6/n04TOzdv++rC/u54ZlXXsJow+AvoIvzVrg517lYHNUvxEldnC+dkUMH+5/bcOVg+rlZHYrXLuhb+cI27w/WO599im
  cHt/wKcx8a/pLlfE8+Ude5WJfNTQvFnMBJXZxvEjvf2vs3q1acP6tD90cPrfjfva/jcB3rXt7FU3etW4O5Dw1/yXK+J5+o2
  +6LVaP2q9GyX2+9el7vef0dipcNdM949mnXb5uef+M1HvmftY9h7kPDX7Kc78kn6laLNcaefe/+86Orzuuffq7qd5fN2/DK
  bhweHX3kxR0crv0pAXMfGv6S5XxPPlHXuViXzk0LxZzASV2cbwFqv3St3rlj0sJZ5/RNVzy/v+P2Xz729nvv1c/2b9rAycX
  bN9dnosBfspzvySfquhdrMC0UcwIndXG+ZahtzH89+ch5fR1n905XnLRwdm0Lx39TX/uLB3Y8f828vvFAbbFeUH9bZoO/ZDn
  fk0/UdS7WJYNpoZgTOKmL8y3GU7t33bxk8KzeaYpn9077+9U/e+Xdd8an9u7f/++PP3xu7/Ta/3rL8FzvnyUN8Jcs53vyibr
  VYjnZ//sfpV7Q33nWzGmKnx9MF23fXP9L1y9fevHGxXNmP/fsB/viwF+ynO/JJ+oGL5ZLnBc4GVc8LzbbXt/zFysWnTlzmu5
  fPbB0x943xqf2jYy8N3JY/2IWv8j2Lm7Qezipi/MCJ3Odi3XxYBokzgucjCuep7Jk+5baLyTg0JaNQ1s2gRtffXl86uChQwO
  bf3Xp7O7PZlMVa7+2dW1w/jzCBb/I8K7R8B5O6uK8wMnc9lqsa+f1n5FNPRzPnjn99icfe+fA+3/02/X2Wz9atZKT4K3DQ88
  U/TzCBb/I8K7R8B5O6uK8wMlcZbGyIHFe4GRc8TyVr8zrPz2devheN3/WIzt/Mz5e+/3Tyhe2XzU4k5P1npVNu3fdk4f57/r
  xiwzvGg3v4aQuzguczHUu1kVzsiBxXuBkXPE8lWvm9Z2WTgn1H1c/uOfdd8dL3ti/718efeiMdCon6/2Hh382chj/WOQXGd4
  1Gt7DSV2cFziZ216LdfVQ36k9UwxePtCzaNv7f/SrsWbXzkkLZnOy3n999OfenzjwiwzvGg3v4aQuzguczHUu1oVzsiBxXuB
  kXPE8lS8P9Z3SM8XsD+5f+ps394637Rs58NO1a87MpnFy3IHnPP+CA7/I8K7R8B5O6uK8wMncNlusub0nd0/+MJ7X29H97Lr
  6f8Zt3vPqbcPzOTmer99Fhl9keNdoeA8ndXFe4GRuwxcrFnyi4dxJCwZO6ppcb+0fWH0bN/RtCnP9yx/4N/hGDh2cufGZ83s
  7oTz3x6vuqw8D/CLDu0bdPS5xXuCkTediXTAnCxLnY8MnGs69adHcE7sm13t6z9TD/OObl51vvfn9FUugv+Yp3VO2vrYH0wK
  /yPCuUXePS5wXOGnTvVgDWZA4Hxs+0XDujYsGT5hxb72n9UyJtVg1Dhw8+Jf3DcMRNf/z8dUYFfhFhneNuntc4rzASZvOxfr
  cQBYkzseGTzSc+82FuFindsdcrBq/fXPvad1T4ZQvDva6/njILzK8a9Td4xLnBU7abK/FumHh4PGd99R7Slfkxarxg/uWwin
  Hd9770tvF/5khv8jwrlF3j0ucFzhps70W6xsL5hzXeU+9J3dNjr5Yd6xdA6fUfGLXi5j7Pfwiw7tG3T0ucV7gpE3nYp0/kAW
  J87HhEw3n/v9iddxT70kz4i/WtPVr4ZSaq3/7/v81VA+/yPCuUXePS5wXOGmzvRbr6wvmHNtxT70nNmCx/mn1KjilJvyEYhx
  +keFdo+4elzgvcNJmct7sLEi8iMBJW94lzpu4fv7AMdPvrrf2O+u4i7Vv5MBFfd1wynEdd7++r/g/fOWX2sTeZtN2i3X09Lv
  rrf22Ou5i/feax+CImtfM7Xf9qZBfahN7m017LdakeQOfnnZ3vZ/piLZYIwcP3rH2iaM/2J97+xO/wLTAL7WJvc0mOXd2FiQ
  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
  AAAASUVORK5CYII=",
  "validUntil": "2022-01-31T12:15:44.020920Z",
  "personalAppLink": 
  "https://personal.stage.first-iraqi-bank.co/?link=https://personal.stage.first-iraqi-bank.co
  /onlinePayment/?identifier%3DS3LENZ2SZNGF&apn=com.firstiraqibank.personal.stage&ibi=
  se.core.Lawrencespring.development",
  "businessAppLink": 
  "https://business.stage.first-iraqi-bank.co/?link=https://business.stage.first-iraqi-bank.co
  /onlinePayment/?identifier%3DS3LENZ2SZNGF&apn=com.firstiraqibank.business.stage&ibi=
  se.core.Lawrencespring.business.development",
  "corporateAppLink": 
  "https://corporate.stage.first-iraqi-bank.co/?link=https://corporate.stage.first-iraqi-bank.co
  /onlinePayment/?identifier%3DS3LENZ2SZNGF&apn=com.firstiraqibank.corporate.stage&ibi=
  se.core.Lawrencespring.corporate.development"
}

التحقق من حالة الدفع

مثال على التعليمات البرمجية

نسخ تم النسخ
https://fib.stage.fib.iq/protected/v1/payments/{paymentid}/status

طلب

paymentId : يجب تمريره في مسار عنوان URL.

الاستجابات المتوقعة

1.paymentId : معرّف فريد للدفع.

2.status : القيم المتوقعة هي:PAID |UNPAID |DECLINED.

3.validUntil : سلسلة زمنية بتنسيق ISO-8601 بتنسيق ISO-8601، تمثل لحظة زمنية تنتهي فيها صلاحية الدفع.

4.paidAt : سلسلة زمنية بتنسيق ISO-8601 بتنسيق ISO-8601، تمثل لحظة زمنية يتم فيها الدفع.

5.amount : كائن JSON، يحتوي على زوجين من القيمة الرئيسية؛ مبلغ وعملة الدفع.

6.decliningReason : القيم المتوقعة هي:

  1. أ. SERVER_FAILURE : فشل الدفع بسبب بعض الأخطاء الداخلية.
  2. ب. PAYMENT_EXPIRATION : انتهت صلاحية الدفعة.
  3. ج. PAYMENT_CANCELLATION : تم إلغاء الدفع من قبل المستخدم.

7.declinedAt : سلسلة زمنية بتنسيق ISO-8601 بتنسيق ISO-8601، تمثل لحظة زمنية يتم فيها رفض الدفع.

8.paidBy : كائن JSON، يحتوي على زوجين من القيمة الرئيسية؛ اسم العميل ورقم الحساب المصرفي الدولي (IBAN).

التخويلرمز حامل
Token<token>

مثال على التعليمات البرمجية

نسخ تم النسخ
curl --location --request GET \
'https://fib.stage.fib.iq/protected/v1/payments/4d6f7625-60f7-48e3-82e3-b4592a4eb993/status' \
--data-raw

مثال على التعليمات البرمجية

نسخ تم النسخ
{
  "paymentId": "4d6f7625-60f7-48e3-82e3-b4592a4eb993",
  "status": "UNPAID",
  "validUntil": "2022-01-31T12:26:12.544Z",
  "paidAt": null,
  "amount": {
    "amount": 500,
    "currency": "IQD"
  },
  "decliningReason": null,
  "declinedAt": null,
  "paidBy": null
}

إلغاء الدفع

مثال على التعليمات البرمجية

نسخ تم النسخ
https://fib.stage.fib.iq/protected/v1/payments/4d6f7625-60f7-48e3-82e3-b4592a4eb993/cancel

طلب

paymentId : يجب تمريره في مسار عنوان URL.

استجابة

رمز حالة HTTP 204 بدون محتوى.

مثال على التعليمات البرمجية

نسخ تم النسخ
curl --location -g --request POST 'https://fib.stage.fib.iq/protected/v1/payments/{PAYMENT_ID}/cancel'
التخويلرمز حامل
Token<token>
مصرف العراق الأول - FIB
نظرة عامة على الخصوصية

يستخدم هذا الموقع الإلكتروني ملفات تعريف الارتباط حتى نتمكن من تزويدك بأفضل تجربة مستخدم ممكنة. تُخزَّن معلومات ملفات تعريف الارتباط في متصفحك وتؤدي وظائف مثل التعرف عليك عند العودة مجدداً إلى موقعنا الإلكتروني ومساعدة فريقنا على فهم أقسام الموقع التي تعتبر ذات أهمية وفائدة بالنسبة لك.