Payment Methods Available

Cards

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

ℹ️
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_id`	Name	`payment_method_type`	Details	Allowed Flows	Logo
`FW`	Fawry	`TICKET`	Cash payment	`DIRECT` `REDIRECT`	Logo
`RC`	OPay	`TICKET`	Cash payment	`DIRECT` `REDIRECT`	Logo
`EW`	Paymob Wallet	`BANK_TRANSFER`	Wallet	`REDIRECT`

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.

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.

Element	Tip
Phone Number	When 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 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 help users to have their ticket always on their phone, making it needless to take notes or keep the browser opened.
Print button	It is useful for some users who need to have their tickets printed.