How to set up Zoho Checkout's Payment Gateway

How to set up Zoho Checkout's Payment Gateway

To set up Zoho Checkout's Payment Gateway:
  1. Navigate to Control Panel > Developer space > Zoho Checkout Integration.

    Create or connect an organization

  2. Click Create / Connect Organization.
  3. Enter the required details, primarily the Business Location & Currency, and click Create to add a new organization. 
    Add organization
    Note: 
    1. Based on the selected Location & Currency, a list of available payment gateways in that region will be displayed by Zoho Checkout. 
    2. Any existing organizations that you have already added in Zoho Checkout will be listed under Organization Name. If selected, the other details will be auto-filled, and the available payment gateways will be shown. To add a new organization, click Create.
    Notes
  4. Once the organization is added click on it and select Connect Payment Gateway to configure payment gateways from Zoho Checkout. 

    Connect Payment Gateway

  5. On the Zoho Checkout page, configure one or more payment gateways. Learn More

    Configure payment gateways from Zoho Checkout

    Note:  For any payment gateways configured via Zoho Marketplace, payments will be processed using the currency set for your organization.
    Notes
  6. The configured payment gateways will be listed along with the supported currencies. To add more gateways, click +Add Payment Gateway. 

    Configured payment gateways

     Zoho Checkout Integration     is now complete.

    To process payments through Zoho Checkout, add a payment field in the builder, select Zoho Checkout's Payment Gateway as the payment method, and configure the payment details. Learn More

Payment Status Synchronization

To fetch the latest payment status for an entry that has been in the Processing status for a long time, you need to refresh the respective entry's Payment Status manually using the refresh icon.
The refresh functionality is only active when the Payment Merchant column is added to your All Entries view. To enable this: 
  1. Go to your All Entries tab. 
  2. Click the More icon in the top-right corner. 
  3. Select Additional Fields > Payment Merchant.
  4. Once enabled, a Refresh icon will appear next to the Payment Status column for each entry. Click this icon to fetch and update the latest status.
Payment Status:
All new transactions are marked as Processing initially. Successful payments typically update to Completed automatically after a short period. If a payment remains in Processing for an extended time, it may have failed. Click the Refresh icon to trigger a status check to update the entry.

Note: 
  1. In paid plans, a total of five organizations can be added. It is limited to one for free plan. 
  2. Only the super admin or admin of your Zoho Forms organization can configure Zoho Checkout’s Payment Gateway. Once configured, it can be used by all users in the organization for payment collection within their forms.
  3. The list of all added organizations can be viewed under Control Panel > Developer space > Zoho Checkout Integration. 
Notes