## Zoho Invoice — Product, features, payments, integrations, solutions, and help Index

Access the complete documentation index at:
https://www.zoho.com/ke/invoice/llms.txt

Use this file to discover all available documentation pages before proceeding.

# Zoho Invoice - Safaricom M-PESA Integration

Zoho Invoice integrates with Safaricom M-PESA - a Kenyan payment gateway, to simplify the payment process for the customers. It is a mobile payment solution that paves the way for quick and hassle-free payments.

**Note:** This integration is available only in the Kenya edition of Zoho Invoice and the currency supported is KES.

## Generate App Credentials in Daraja 2.0

Before setting up the M-PESA payment gateway in Zoho Invoice, create an app in Daraja 2.0 (Safaricom Developers Portal) to generate credentials to configure the payment gateway.

To do this:

*   Go to the [Daraja 2.0 website.](https://developer.safaricom.co.ke/)
*   Click **LOGIN / SIGN UP.**
*   Enter your login credentials if you have an account, or click **GO TO SIGN UP** to create an account.
*   Click **CREATE NEW APP** in the _Search Bar_ on the MY APPS page.

![Daraja 2.0 Craete New App](/ke/invoice/help/images/m-pesa-integration/create-new-app.png)

*   Provide a name for the app and mark the check box next to _Lipa Na M-PESA Sandbox_, the option that allows customers to make online payments securely.

![Daraja 2.0 Create New App Pop-up](/ke/invoice/help/images/m-pesa-integration/zoho-invoice-credentials.png)

*   Click **CREATE APP**. Your app will be created and displayed on the _My Apps_ page along with the _Consumer Key_ and the _Consumer Secret_.
*   Go to the _GO LIVE_ tab to take the app live.
*   Fill in the required fields, and a pass key will be generated and sent to you via email.

When you set up the M-PESA integration in Zoho Invoice, these credentials will be required.

![Daraja 2.0 Take App Live](/ke/invoice/help/images/m-pesa-integration/go-live.png)

## Set up the M-PESA Integration

Once you’ve created the app and generated the credentials, you can set up the payment gateway in Zoho Invoice. Here’s how:

*   Navigate to _Settings_ and click **Online Payments.**
*   Go to the _Alternative Modes_ section and click **Set up Now** near Safaricom M-PESA.

![Set Up M-PESA Integration](/ke/invoice/help/images/m-pesa-integration/set-up-now.png)

*   Fill in the following details to proceed with the setup:
    
    Field
    
    Description
    
    **Business Short Code**
    
    A unique identification number is sent to your email by the Safaricom team. This allows customers to pay money to business accounts through the M-PESA app.
    
    **Consumer Key**
    
    The Consumer Key can be copied from the app you created in Daraja 2.0 (Safaricom Developers Portal).
    
    **Consumer Secret**
    
    The Consumer Secret can be copied from the app you created in Daraja 2.0 (Safaricom Developers Portal).
    
    **Pass Key**
    
    The Pass Key is sent to your email by the Safaricom team once you take your app live.
    

![Zoho Invoice M-PESA Integration](/ke/invoice/help/images/m-pesa-integration/set-up-credentials.png)

*   Click **Confirm**.

Your M-PESA account will be integrated with Zoho Invoice.

## Receive Payments from Customers

To receive payments from your customers, mark M-PESA as the payment option in the invoices you create for them. The option will be available at the bottom of the invoice creation page.

![Invoice Creation](/ke/invoice/help/images/m-pesa-integration/m-pesa-invoice.png)

Once the payment option is enabled and the invoice is sent, your customers can pay from the Customer Portal or the invoice link that you’ve sent.

To do this, your customer will have to:

*   View the invoice from the Customer Portal or the shared link.
*   Click **Pay Now** in the top-right corner of the page.

![Customer Portal Invoice](/ke/invoice/help/images/m-pesa-integration/pay-now.png)

*   Provide their Mobile Number and click **PROCEED TO PAYMENT**.

![Customer Portal Proceed to Payment](/ke/invoice/help/images/m-pesa-integration/proceed-to-payment.png)

*   A payment request will be sent to the M-PESA app linked to the mobile number.
*   Enter the M-PESA PIN and click **Reply** to make the payment.

The payment will be processed, and the status will be reflected in Zoho Invoice.

![Customer Portal Payment Success](/ke/invoice/help/images/m-pesa-integration/payment-successful.png)

In case the payment fails, the customer can click **Try Again** to initiate the payment.

![Customer Portal Payment Failed](/ke/invoice/help/images/m-pesa-integration/payment-failed.png)

**Note:** In case you’ve initiated the payment, and the Payment Processing pop-up appears, you can check the payment status later in the invoice page for the final status.

## Other Actions

You can perform other actions such as editing and deleting the integration.

### Edit Integration

You can edit the bank account that you have provided while setting up the M-PESA payment gateway. To edit:

*   Navigate to _Settings_, and click **Online Payments.**
*   In the _Alternative Modes_ section, you will find the M-PESA payment gateway.
*   Click **Edit Settings**.

![Edit Integration](/ke/invoice/help/images/m-pesa-integration/edit-settings.png)

*   Edit the required details and click **Confirm**.

The payment gateway settings will be updated.

### Delete Integration

To delete:

*   Navigate to _Settings_, and click **Online Payments.**
*   Go to the _Alternative Modes_ section and click the **Trash** icon next to Safaricom M-PESA.
*   Confirm your action in the dialog box that follows.

The integration will be deleted and your customers will no longer be able to initiate payments via M-PESA.