> ## Documentation Index
> Fetch the complete documentation index at: https://flutterwaveinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Fawry Pay
> Allow customers to securely make payments using Fawry Pay.
We recommend checking out the [introductory
section](/payment-api/introduction) to understand the basics of direct
charge first. This guide assumes you've read that.
Fawry payments are agency-based payments that are initiated by users online and to be completed offline. With this payment method, customers can make seamless payments over the counter to a wide range of connected agent networks.
This method supports payment in **Egypt** and **Morroco**. Kindly contact at
[hi@flutterwavego.com](mailto:hi@flutterwavego.com) to request this feature on your account.
## Prerequisites
Before starting your integration, ensure that your Flutterwave account is live. We would communicate any additional requirements for this payment method via email.
## Payment Flow
Users making payments with this method receive a reference from Fawry on their mobile to complete the transaction with an agent or at an ATM.
To successfully collect payments from your customers via Fawry pay, You are to complete these steps:
1. Initiate the charge.
2. Make the over the counter (OTC) payment.
3. Verify the payment.
### Initiating the Charge
To initiate the payment for the customer, pass their email address, the transaction amount, currency, and reference (see [here for optional information](/api-reference/charges#fawry-pay) to include in your request).
Here is a sample request that includes the required parameters along with some optional ones.
```json Sample Request theme={null}
{
"tx_ref": "fawrySample1",
"amount": "10",
"email": "user@flw.com",
"currency": "EGP",
"phone_number": "09012345678",
"redirect_url": "https://www.flutterwave.com",
"meta": {
"name": "Cornelius",
"tools": "Postman"
}
}
```
On making a successful request, you should get a 200 response.
```json Sample Response (200) theme={null}
{
"status": "success",
"message": "Charge initiated",
"data": {
"id": 3907288,
"tx_ref": "fawrySample1",
"order_ref": "URF_FAWRY_1667168731662_2318135",
"flw_ref": "9200967586",
"device_fingerprint": "N/A",
"amount": 10,
"charged_amount": 10,
"app_fee": 0.23,
"merchant_fee": 0,
"processor_response": "Request is pending",
"currency": "EGP",
"narration": "Flutterwave Developers",
"status": "pending",
"auth_url": "N/A",
"payment_type": "fawry_pay",
"fraud_status": "ok",
"charge_type": "normal",
"created_at": "2022-10-30T22:25:31.000Z",
"account_id": 20937,
"customer": {
"id": 1869436,
"phone_number": "09012345678",
"name": "Anonymous customer",
"email": "user@flw.com",
"created_at": "2022-10-30T22:25:31.000Z"
}
},
"meta": {
"authorization": {
"mode": "fawry_pay",
"instruction": "Please make payment with the flw_ref returned in the response which should be the same as the reference sent via SMS"
}
}
}
```
```json Sample Response (400) theme={null}
{
"status": "error",
"message": "Merchant is not enabled for Fawry Pay collections.",
"data": null
}
```
### Making Payment
After initiating the payment successfully, The customer receives a notification from Fawry with a payment reference that is used to identify the transaction (see sample notification below).
The customer then proceeds to complete this payment with an agent. Once the funds are received, Flutterwave sends you a [webhook](/webhooks) with the final status of the transaction.
```json Sample Webhook theme={null}
{
"event": "charge.completed",
"data": {
"id": 3907467,
"tx_ref": "fawrySample2",
"flw_ref": "9200692338",
"device_fingerprint": "N/A",
"amount": 10,
"currency": "EGP",
"charged_amount": 10,
"app_fee": 0.23,
"merchant_fee": 0,
"processor_response": "Fawry charge completion successfully mocked",
"auth_model": "CASH",
"ip": "52.209.154.143",
"narration": "Flutterwave Developers",
"status": "successful",
"payment_type": "fawry_pay",
"created_at": "2022-10-31T00:09:06.000Z",
"account_id": 20937,
"customer": {
"id": 1869436,
"name": "Anonymous customer",
"phone_number": "09012345678",
"email": "user@flw.com",
"created_at": "2022-10-30T22:25:31.000Z"
}
},
"meta_data": {},
"event.type": "FAWRY_PAY_TRANSACTION"
}
```
### Verifying the Transaction
Once the transaction is completed, you must [verify](/transaction-verification) the status and amount of the transaction before giving value. This should be done for both transaction polling and webhook streaming.
## Next Steps
That’s it! You’ve successfully implemented Fawry Pay. You can learn more about [Fawry here](https://fawry.com/).