ZenotiHelp

Processor: Juspay

ZTZenoti Docs Team Updated September 5, 2026 3 min readGuide

JusPay is a V1 payment processor configured at the center level. It is an online payment-orchestration gateway primarily serving the Indian market β€” JusPay itself routes the transaction across underlying acquirers and payment methods (cards, UPI, wallets, net banking) per merchant configuration.

Before you begin

Permission: Center-level payment configuration access is required.

JusPay merchant-side prerequisites

  • Active JusPay merchant account with underlying acquirer(s) onboarded.
  • Method activation β€” JusPay activates cards, UPI, wallets, and net banking per merchant. Confirm each channel you plan to enable.
  • Return URL allow-list β€” JusPay must know the Zenoti return domain.

Credentials

Field Source / owner What to enter
Merchant ID JusPay dashboard / account representative The merchant identifier.
API key JusPay dashboard API key bound to the merchant. Treat as sensitive.

Network requirements

Direction Port Protocol Why
Outbound from Zenoti to JusPay API 443 HTTPS Create order, refund, status
Outbound from guest browser to JusPay HPP (Hosted Payment Page) 443 HTTPS Hosted payment page
Outbound from JusPay to Zenoti 443 HTTPS Post-payment callback

JusPay capabilities in Zenoti

Capability Supported
Online card payments (HPP) Yes
UPI / net banking / wallets (orchestrated) Yes β€” per methods JusPay activates
Refund Yes
Void No (VoidTransaction not in code)
Stored accounts No (CanProcessorSaveCards not set true in code)
Recurring card-on-file No
Terminal (POS (Point of Sale)) No

Capability correction (April 2026): None of those are supported in the JusPay processor class today. If you need those capabilities, choose a different processor.

Configure JusPay

  1. At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
  2. Select JusPay as the payment processor.
  3. Enter the Merchant ID and API key.
  4. Enable the payment channels activated on the JusPay side.
  5. Select Save.
  6. Select Test to verify.

Process a payment

  1. Guest selects JusPay at Webstore checkout.
  2. Zenoti redirects to the JusPay hosted page.
  3. Guest picks a method (card, UPI, net banking, wallet) and completes payment.
  4. JusPay redirects back with the result and sends a server-to-server callback; Zenoti closes the invoice on success.

Process a refund

Refund β€” dual-system perspective

System What happens
Zenoti Negative payment line; Collections report shows the refund row.
JusPay Separate refund record linked to the original order; visible on the JusPay dashboard. Match key: JusPay order ID or Zenoti invoice number.

Edit or reverse a posted payment

Invoice state What you can do
Open Remove the payment line, then refund if the charge has settled at JusPay. Void is not available β€” cancel before the guest completes on the HPP if possible.
Closed Reopen if permissions allow, or post a compensating refund.

Failure modes

Failure mode User-visible symptom Resolution
JusPay unreachable HPP fails to load. Check HTTPS and JusPay status.
Authentication / bad API key Every transaction fails with auth error. Re-verify Merchant ID and API key in the JusPay dashboard.
Card / method declined HPP shows underlying decline. Guest retries with another method.
Amount out of range JusPay / underlying acquirer rejects. Per-channel limits (UPI caps, wallet balance); contact JusPay.
Currency mismatch Rejected. JusPay is India-focused (INR). Confirm center currency.
Settlement failure Approved but missing from settlement. Raise with JusPay using the order ID.

Settlement and reconciliation

Settlement in India varies by channel and acquirer. Cards typically settle T+1 to T+2; UPI often T+1; net banking T+1. Working days exclude weekends and Indian bank / festival holidays. [SOURCE GAP β€” PM VERIFY: exact settlement per channel for JusPay.]

Source Report / view Match key
Zenoti Collections report (filter: Payment Method = JusPay) JusPay order ID + Zenoti invoice number
JusPay JusPay dashboard transactions and settlement reports Same fields

Recommended cadence: daily.

Tips

  • JusPay is designed for online payment flows in India. Verify that your JusPay account is configured for the payment methods you intend to support.
  • Contact your JusPay account representative if you encounter authentication errors.
Was this article helpful?
Your feedback helps us improve our documentation.