Activating the Payment Gateway - KSA

Payment gateway activation powered by Checkout to allow card payments and Apple Pay for merchants in Saudi Arabia.

Step 1: Install the Foodics Online Integration

FO Portal > Settings > Integration > Foodics Online Payment > Install

Fill out the 3 fields (contact name, email, and phone number) and accept the terms and conditions.

Step 2: Using Payment Getaway on Web or App

FO Portal > App > View App > Payment and Delivery

Select the payment gateway Foodics-Online and activate the payment options you would like to have in your app.

*Make sure you apply this to all other apps if you have multiple apps.

You can now receive online payments via your Web and App!

Step 3: Complete the e-KYC Form to Activate Settlement

You will receive an SMS within 5 to 15 minutes from the sender “foodics”

Open the link and fill in the following information:

1- Company information and documents

2- Owner information

3- Bank details

Step 4: Submit OTP

After submitting the e-KYC form, the Business owner shall receive an SMS which will have to be entered on the web page to complete the submission.

Transactions will be transferred to the bank account within 2 to 4 business days.

Issues

If you do NOT receive the SMS, kindly send an email to support@foodics.com with the following email subject: [Business Name]: SMS ISSUE.

Step 5: Track Transactions

Checkout Hub > Dashboard 

After being granted access to your Checkout dashboard, you will be able to track online transactions, generate reports, and process refunds. 

Dashboard

From this homepage, you will be able to track the online transaction over a specific period of time using the calendar. 

1- Total revenue: Total transactions processed through your payment gateway 

2- Net revenue: Total transactions processed minus refunds and disputes 

3- Approved Sales: Total number of transactions successfully processed with amounts deducted from the merchant bank account 

4- Customers: Total number of customers who placed an order during a defined period of time 

5- Refunds: You will be able to track the refunds either processed automatically or manually through the dashboard 

6- Payment methods: You will be able to track the payment method breakdown depending on the card types used by your customers 

Payments Page

From the payment tab, you will be able to track the status of each transaction processed through your payment gateway. 

Amounts may be duplicated; the end customer has not been charged twice, and each transaction has several statuses: 

1- AUTH: This is the first status triggered once the online payment is initiated by the customer. This authorization status means that the bank has successfully authorized the transaction.

1. 1. For Mada cards due to the local scheme specificities in Saudi, the authorization means that the transaction has been deducted from the client's bank account 
   2. For credit cards, the authorization means that the funds have been put on hold and have not been deducted from the client’s bank account 

2- CAPTURE: This is the second status triggered after the authorization of the transaction. Once the payment status is captured it means that for Mada and for Credit card transactions, the funds have been deducted from the customer's bank account. For Mada transactions though it doesn’t change anything as the deduction of the funds already happened at the authorization stage. 

1. REFUND: This status is triggered anytime a refund transaction is processed, meaning that a successful request to refund the funds into the customer's bank account has been made from the dashboard. From the moment the refund is triggered from the dashboard, it takes between 7 days to 2 weeks for the fund to reach back to the customer bank account. 

*Use the reference number (8-digit) to find a transaction, which remains the same for the same transaction across the different statuses in the same transaction.

Step 6: Manually Refund Online Transactions

Checkout Hub > Payments

1- Select the transaction to manually process a refund.

2- Click on ‘Refund’ on capture transactions and confirm the amount you would like to refund (full refund or partial refund). 

Step 7: Troubleshooting

In the case of an authorized-only transaction due to several reasons (the POS didn’t receive the order upon the payment from the customer, payment gateway was not properly configured…), two options are possible: 

Void Transaction 

1- For Mada transactions, this means that you decide to refund the client and the normal refund SLAs will apply 

2- For credit card transaction this means that you release the payment which has been put on hold

Capture Transaction 

1- Mada transactions: It is very important to do it, especially if you’ve handed over the order to the client to make sure the funds don’t get refunded into the customer's bank account. After 10 days if an authorized-only transaction is not captured, it gets automatically voided, thus refunded for Mada cards.

2- Credit card: this means that you decide to actually deduct the amount which has been on hold, from the customer's bank account 

In the report section, you will be able to download different types of reports giving you detailed visibility on the transactions processed through your payment gateway account over a defined period of time.

There are two types of reports you’ll be able to generate and download: (Report > New report)

• Full edition: giving the most detailed visibility on the transactions processed
• Slim edition: giving you more condensed visibility on the transactions processed

P.S.: From this report, there is an easy way to identify if the card used for the transaction is a Mada card or a Credit card, you can simply refer to the “CC type column” and see if the card used is either a debit card (Mada) or a credit card.