ZenotiHelp

Processor: Ebs

ZTZenoti Docs Team Updated September 5, 2026 3 min readGuide

EBS is a V1 payment processor configured at the center level, primarily used for hosted-page online card payments in the Indian market. Terminals and card-on-file storage are not supported.

Before you begin

Permission: Center-level payment configuration access is required.

EBS merchant-side prerequisites

  • Active EBS merchant account activated for your currency and card schemes.
  • Per-scheme activation — Visa, Mastercard, RuPay, and wallet rails are activated individually; confirm each channel you plan to enable.
  • Return URL allow-list — EBS must know the Zenoti return domain.

Credentials

Field Source / owner What to enter
Account ID EBS merchant portal / EBS representative The account identifier issued on activation.
Secret key EBS merchant portal / EBS representative Signs outbound requests and verifies responses. Regenerating on the EBS side invalidates the Zenoti copy.

Network requirements

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

EBS capabilities in Zenoti

Capability Supported
Online card payments (HPP) Yes
Refund Yes
Void (pre-settlement) Yes
Stored accounts No (CanProcessorSaveCards = false)
Recurring card-on-file No
Terminal (POS (Point of Sale)) No

Capability correction (April 2026): That is incorrect — the EBS processor class does not save cards. For stored-account flows, choose a different processor.

Configure EBS

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

Process a payment

  1. Guest selects EBS at Webstore checkout.
  2. Zenoti redirects to the EBS hosted page.
  3. Guest completes payment.
  4. EBS redirects back and sends a server-to-server callback; Zenoti closes the invoice on success.

Process a refund

Refunds use the Account ID and Secret key.

Refund — dual-system perspective

System What happens
Zenoti Negative payment line; Collections report shows the refund row.
EBS Separate refund record against the original transaction; appears on the EBS merchant portal report. Match key: EBS transaction ID or Zenoti invoice number.

Process a void

Voids cancel an authorised but unsettled charge. Post-settlement, use a refund.

Edit or reverse a posted payment

Invoice state What you can do
Open Remove the payment line, then void (pre-settlement) or refund (post-settlement).
Closed Reopen if permissions allow, or post a compensating refund. Original line preserved.

Failure modes

Failure mode User-visible symptom Resolution
EBS unreachable HPP fails to load. Check HTTPS path and EBS status.
Authentication / signature mismatch All transactions fail with auth error. Re-copy Secret key from the EBS portal.
Card declined HPP shows issuer decline. Guest retries.
Amount out of range EBS rejects. Per-channel limits; contact EBS.
Currency mismatch Rejected. EBS is India-focused and typically INR. Confirm with EBS.
Settlement failure Approved but missing from settlement report. Raise with EBS support using the transaction ID.

Settlement and reconciliation

EBS settlement in India is typically T+1 to T+3 working days, excluding weekends and Indian bank holidays (including regional festival periods). [SOURCE GAP — PM VERIFY: exact T+N per channel.]

Source Report / view Match key
Zenoti Collections report (filter: Payment Method = EBS) EBS transaction ID + Zenoti invoice number
EBS EBS merchant portal settlement report Same fields

Recommended cadence: daily.

Tips

  • EBS is primarily used for online payment flows. Verify that your account is in production mode before processing live payments.
  • Contact your EBS account representative if you encounter credential validation errors.
Was this article helpful?
Your feedback helps us improve our documentation.