navariltd/Mpesa-On-Frappe-Cloud

# M-pesa Express Payments on Frappe Cloud ## Overview The Frappe Cloud M-Pesa Express integration enables seamless payment processing for users in Kenya via M-Pesa. One of the most widely used mobile money platforms in the region. This integration allows partners to receive payments and users to add credits effortlessly through M-Pesa Express. ---------- ## 1. Partner Setup ### Eligibility Only verified **Frappe Partners** can set up M-Pesa Express as a payment method. This means as a partner you need to contact Frappe and they will enable your account to set up M-Pesa Express. Each partner must have: - A registered **Daraja M-Pesa** account. - A valid **Paybill or Till Number**. - The appropriate credentials were obtained from Safaricom's Daraja portal. ---------- ### Steps to Set Up M-Pesa Express 1. **Navigate to the "Partnership" Section** on your Frappe Cloud dashboard(Only visible to partners). 2. You will find two last key tabs: - **Local Payment Setup** - **Partner Payout** ---------- ### A. Local Payment Setup This section is divided into two subsections: #### i. M-Pesa Express Credentials - Click the **Edit** button. - Fill in the following fields: - Consumer Key - Consumer Secret - Initiator Name - Pass Key - Security Credentials - Till Number - M-Pesa Setup ID (can be any meaningful name) - Click **Save**. #### ii. Payment Gateway - Configure the following details: - **Gateway Name** (e.g., "Navari Gateway") - **Endpoint URL**: Callback URL of the partner’s site where the invoice is created. - **API Key**: From the partner's site. - **API Secret**: From the partner's site. - **Currency**: Default is KES (Kenyan Shilling). - **Taxes**: Specify VAT (e.g., 16% in Kenya). - **Print Format**: Must match the format used on the partner's site. - Click **Save**. > ✅ Once these steps are completed, the M-Pesa integration is ready to accept payments. ---------- ### …