Forsa Egypt is a mobile application and website that provides installment payment services on the longest payment period, so the clients can buy now and pay later (BNPL).


In this article, you will learn about the:


Supported Regions


Merchants in Egypt can enable FORSA  as an APM (Alternative Payment Method).



Activation Requirements


As a merchant, you need to have the following requirements: 

  • An active PayTabs account. 
      
To know more about how to create an account on PayTabs and what the requirements check our What are the required KYC documents to activate/open my account on PayTabs? solution article.


  • Filling the attached template with merchant details to be shared with Forsa team. ( check the attachments)

  • Required documents: 
  1. Updated CR 
  2. Tax Card
  3. Assigned signatory National ID (Front & Back)

How to activate it?


Merchants in Egypt can enable this payment method directly by raising a request to [email protected] attaching the above requirements along with mentioning their Merchant ID.



What are the Features that FORSA supports?


FORSA Down Payment 


FORSA down payment is an option that you can enable or disable depending on your business needs from the "Profile" tab.



Upon clicking the edit button, you will be directed to the screen displayed below, which offers various options as listed here:

  1. (Enabled): Enable or Disable the down payment option
  2. (Force Zero): this also means that the down payment will always be zero.
  3. (Editable): Give the authority to edit the down payment amount to the customer
  4. (Maximum % of total): You can set the percentage of the down payment of the transaction amount
  5. (Maximum amount): You can set the Maximum amount of the down payment
  6. (Zero if max down payment is below): The down payment will be Zero if the customer puts any amount below the amount you have set before.

Note: There is no minimum amount for the down payment but the down payment must be less than the transaction amount.


FORSA Payment Workflow (User Experience)


FORSA payment method is hosted by PayTabs, which means that it will be managed and processed on our side. You can have the same page embedded in your checkout page by following our How to not redirect my customers to an external payment page? (iFrame/Embedded Mode) solution article.


Using the FORSA payment method (via one of our integration methods listed in our How to integrate with PayTabs? solution article), when the cardholder proceeds to checkout on the merchant side, they will be redirected to the PayTabs hosted payment page to provide his phone number to complete the payment as shown below:


Once the customer is redirected to the payment page he/she will pick FORSA as below.


                                  Image

 


Then the customer will be required to enter his details to proceed to the next step.

 

 

After that, the customer can see an option for a downpayment: EGP 100 (must be less than the cart amount) with a minimum transaction amount of 50EGP.


  

Then the customer can pick the tenures that suit his needs from 6 months to 61 months.

  


 

Then will wait for the OTP sent by FORSA to confirm the transaction.

 

 

The final step is the confirmation that the payment is successful.

 

 

Transactions that have been paid through FORSA will be tagged in the payment method in the transaction detail window as shown below.

 

                                                     


Response codes, Causes & Potential solutions.


Here are the most frequent response codes you might get for your transactions, along with explanations for each one and suggestions on what actions you can take.


Code

Status

 Response message

Reason/s

Possible Actions

Issuer Bank Txn Ref.

A

Authorized

This is a successful transaction

-

333

D

Invalid OTP

using invalid OTP

Ensure that the customer successfully receives the One-Time Password (OTP), as some applications may face issues with OTP delivery.

317

D

Blocked by 

Acquirer

The amount should be 

greater than 50 EGP.

Make sure that the customer meets the minimum amount of the transaction.

344
D
The acquirer enabled to process this request
Cart Amount > 

Consumer Limit

Check the customer limit, compare it with the cart amount, and inform the customer

107

D

Error from FORSA

processor

Error from FORSA

processor

Try again later.

118

D

Amount greater than the available balance

Amount greater than the available balance

Double-check with the customer to confirm that there is enough balance in their Forsa APP.

307

D

error response 

from FORSA

processor

error response 

from FORSA

processor

Try again later.

300

D

error response 

from FORSA

processor

error response 

from FORSA

processor

Try again later.

332

D

Wallet not found

The passed cart_description is not accepted by the system due to some rules/constraints or validation checks.

Make sure to use a valid cart_description format as clarified in the related Guide.



The Settlement Flow

 

Please note that settlements will be done by FORSA directly within 21 Working Days.


The Refund Process Flow

 

Please note that the refunds can be done only via the FORSA dashboard once your live credentials are shared with you for FORSA dashboard.