Payment Methods Available

Cards

payment_method_idBrand IDNamepayment_method_typeDetailsAllowed FlowsLogo
CARDVIVisaCARDCredit Card ​DIRECT REDIRECTLogo
CARDVDVisa Debit ​CARDDebit Card ​DIRECT REDIRECTLogo
CARDMCMasterCardCARDCredit Card ​DIRECT REDIRECTLogo
CARDMDMasterCard Debit ​CARDDebit Card ​DIRECT REDIRECTLogo
CARDMEMeeza ​CARDDebit Card ​DIRECT REDIRECTLogo

ℹ️

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

Alternative Payment Method

payment_method_idNamepayment_method_typeDetailsAllowed FlowsLogo
FWFawryTICKETCash paymentDIRECT REDIRECTLogo
RCOPayTICKETCash paymentDIRECT REDIRECTLogo
EWPaymob WalletBANK_TRANSFERWalletREDIRECT

Direct Alternative Payment Methods

Fawry

Example

curl -X POST \
    -H 'X-Date: 2018-02-20T15:44:42.310Z' \
    -H 'X-Login: sak223k2wdksdl2' \
    -H 'X-Trans-Key: fm12O7G9' \
    -H 'Content-Type: application/json' \
    -H 'X-Version: 2.1' \
    -H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \
    -d '{body}'
    https://api.dlocal.com/payments

{
    "amount": 100,
    "currency": "EGP",
    "country": "EG",
    "payment_method_id": "FW",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Amir Mazeh",
        "email": "[email protected]",
        "phone": "4832696773",
        "document": "12342412",
    },
    "order_id": "jv34281ny5",
    "description": "test",
    "notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}
{
    "id": "D-4-86dc111f-bc39-4df6-bb16-06a2e528b715",
    "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-22T21:59:00.000+0000",
        "image_url": "https://pay.dlocal.com/gmf/payments/M-c4418cdb-4526-4eea-9edc-33c54469b848",
        "amount": 100,
        "currency": "EGP"
    },
    "created_date": "2022-11-18T18:59:41.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "808a6614-ac5e-4f78-ab24-a9f34b2054d6",
    "notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}
Example Fawry UI built with the information in the example above.Example Fawry UI built with the information in the example above.

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

User Interfase 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.

ElementTip
Phone NumberWhen user 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 help users to make the payment, increasing conversion rates.
Service CodeIt 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 AmountShould be relevant elements in the ticket. Users need to have that information very clear.
EG Currency Symbol£
Expiration dateDisplay this element clear and visible enough. In Egypt the date format is DD/MM/YYYY format.
Payment instructionsAlthough 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 locatorLink it to https://fawry.com/storelocator
Save buttonIt help users to have their ticket always on their phone, making it needless to take notes or keep the browser opened.
Print buttonIt is useful for some users who need to have their tickets printed.