Processor: Ebs
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
- At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
- Select EBS as the payment processor.
- Enter the Account ID and Secret key.
- Enable the payment channels activated on the EBS side.
- Select Save.
- Select Test to verify.
Process a payment
- Guest selects EBS at Webstore checkout.
- Zenoti redirects to the EBS hosted page.
- Guest completes payment.
- 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.