Server to Server APIs

The fastest way to build conversion-optimized payment forms, hosted on FawryPay.


If you are looking forward taking control over the look and feel of your checkout page, our set of comprehensive server side APIs are ready for you. With our set of APIs you can:

  • Make payments using Cards.
  • Issue tokens for your clients' Cards so a more secure payments.
  • Receive payments at any of our FawryPay POS retail store.
  • Issue cash on delivery payments.
  • Take full control of checkout UI/UX elements.
  • Design your client’s payment options selection form.
  • Get notified once the status of any of your transactions has been updated.
  • Get transaction status whenever needed.

How it works

  1. Present your own payment form and collect your client's payment details.
  2. From your server, submit a payment request with the data you have collected from your client.
  3. Check, from the response, the status of your payment.
  4. Present the payment status summary to your client. For example, show FawryPay transaction reference number for your client, or you may send him an e-mail or SMS, to pay at any FawryPay POS.
  5. Receive payment status update from FawryPay or pull it yourself using Get Payment Status API.

Payment Methods

FawryPay supports the most well known payment methods across different regions and channels. Here we list popular payment methods that you can add to your FawryPay integration.

Our payment methods can be classified as per the following attributes:

Card Payment

Server side card payments are those payments in which you collect your clients's payment details and submit them to FawryPay. Card payments are completed without your client leaving your web or mobile application server. FawryPay supports credit, debit (Visa and Mastercard) and Meeza card types. Server side card payments includes Pay Using Card.

3D Secure Card Payment

3D Secure, or 3 domains secure, is an authentication protocol that represents an additional layer of for online credit card transactions. It also provides protection from fraudulent card use for the seller and his acquiring bank, the cardholder and his card issuing bank, and Card Association's networks (Visa, MasterCard, Meeza). Learn more about 3D Secure Card Payment.

Authorize and Capture Payment

In a situation you might have a delayed shipment for which you do not want to collect funds right away, an authorization places a hold on the funds for you to capture later. After a successful authorization, FawryPay recommends that you capture the funds within the honor period. Success of the capture is subject to risk and availability of funds on the authorized funding instrument. Learn more about Authorize and Capture Payment.

E-wallet Payment

Since the revolutionary era of mobile devices, mostly there is an app for everything. E-Wallet technology is becoming more popular every day. By linking their mobile wallet to their bank account or credit card, clients can pay for goods or services with their phone. FawryPay wallet payment APIs allow merchants to accept E-Wallet payments through either QR Code or request-to-pay (R2P) request. Learn more about E-Wallet Payments.

Payment Request using Reference Number

In a situation where your client is more convenient with payment at any of our FawryPay POS retail store which can be found almost everywhere throughout the entire country, FawryPay has the solution. From your your server, submit a Payment Request using Reference Number. FawryPay will provide a payment reference number for your client to pay at the most convenient FawryPay POS retail store.

Installment Payment

Installment payments allows you to provide exceptional services that requires recurring payments like subscriptions, or a selling products by installment. See our Pay Using Bank Installments API for more information.

In addition, all of the aforementioned FawryPay payment methods allow you to make refunds to your client. See our Refund API for more information. Also, you may cancel your unpaid order. See our Cancel Unpaid Order for more information.

Learn How to

Was this page helpful?

Thank you for helping improve FawryPay's documentation. If you need help or have any questions, please consider contacting support.