Skip to content

Al Fouad

Ruben edited this page Sep 14, 2026 · 2 revisions

Al Fouad

This page contains information about configuring the Al Fouad FSP integration in a 121 Platform Instance.

Environment Variables

Variable Required when Description
AL_FOUAD_MODE Always EXTERNAL to call the real Al Fouad API, MOCK otherwise
AL_FOUAD_API_URL AL_FOUAD_MODE=EXTERNAL Base URL of Al Fouad's API
CRON_AL_FOUAD_RECONCILIATION No (optional) Enables the nightly reconciliation cronjob

Per-Program FSP Configuration

Each program using Al Fouad must have its own FSP configuration with these properties, set via the 121 portal or API:

Property Required Description
accountAlFouad Yes Account used for the Al Fouad integration
branchIdAlFouad Yes Al Fouad branch ID
usernameAlFouad Yes Username for authentication
passwordAlFouad Yes Password for authentication
publicKeyAlFouad Yes Public key used to encrypt requests
senderFullNameAlFouad Yes Full name of the sender
senderPhoneNumberAlFouad Yes Phone number of the sender

Payment flow

When a payment is made to a registration with the Al Fouad FSP, a money transfer is created that the recipient can collect at an Al Fouad branch. Transactions are created with status waiting. A nightly reconciliation cronjob (CRON_AL_FOUAD_RECONCILIATION) checks the status of waiting transactions with the Al Fouad API and updates them accordingly.

Clone this wiki locally