Web Payments

Welcome to FIB Online Payment Documentation, With the FIB Online payments service you can easily accept payments fast and easily on your web shop. All you need to do is connect with the create payment and check status endpoints or you can provide us a callback URL (we will be calling it when status is changed). The endpoints consume JSON request bodies and produce JSON responses. As a first step, please register for our sandbox environment. We kindly ask you to play around with our API and try to create payments and check the status of payments. When you feel comfortable accepting payments on your production environment, please fill out this FIB Integration Request Form so that we provide you with the credentials for your account. After applying for credentials, First Iraqi Bank will provide you with the required credentials which need to be added as properties for production. After a successful integration, you will be ready to offer“Pay with FIB”for your customers, and see all successful transactions from your shop in the FIB app.

Integration Process Diagram

API Reference

Our API is organized around REST, it has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs. You can use the FIB API on the sandbox environment, which does not affect your live data or interact with the banking networks. The account credentials you use to authenticate the request determines whether the request is live mode or test mode.

The credentials consist of:

client_id
client_secret

Requests

All requests need to be authenticated with an Access Token acquired with the OAuth2 Client Credentials Grant Flow with theclient_id andclient_secret you got from us.

All API requests must be made over HTTPS or they will fail. You must authenticate for all requests.

API Flow

Authentication
Authentication of the user and the credentials you were given, and giving you a token for your future requests.
Payment Creation
Used to create a payment and getting QR codes and dynamic links to forward the user to the payment screen.
Checking payment status
Used to check the status of a payment.
Payment Cancellation
Used to cancel an active payment that has not been paid yet.

Please note that below examples will only show the relevant information in the request. A simple copy-paste of the request might therefore lead to errors in your product.

Authorization

Code Example

https://fib.stage.fib.iq/auth/realms/fib-online-shop/protocol/openid-connect/token

clientId: Your accounts unique identifier. Will be given to you by FIB.
clientSecret: A secret key to be stored on a safe place on your app. Will be given to you by FIB.

BODY	URLENCODED
grant_type	client_credentials
client_id	Client id provided by FIB
client_secret	Client Secret provided by FIB

Example Request

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'

Example Response

{
    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",
  }

Create Payment

Code Example

https://fib.stage.fib.iq/protected/v1/payments

Request body

monetaryValue.amount:the amount of the payment.
monetaryValue.currency: the currency of the payment; currently only IQD is supported.
statusCallbackUrl: (Optional) The callback url that we will send a POST request to when status of the created payment changes. Callback URL should be able to handle POST requests with request body that contains two properties:
- id : this will be the payment id.
- status : this will be the payment status.
Response code should be as follows
- HTTP 202 - Accepted
- HTTP 406 - Not acceptable
- HTTP 500 - General error
Response example is in Check Status endpoint section of the documentation.
description: (Optional) Description of the payment to help your customer to identify it in the FIB app, with the maximum length of 50 characters.

Expected Response

paymentId: A unique identifier of the payment, used later to check the status.
qrCode: A base64-encoded data URL of the QR code image that the user can scan with the FIB mobile app.
readableCode: A payment code that the user can enter manually in case he cannot scan the QR code.
personalAppLink: A link that the user can tap on his mobile phone to go to the corresponding payment screen in the FIB Personal app.
businessAppLink: A link that the user can tap on his mobile phone to go to the corresponding payment screen in the FIB Business app.
corporateAppLink: A link that the user can tap on his mobile phone to go to the corresponding payment screen in the FIB Corporate app.
validUntil: An ISO-8601-formatted date-time string, representing a moment in time when the payment expires.

AUTHORIZATION	BEARER TOKEN
Token	<token>

BODY	RAW

Code Example


{
  "monetaryValue": {
    "amount": "500.00",
    "currency": "IQD"
  },
  "statusCallbackUrl": "https://URL_TO_UPDATE_YOUR_PAYMENT_STATUS",
  "description": "Lorem ipsum dolor sit amet."
}

Example Request

{
  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."
}

Example Response

{
{
  "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"
}

Check Payment Status

Code Example

https://fib.stage.fib.iq/protected/v1/payments/{paymentid}/status

Requset

paymentId: Should be passed in the url path.

Expected Responses

paymentId: a unique identifier of the payment.
status: Expected values are: PAID | UNPAID | DECLINED .
validUntil: an ISO-8601-formatted date-time string, representing a moment in time when the payment expires.
paidAt: an ISO-8601-formatted date-time string, representing a moment in time when the payment is done.
amount:a JSON object, containing two key-value pairs; the amount and currency of the payment.
decliningReason: Expected Values are:
- SERVER_FAILURE: Payment failure due to some internal error.
- PAYMENT_EXPIRATION: Payment has expired.
- PAYMENT_CANCELLATION: Payment canceled by the user.
declinedAt: an ISO-8601-formatted date-time string, representing a moment in time when the payment is declined.
paidBy: a JSON object, containing two key-value pairs; the name and iban of the customer.

AUTHORIZATION	BEARER TOKEN
Token	<token>

Example Request

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

Example Response

{
  "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
}

Cancel Payment

Code Example

https://fib.stage.fib.iq/protected/v1/payments/4d6f7625-60f7-48e3-82e3-b4592a4eb993/cancel

Request

paymentId: Should be passed in the url path.

Response

204 No Content http status code.

Example Request

curl --location -g --request POST 'https://fib.stage.fib.iq/protected/v1/payments/{PAYMENT_ID}/cancel'

AUTHORIZATION	BEARER TOKEN
Token	<token>

Web Payments

Integration Process Diagram

API Reference

Requests

API Flow

Authorization

Create Payment

Request body

Expected Response

Check Payment Status

Requset

Expected Responses

Cancel Payment

Request

Response

اتصل بنا