Market specifications

Take a look of all the payment methods available.

Country reference Cards supported APM supported

Cards

Find all the information about the card supported capabilities.

Brands Capabilities Process Card Payments

Alternative Payments

Learn how to integrate cash, bank transfer or wallet payment.

Fawry Meeza Digital Network

Market specifications

Do you want to know more information about Egypt market? Go to the Egypt’s economy and eCommerce market article.

Country reference

`country` code	`currency` code	`amount` decimals	`document` name	`document` format	`document` required?
`EG`	`EGP`	2	ID	9 or 14 digits	Yes

Cards supported

`payment_method_id`	Brand ID	Name	`payment_method_type`	Details	Allowed Flows
`CARD`	`VI`	Visa	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`VD`	Visa Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`MC`	Mastercard	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MD`	Mastercard Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`ME`	Meeza	`CARD`	Debit Card	`DIRECT` `REDIRECT`

ℹ️
To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method supported

`payment_method_id`	Name	`payment_method_type`	Details	Allowed Flows	Logo
`FW`	Fawry	`TICKET`	Cash Payment	`DIRECT` `REDIRECT`
`EW`	Meeza Digital Network	`WALLET`	Wallet	`REDIRECT`

Cards

Brands

Meeza

Meeza is a debit and also prepaid card. People can use the Meeza card without the need to open a bank account. Shopping online, making transfers, and paying for different government and private-sector services are some of the merits granted to Meeza holders.

Notably, Meeza is the National Payment Scheme (NPS) of Egypt which is developed by EBC under the supervision of the Central Bank of Egypt.

Capabilities

	Visa Credit	Visa Debit	Mastercard Credit	Mastercard Debit	Meeza
Minimum amount	5 EGP	5 EGP	5 EGP	5 EGP	5 EGP
Refunds	Yes	Yes	Yes	Yes	Yes
Recurring	Yes	Yes	Yes	Yes	No
Chargeback option	Yes	Yes	Yes	Yes	No
Chargeback Dispute option	Yes	Yes	Yes	Yes	No
Descriptor	Can be personalized, depending on provider.	Can be personalized, depending on provider.	Can be personalized, depending on provider.	Can be personalized, depending on provider.	Can be personalized, depending on provider.

How to process Card Payments?

Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.

Alternative Payment Method

Fawry

Fawrys is the Leading Egyptian Digital Transformation & E-Payments Platform.

Fawry offers a convenient and reliable way to pay bills and other services in multiple channels (online, using ATMs, mobile wallets, and retail points).

Despite being able to pay online, most Egyptians will still pay through an offline location.

Capabilities

	Fawry
Min. amount	5 EGP
Max. expiration time supported	30 days
Notification delay	Immediate
Refunds	Yes
Flow	`DIRECT` `REDIRECT`

Request Parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`EGP` Transaction currency in ISO 4217.	Yes
`country`	String	`EG` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`FW` ID of the selected payment method.	Yes
`payment_method_flow`	String	`DIRECT` or `REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	Yes
`payer.phone`	String	Phone number of the payer.	No
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Example

{
    "amount": 100,
    "currency": "EGP",
    "country": "EG",
    "payment_method_id": "FW",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "document": "12345678901234",
        "address": {
            "country": "EG",
            "state":"Cairo",
            "city": "Cairo",
            "zip_code": "8858",
            "street": "Main St.",
            "number": "540"
        }
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "D-4-9a9fq217-a596-4ccd-9ea5-2b3a2e059cae",
    "amount": 100,
    "currency": "EGP",
    "payment_method_id": "FW",
    "payment_method_type": "TICKET",
    "payment_method_flow": "DIRECT",
    "country": "EG",
    "bank_transfer": {},
    "ticket": {
        "type": "REFERENCE_CODE",
        "number": "9204832859",
        "expiration_date": "2022-11-23T21:59:00.000+0000",
        "image_url": "https://pay.dlocal.com/gmf-apm/payments/M-5ea0d6a3-7df7-w2q8-9c1b-5aeae73a08a4",
        "amount": 100,
        "currency": "EGP"
    },
    "created_date": "2022-11-19T16:22:01.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "notification_url": "http://merchant.com/notification/new"
}

Example ticket

Example Fawry UI built with the information in the example above.

User Interface Tips UI

If you are using this payment method through a DIRECT integration, follow the tips below in order to make it easier for your customers to complete payments, boosting your conversion rates.

Element	Tip
Phone Number	When user's phone is included in the API request, an SMS with basic payment information is sent to the user. It is strongly recommended to ask and send user phone, since it helps users to make the payment, increasing conversion rates.
Service Code	It is important that you add this text كود الخدمة: 788 (Service code: 788). This identifies the payment beneficiary and many times helps cashiers to find the payment on their system.
Currency and Amount	Should be relevant elements in the ticket. Users need to have that information very clear.
EG Currency Symbol	£
Expiration date	Display this element clear and visible enough. In Egypt, the date format is DD/MM/YYYY format.
Payment instructions	Although most users are familiarized with Fawry, it is a good practice to help those who are not. In the image above there is an example of instructions, but if needed, our team will be happy to help you with more personalized instructions.
Store locator	Link it to https://fawry.com/storelocator
Save button	It helps users to have their tickets always on their phone, making it needless to take notes or keep the browser open.
Print button	It is useful for some users who need to have their tickets printed.

Meeza Digital Network

Meeza Digital Network serves millions of e-wallet users offering an easy, instant, and secured payment method. Utilizing mobile convenience, Meeza Digital connects e-wallets by various providers to enable instant transfers.

Capabilities

	Meeza Digital Network
Min. amount	5 EGP
Max. expiration time supported	1 day
Notification delay	Immediate
Refunds	Yes
Flow	`REDIRECT`

UX Flow

The screenshots illustrate a generic Wallet redirect flow. The specifics of the flow can change depending on the payment method selected to complete the transaction.

Request Parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`EGP` Transaction currency in ISO 4217.	Yes
`country`	String	`EG` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`EW` ID of the selected payment method.	Yes
`payment_method_flow`	String	`REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	Yes
`payer.phone`	String	Phone number of the payer.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 100,
    "currency": "EGP",
    "country": "EG",
    "payment_method_id": "EW",
    "payment_method_flow": "REDIRECT",
    "payment_method_type": "TICKET",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "phone": "01111710800",
        "document": "12345678901234",
        "address": {
            "country": "EG",
            "state":"Cairo",
            "city": "Cairo",
            "zip_code": "88058",
            "street": "Main St.",
            "number": "5940"
        }
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "R-4-70b68e57-fr54-42e7-af95-e0833358d62f",
    "amount": 100,
    "currency": "EGP",
    "payment_method_id": "EW",
    "payment_method_type": "BANK_TRANSFER",
    "payment_method_flow": "REDIRECT",
    "country": "EG",
    "created_date": "2023-01-24T14:09:53.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchant.com/notification/new",
    "redirect_url": "https://pay.dlocal.com/gmf-apm/payments-redirect/M-5770b9f9-1bf7-4069-8a0e-51b3322s42801"
}