Enable Payex with Zoho Books

[Zoho Books] Enable Payex with Zoho Books

The first of its kind in Malaysia, Payex integration with Zoho Books enables you to accept online payments right from your accounting software! Your customers can now make payments through local Malaysian banks via FPX, credit cards and e-wallets when you issue them invoices. This integration was co-developed by Payex and Aplikasi development teams to allow you to receive payments and have them automatically marked as paid. These transactions will be booked to a dedicated general ledger for seamless bookkeeping. It will also capture the settlement details from Payex for easy reconcilliation. Follow our guide to enable this integration.

You first need a Payex account before you can enable the online payment option.
Refer to this article on how to register for an account with Payex
This extension is only available for these Zoho Books plans:
a. Premium
b. Finance Plus
c. One

1. Fill up this form to get the link to install the Payex extensions in Zoho Books. Enter your Zoho Books organization ID and superadmin email address in the form.

How to get your Organization ID?
Login to Zoho Books using your superadmin ID (account owner) and you may get the organization ID and email by clicking on your profile picture at the top-right of your screen.

2. You will receive 2 separate emails with a link to install the private extensions.
It will take up to 30 business minutes to receive the emails as a manual process needs to be done at the back end. This is a temporary measure and this step can be skipped once the extension is being made available publicly in Zoho Marketplace.

a. Installing the Payex Payment extension. This will enable the Payex payment gateway in Zoho Books.

Click the link in the first email


Choose your Zoho Books Organization, tick the TnC acceptance and click ‘Install Extension’.

b. Installing the Payex Settlement extension. This is to have dedicated accounts to book Payex'es transactions and to auto-capture the settlement transactions daily from Payex by running a scheduler.

Before you begin, prepare these parameters for use in the subsequent steps. Login to your Payex portal and go to Settings to get these:
You may only proceed if you have access to your Payex portal.

i. Payex MID

ii. Payex Merchant Email

iii. Payex Secret

Copy the secret using the copy button.

Once you have the parameters ready, proceed with these steps:


Click the link in the second email



Click 'Authorize' on the first connection 'Payex' to grant access.


Enter UserName as the value from step 2b(ii)
Enter Password as the value from step 2b(iii)


Click 'Authorize' on the second connection 'zbooks_payex' to grant access.




The connections are now authorized. Hit 'Next'.


MID - Get from step 2b(i)
Leave other fields blank

3. Once the installations are completed, you can see the extensions in your Zoho Books account under Settings->Marketplace.

4. These accounts will be created by the 'Payex Settlement' extension:

a. Payex Settlement - the deposit account for payments and settlement (fees)

b. Payex Fees - the account to record the fees as expenses

5. Go to Settings->Online Payments to configure the payment gateway.

Payex Online Payment Setup
a. In Zoho Books, go to Settings->Online Payments. From the list, you will see Payex and click ‘Set up Now’.

b. Enter your Payex registered email and merchant secret (from 2b). Also, choose 'Payex Settlement' from 4a as the bank account. Hit ‘Save’.

Your online payment gateway setup is now completed! Your customer may now pay you directly from the invoice that you sent them.

6. When creating an invoice, you will now see Payex as the option for the online payment.



A link will be available for your customer to click when they receive an invoice. Once clicked, they will be forwarded to Zoho Securepay payment page and they can proceed to make payments through the payment modes offered by Payex – FPX, Credit Card and e-Wallets.


You can now take advantage of attractive rates from Payex when customers pay using local Malaysian banks. Check out the rates here.

7. Once the customer has made a payment, a Payment Received record will be created in Zoho Books and the Invoice will be updated as Paid. This makes it easier to track the invoices that you have issued.



You may also generate Payment Links to get payments from your customer with Payex.

8. There will be instances where you need to pull the settlement transactions manually. By default, the scheduler will always get the settlement transactions from Payex for the current date. You will have the option to also pick the date range that you prefer.

a. Settings->Marketplace->Installed Extensions->Payex Fees->View Details->Configure. Enter your date range and hit 'Save'.

The dates' fields should always be left blank for auto-run. You only populate these fields if you need to do a manual pull of the settlement from your Payex portal.

b. Based on your preferred run date, then go to Settings->Automation->Schedules. Click on the small arrow next to 'Edit' and hit 'Execute Now'. This will run the scheduler for the date range that you have selected.



Don't forget to clear the dates after you are done with your manual execution. Failure to do so will cause the scheduler to only pick the date range in the settings.

9. You can now sit back, relax and let the scheduler run on its own to capture the settlement from Payex. The scheduler will perform matching and categorization for the transactions against the records in Zoho Books automatically. Payments will be matched while any fees will be categorized as expenses and reflected in the 'Payex Settlement' account (step 4a) and in the 'Payex Fees' account (step 4b). 

10. For bank account reconciliation, you may want to match the settlement amount from Payex that was deposited into your bank account (as registered in Payex portal).

a. If you have auto-feed enabled for your bank account in Zoho Books, you may see the settlement transaction(s) under the 'Uncategorized' tab in your bank account as below:

b. Go to the 'Payex Settlement' account to perform a fund transfer. We will treat this account as a clearing account where all funds need to be transferred to the actual bank account when you receive funds from Payex.



Enter details to match step 10a.


Once saved, the amount will be transferred to the bank account in 10a.

c. You can now perform a matching action in the bank account.

That concludes our setup for Payex online payment in Zoho Books. Feel free to reach us at support@aplikasi.us with the subject 'Payex Integration' if you need further assistance.

    • Related Articles

    • [Zoho Books] Payex Registration

      Zoho Books is now integrated with Payex - a Malaysian payment gateway provider with attractive rates. This means that you can now get your customers to make online payments through the invoices issued from Zoho Books and have them marked ...
    • [Zoho Books] What is Batch Tracking? and How to Use it?

      Batch tracking allows you to keep track of your goods in batches to monitor batch number, manufacturing date and expiry date. This function would enable you to keep track of your goods in which batch it belongs in the event of goods damages or ...
    • [Zoho Books] What is Price List? and How to Use it?

      In Zoho Books you can specify a set of price for our sales and purchase activity. Under price list module you can have a set of price for the below activity:- 1. Price for marketing and promotion 2. Price for certain or specific customer 3. Price for ...
    • [Zoho Books] How to Raise Debit Note

      Steps to Raise Debit Note First thing first you need to enable debit note under Settings -> Preferences -> General: Debit note can only be raised upon an Invoiced being approved and send to customer: You will be able to raise debit note under three ...
    • [Zoho Books] How to Manually Import and Upload Bank Statement?

      In Zoho Books, apart from leveraging the auto feed connection with your local bank to allow live feed of your bank transaction, you would also be able to manually import and upload your monthly bank statement for your monthly bank reconciliation ...