fawry

Integrate Fawry payments for cash-at-retail, BNPL, invoicing, and refunds.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/AfricanDigitalAssetFramework/africa-stack-skills --skill fawry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fawry
Source: https://github.com/AfricanDigitalAssetFramework/africa-stack-skills/tree/main/north-africa/fawry
Command: npx skills add https://github.com/AfricanDigitalAssetFramework/africa-stack-skills --skill fawry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool enables Egyptian businesses to accept payments through Fawry's API, including cash-at-retail, card, wallet, BNPL, and invoicing workflows, in a single integration.

Core Features & Use Cases

  • Initiate payments and obtain a reference number for PAYATFAWRY cash payments at Fawry outlets.
  • Check payment status, refunds, and invoicing flows to manage end-to-end transactions.
  • Support BNPL with ValU, invoice generation, and webhook-driven reconciliation for Egyptian merchants.

Quick Start

Configure your Fawry merchantCode and securityKey in your environment and start a PAYATFAWRY payment to obtain a reference number for cash payments at Fawry outlets.

Frequently Asked Questions about fawry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Fawry payments into an Egyptian online store?

You can integrate Fawry payments by configuring your merchantCode and securityKey as environment variables, then using the API to initiate payments, generate invoices, process refunds, and verify webhooks for your online store.

Can I accept cash-at-retail payments through Fawry's API?

Yes, you can accept cash-at-retail payments by initiating a PAYATFAWRY request through the Fawry API, which returns a reference number that your customers use to complete cash payments at physical Fawry outlets.

Does Fawry API integration support BNPL with ValU for Egyptian merchants?

Yes, the Fawry API integration supports Buy Now Pay Later through ValU, allowing Egyptian merchants to check BNPL eligibility and offer installment payment options alongside standard card and wallet transactions.

How do I verify Fawry webhook notifications for payment reconciliation?

You can verify Fawry webhooks by implementing webhook verification logic within your integration, ensuring that real-time payment status updates and transaction reconciliation events are authenticated using your configured securityKey.

What environment variables do I need to set up Fawry payment APIs?

You need to configure your Fawry merchantCode and securityKey as environment variables, along with the appropriate staging and production environment URLs, to authenticate and sign API requests for payment initiation and status checks.

Are Fawry API refunds supported for online marketplace transactions?

Yes, Fawry API refunds are supported for online marketplace transactions, allowing you to manage end-to-end transaction flows by initiating refunds and checking payment statuses directly through the API integration.