Fawry

Fawry is Cairo-based Egypt's leading provider of e-payments and digital finance solutions, operating a nationwide network for card, e-wallet, and cash-based bill, merchant, government, and education payments. The FawryPay acceptance platform exposes a server-to-server REST API plus native Android, iOS, Flutter, and React Native SDKs and certified plugins for Magento, Shopify, and WooCommerce that let merchants charge cards (including 3DS), e-wallets, ValU, and bank installments, generate FawryPay reference numbers payable across more than 250,000 Fawry POS locations and partner channels, issue refunds, cancel unpaid orders, and reconcile via signed server notifications. Fawry also offers consumer products (myfawry super app, yellowcard prepaid card, FawryPlus, TicketsMall), enterprise and SME acceptance, pay-out, micro-finance, and consumer-finance services. Fawry is publicly listed on the Egyptian Exchange as FWRY.CA.

1 APIs 11 Features

PaymentsE-PaymentsDigital FinanceFintechEgyptCardsWalletsBill PaymentsPOSMicro-FinanceInstallments3D SecureRefundsWebhooksMobile SDKE-Commerce PluginsMagentoShopifyWooCommerce

APIs

FawryPay Server API

Server-to-server REST API for creating FawryPay charges (card, 3DS, e-wallet, ValU, bank installments, PayAtFawry reference numbers), issuing refunds, cancelling unpaid orders, ...

Collections

FawryPay Server API

OPEN

Features

Server-to-server REST API for card, 3DS, e-wallet, ValU, installments, and PayAtFawry reference-number payments

Refund and cancel-unpaid-order endpoints

Pull (v2) and push (server notification v2) payment status reconciliation

{"Express Checkout" => "self-hosted Checkout Button and Fawry-hosted Checkout Link"}

Pay By Link for one-time and recurring invoices for merchants without a website

Native Mobile SDKs for Android, iOS, Flutter, and React Native (anonymous, registered, AVL, microfinance, NFC)

Certified e-commerce plugins for Magento 2, Shopify, and WooCommerce

PayAtFawry retail acceptance across 250,000+ Fawry POS locations and partner channels in Egypt

SHA-256 request signing using per-merchant secureKey

Multi-language (Arabic and English) payment flows

Bank installment plan discovery API for partner banks

Resources

GettingStarted

Documentation

Documentation

Documentation

Documentation

Documentation

GitHubOrganization

GitHubOrganization

CodeExamples

CodeExamples

CodeExamples

CodeExamples

CodeExamples

CodeExamples

CodeExamples

CodeExamples

InvestorRelations

InvestorRelations

Sources

opencollection: 1.0.0
info:
  name: FawryPay Server API
  version: '1.0'
items:
- info:
    name: Payments
    type: folder
  items:
  - info:
      name: Create a Charge
      type: http
    http:
      method: POST
      url: https://atfawry.fawrystaging.com/ECommerceWeb/Fawry/payments/charge
      body:
        type: json
        data: '{}'
    docs: 'Create a payment request. Used both for card / e-wallet payments and

      for generating a FawryPay reference number that the customer can pay

      at a Fawry retail POS, ATM, or banking channel. The `paymentMethod`

      field selects the channel (e.g. `PayAtFawry`, `CARD`, `MWALLET`).

      '
- info:
    name: Refunds
    type: folder
  items:
  - info:
      name: Refund a Paid Order
      type: http
    http:
      method: POST
      url: https://atfawry.fawrystaging.com/ECommerceWeb/Fawry/payments/refund
      body:
        type: json
        data: '{}'
    docs: 'Refund all or part of a previously paid FawryPay order. The

      `refundAmount` must not exceed the original payment amount and the

      order must be in a refundable status.

      '
- info:
    name: Orders
    type: folder
  items:
  - info:
      name: Cancel an Unpaid Order
      type: http
    http:
      method: POST
      url: https://atfawry.fawrystaging.com/ECommerceWeb/api/orders/cancel-unpaid-order
      body:
        type: json
        data: '{}'
    docs: 'Cancel a FawryPay order that has not yet been paid. Use the Refund API

      instead if the order has already been settled.

      '
  - info:
      name: Get Payment Status
      type: http
    http:
      method: GET
      url: https://atfawry.fawrystaging.com/ECommerceWeb/Fawry/payments/status/v2
      params:
      - name: merchantCode
        value: ''
        type: query
      - name: merchantRefNumber
        value: ''
        type: query
      - name: signature
        value: ''
        type: query
        description: SHA-256 hash of `merchantCode + merchantRefNumber + secureKey`.
    docs: 'Pull the current status of a FawryPay order by merchant code and

      merchant reference number. Equivalent payload is also delivered via

      the server notification v2 push webhook configured per merchant.

      '
- info:
    name: Installments
    type: folder
  items:
  - info:
      name: List Installment Plans
      type: http
    http:
      method: GET
      url: https://atfawry.fawrystaging.com/ECommerceWeb/api/merchant/installment-plans
      params:
      - name: merchantCode
        value: ''
        type: query
    docs: 'Return the bank installment plans configured for the calling merchant

      account, including supported banks, tenors, and minimum order values.

      '
bundled: true