Zoho Payments

Zoho Payments is a payment platform that lets you accept in-person payments through POS terminal devices. You can set up Zoho Payments in Zoho Billing and record customer payments collected through your terminal devices directly against their invoices.

This setup applies to the India edition of Zoho Billing.

Set Up Zoho Payments Terminal

To set up Zoho Payments Terminal:

Go to Settings and select Payment Gateways under Online Payments.
Click Set Up Now next to Zoho Payments.
Follow the on-screen steps to complete the Zoho Payments sign-up process.
Once your Zoho Payments account is activated, it will be connected to your Zoho Billing organisation.

Configure Payment Terminal

After setting up Zoho Payments, you can add and manage your POS terminal devices to process in-person payments at your store.

To add a terminal device:

Go to Settings and select Payment Gateways under Online Payments.
Click Manage next to Zoho Payments.
Under the Terminal Devices tab, click Add Terminal Device.

Field	Description
Terminal ID	The unique identifier assigned to the POS terminal device. This can be found in your Zoho Payments dashboard under POS Terminals.
Terminal Name	A name to identify and distinguish the terminal device within your organisation.
Payment Gateway	The payment gateway assigned to process transactions through this terminal. This is pre-set to Zoho Payments.

Click Save.

Record a Terminal Payment From an Invoice

Use the invoice’s Details page when you want to record payment for a specific invoice.

To record a terminal payment from an invoice:

Go to Sales > Invoices.
Select the invoice for which you want to record payment.
Click the Record Payment dropdown.
Select Record Payment.
Enter the amount received.
Select Zoho Payments in the Payment Mode field.
Enter the terminal transaction reference shown on the POS device.
Click Record Payment.

If the full invoice amount is recorded, the invoice status changes to Paid. If only part of the invoice amount is recorded, the invoice status changes to Partially Paid.

Record Zoho Payments Terminal Payments

After setting up the Zoho Payments terminal, you can record payments received through the terminal from the Payments Received module.

To record the payment:

Go to Payments > Payments Received.
Click the + New button in the top right corner.
Select the customer from whom you received the payment.
Enter the amount received.
Select Zoho Payments as the Payment Mode.
Enter the terminal transaction details.
Apply the payment to the customer’s invoice.
Click Save.

The payment will be recorded against the selected customer and invoice.

More Actions

You can manage your existing Zoho Payments terminal devices using the following actions.

Delete Terminal Device

You can delete a terminal device that is no longer needed.

Go to Settings and select Payment Gateways under Online Payments.
Click Manage next to Zoho Payments.
Hover over the terminal device you want to delete and click the More icon.
Click Delete and OK to confirm the action.

Edit Terminal Device

You can update the details of an existing terminal device at any time.

Go to Settings and select Payment Gateways under Online Payments.
Click Manage next to Zoho Payments.
Hover over the terminal device you want to edit and click the More icon.
Make the necessary changes and click Save.

Mark a Terminal Device as Inactive

You can mark a terminal device as inactive to temporarily disable it without removing it from your configuration.

Go to Settings and select Payment Gateways under Online Payments.
Click Manage next to Zoho Payments.
Hover over the terminal device you want to mark as inactive and click the More icon.
Click Mark as Inactive.

Troubleshoot Terminal Payment Setup

If Zoho Billing does not accept the terminal value, check the details in your Zoho Payments dashboard and try again.

Use this checklist:

Confirm that the terminal device is active in your Zoho Payments dashboard.
Verify that the terminal ID entered in Zoho Billing matches the one shown under POS Terminals.
Contact Zoho Payments support if the terminal device is not visible in your dashboard.

After correcting the details, update the provider settings in Zoho Billing and save the changes.