Guide
Guide

@first-iraqi-bank/sdk

npm version

First Iraqi Bank allows you to create online payments in your application using REST API.

This package helps you integrate the payment API easily on your JavaScript/TypeScript backend server using a simple and type-safe API.

Installation

npm
yarn
pnpm
bun
deno
npm install @first-iraqi-bank/sdk

Technical notices

You need to register for the sandbox environment to get your client_id and client_secret. Once you are ready to move to production, contact integration@fib.iq to obtain your production credentials.

  1. This package guarantees support for Maintenance and LTS versions of Node.js, starting from v18 of Node.js. if you encountered any issues in this regard, please let us know.

  2. This package guarantees support for ESM and CJS module formats, we prefer and recommend using ESM everywhere if it works for you.

  3. This package is built on top of the Fetch API and all functions return a Response giving you maximum flexibility to parse or ignore the responses you get. Check out Node.js docs - Fetch section which is available since v18.0.0

Contributing

If you encounter any bugs or issues while using the SDK, we encourage you to report them by filing an issue on our GitHub repository. Your feedback helps us improve the SDK.

Additionally, if during the discussion of an issue you feel that you can contribute a code change to resolve the problem, we warmly welcome your contributions. To do so, please submit a pull request with your proposed changes.

ON THIS PAGE