=== Fapshi for Give ===
Contributors: sureadsman
Tags: give, donations, mobile-money, cameroon, fapshi
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept MTN Mobile Money and Orange Money donations in Cameroon via Give using the Fapshi payment gateway.

== Description ==

Fapshi for GiveWP adds a Mobile Money payment gateway to your Give donation forms. Donors in Cameroon can pay with MTN MoMo or Orange Money; they enter their phone number, receive a USSD prompt on their phone, and approve with their PIN. No redirect required in the default (direct pay) mode.

= Requirements =

* WordPress 6.0+
* Give 3.x+
* PHP 7.4+
* An [activated Fapshi account](https://docs.fapshi.com/en/guides/getting-started/activate-account) and a [collection service](https://docs.fapshi.com/en/api-reference/create-a-service)
* Site currency set to XAF (CFA Franc)

= Features =

* Direct pay (default): donor stays on your site, USSD push sent to their phone.
* Initiate pay: redirect to Fapshi's hosted page, return after payment.
* Supports both Give v2 legacy forms and v3 Visual Builder forms.
* Webhook handling, real-time status polling.
* English and French translations available via translate.wordpress.org.

= External Service =

This plugin connects to the [Fapshi](https://fapshi.com) payment gateway to process Mobile Money donations. Donor phone numbers are sent to Fapshi's servers to trigger the USSD payment prompt. An activated Fapshi account with a collection service is required. Before enabling this gateway, please review:

* [Fapshi Terms and Conditions](https://www.fapshi.com/en/terms-and-conditions)
* [Fapshi Privacy Policy](https://fapshi.com/en/privacy-policy)

== Installation ==

1. Upload the `fapshi-for-give` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu.
3. Go to **GiveWP → Settings → Payment Gateways → Fapshi** and enter your API credentials.
4. Paste the webhook URL shown in the settings into your Fapshi dashboard.
5. Enable the gateway on your donation forms.

== Frequently Asked Questions ==

= Where do I get API credentials? =
Log in to your [Fapshi dashboard](https://dashboard.fapshi.com), [create a service](https://docs.fapshi.com/en/api-reference/create-a-service) and copy your [API user and API key](https://docs.fapshi.com/en/api-reference/preliminary-knowledge/api-credentials) (test with Sandbox details and collect real money with the Live credentials)

= Does this support recurring donations? =
No. Mobile money has no saved credential to charge on a schedule, so recurring donations are out of scope. One-time donations only.

= How do refunds work? =
Refunds must be processed manually from your Fapshi dashboard. The plugin will show a clear message in GiveWP if you try to refund through WP.

== Screenshots ==

1. Direct pay phone field on a v3 donation form.
2. Fapshi settings page inside Give.
3. Payment status polling.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
