ZenotiHelp

Configure bank accounts for payments

ZTZenoti Docs Team Updated October 27, 2026 9 min readHow-to

Link and manage bank accounts for receiving payment processor payouts and for guest ACH (Automated Clearing House) payments. Proper bank account configuration ensures that settled funds reach the correct account and that guests can pay via bank transfer where supported.

Before you begin

Permission: Configure Payment Settings (under Payments) โ€” Required to link bank accounts during processor onboarding. For guest ACH linking, no additional permission is required beyond standard payment processing access.

  • Bank account linking for payouts is part of the payment processor onboarding process.
  • For guest ACH payments, your organization must have ACH payment processing enabled with a supported processor.

During payment processor onboarding, you link a bank account where the processor deposits your settled funds. This is a required step in the onboarding wizard.

  1. In the onboarding wizard, navigate to the Bank Account step.
  2. Enter the bank account details:
    • Account holder name
    • Routing number (for U.S. banks)
    • Account number
    • Account type (checking or savings)
  3. Upload one supporting document for the account โ€” a cancelled cheque, a recent bank statement, or a deposit slip. The upload takes a single file in PDF, PNG, JPG or JPEG format, no larger than 4 MB. The document must show the same account details and the same account holder that you entered in the previous step. If they do not match, Bank Account Verification fails. For the document quality rules and what to do when verification fails, see KYC failure scenarios and troubleshooting.
  4. Click Save to link the account.

The processor verifies the bank account details. Once verified, payouts are deposited to this account according to your payout schedule.

Automatic Bank Verification (Adyen)

For Adyen onboarding, an Automatic Bank Verification option is available as an alternative to manual bank account entry. This feature uses a secure hosted page to verify your bank account directly with your bank.

To use Automatic Bank Verification:

  1. In the bank account step of Adyen onboarding, select Automatic Bank Verification.
  2. The system opens a secure hosted bank authentication page.
  3. Select your bank from the list of supported institutions.
  4. Enter your online banking credentials.
  5. Provide additional verification if prompted (such as a one-time password sent by your bank).
  6. Select the bank account you want to use for payouts.
  7. Complete the authentication. The system redirects you back to Zenoti.

After successful verification, the bank name appears as read-only in the onboarding wizard. You cannot edit it manually after automatic verification.

Guest ACH bank account linking

Guests can link an ACH bank account for payment on supported channels. When a guest links a bank account:

  1. The guest enters their bank account details (routing number, account number, account type).
  2. The system creates the link with an initial status and begins verification through the ACH processor.
  3. Verification typically takes 1โ€“2 business days.
  4. Once verified, the guest can use the linked bank account for payments.

Bank account links have an expiration period. If the guest does not complete verification within the allowed time, the link expires and must be recreated.

Status Meaning
Invalid Initial state before verification begins.
Valid Account details verified but not yet confirmed for payments.
Success Account successfully linked and ready for payments.
Failed Verification failed due to invalid account details or bank rejection.
Expired The link expired before verification was completed.

If a bank account link shows Expired or Failed status:

  1. Navigate to the bank account management area.
  2. Select the failed or expired link.
  3. Verify the bank account details are correct.
  4. Resubmit the link to restart the verification process.

Bank payment statuses

Once a bank account is linked, every payment taken from it moves through its own set of states. These states describe a single payment, whether it was collected on its own or as one line inside a batch. Batch-level states are separate โ€” see Manage batch payments.

Status What it means for you
Initiated Zenoti has created the payment and is preparing to send it to the processor. No money has moved.
Pending The payment has reached the processor and is waiting to be picked up for processing.
Processing The processor is moving the funds. Bank payments stay here while the transfer clears.
Success The processor confirmed the payment and the funds have cleared.
Failed The payment did not go through โ€” for example, the bank rejected it or the account had insufficient funds. Collect the amount again using another payment method.
Cancelled The payment was stopped before the processor collected it. No money moved.
Refunded The payment cleared and the amount was later returned to the guest.
Chargeback The guest disputed the payment with their bank and the amount has been pulled back. See Defend payment disputes.
Unknown The processor has not returned a usable result for this payment. Check the payment again later; if the status does not resolve, contact Zenoti Support.

To follow bank payments as they move through these states, see Track ACH payments.

Scheduled bank collections

A payment can be scheduled to collect from a linked bank account on a future date. When the schedule is created, the payment is pre-authorized โ€” the guest authorizes the collection up front, so Zenoti can collect on the due date without asking the guest again.

Zenoti records every status change for a scheduled payment, so you can see which states the payment passed through and when each change happened. Use that history when a guest questions why a collection ran, or when you need to confirm that a failed collection was retried.

Scheduled collections can also be created, updated, and cancelled programmatically, so an integration can keep a guest's collection schedule in step with another system. For the rules that govern retries and status changes on failed collections, see Configure recurring payment rules.

Change bank details after onboarding

After you have completed payment processor onboarding, you can update your bank account details. Changing bank details triggers a mandatory KYC re-verification by the processor.

Important โ€” payouts pause during re-verification. When you update bank account details, the processor initiates KYC re-verification. Your centers can continue to accept payments during this period, but payouts are paused until re-verification completes. Verification timelines vary by processor and verification type: guest ACH bank-account linking typically takes 1โ€“2 business days; merchant bank-change KYC typically takes 5โ€“10 business days โ€” contact the Zenoti Payments Operations team for status.

Prerequisites:

  • The replacement bank account must be in the same country as your registered business entity. A country mismatch blocks the update.
  • Prepare a supporting document for the new account: a cancelled cheque, recent bank statement, or deposit slip.

To change bank details after onboarding:

  1. Go to Configuration > Payments > Process payments > Payment processor onboarding.
  2. Locate your Zenoti Payments business in the grid.
  3. Click the three-dot menu (โ‹ฎ) next to the business and select View business details.
  4. The system prompts for Sign in โ€” enter the one-time password (OTP) sent to your business email to verify your identity.
  5. In the left navigation, select Bank accounts.
  6. Select the bank account you want to update and click Edit.
  7. Update the account details using Manual entry or Automatic Bank Verification (Adyen). Both methods are available for post-onboarding changes, not only during initial setup.
    • Account holder name is pre-filled with your company name. Payouts are made to the merchant entity only.
  8. Upload the required supporting document (cancelled cheque, bank statement, or deposit slip). The upload takes one file in PDF, PNG, JPG or JPEG format, no larger than 4 MB. The document must show the same account details and the same account holder that you entered in step 7, because a mismatch fails Bank Account Verification. For the document quality rules and what to do when verification fails, see KYC failure scenarios and troubleshooting.
  9. Click Save. The system redirects you to the Billing Account page to re-accept the Terms and Conditions.
  10. Review and accept the Terms and Conditions. The bank change is submitted for processor re-verification.

Example: An organization moves its banking from one bank to another. In Bank accounts, the administrator edits the existing account, enters the new routing number and account number, leaves Account holder name as the registered company name, and uploads a single PDF bank statement of 1.2 MB that shows that same company name and the same account number. Payouts pause while the processor re-verifies the account, then resume to the new account.

Note: If you used Automatic Bank Verification (Adyen), the bank name appears read-only after verification completes โ€” it cannot be edited manually.

Monitor the KYC re-verification status in the KYC Summary section of the business details page. See Understand KYC/KYB status and center payment capabilities.

Change the business email used for sign-in

The business email is the address that receives the sign-in code for View business details. This procedure applies to businesses onboarded with Adyen โ€” the Change link next to Email appears only on the Adyen business details view.

Changing the email requires signing in with a code sent to the current registered address, so you can make this change only while that mailbox can still receive mail. If that mailbox can no longer receive mail, contact Zenoti Support.

  1. Go to Configuration > Payments > Process payments > Payment processor onboarding, open the three-dot menu (โ‹ฎ) next to your business, and select View business details. Sign in with the code sent to the current registered email.
  2. Next to Email, select Change.
  3. In Change Email Address, review Current Email and enter the New Email Address. The dialog confirms that the old address will no longer have access to this business.
  4. Select Send Verification Code.
  5. Enter the code sent to the new address.

From then on, sign-in codes for this business go to the new address.

Tips

  • Check that the account holder name on the supporting document matches the registered business name before you upload it. Payouts are made to the merchant entity only, so a document in an individual's name fails Bank Account Verification.
  • Plan a bank change for a period when payouts are not time-critical, because payouts pause while the processor re-verifies the new account.
  • Update the business email while the current mailbox is still active โ€” for example, before the person who owns it leaves the organization โ€” because the change begins with a code sent to that address.
  • Where Automatic Bank Verification is offered (Adyen), use it instead of manual entry to avoid transcription errors in routing and account numbers.

Troubleshooting

Problem What to do
Bank Account Verification failed after you uploaded a document. Compare the document against the details you entered. The account number, routing number, and account holder name must match exactly. Re-upload a document that shows the same details, then see KYC failure scenarios and troubleshooting.
The document upload is rejected. The upload takes one file only, in PDF, PNG, JPG or JPEG format and no larger than 4 MB. Combine multiple pages into a single file and compress or re-export it to fit the size limit.
A guest's bank account link shows Expired or Failed. Confirm the routing number, account number, and account type with the guest, then resubmit the link to restart verification.
Payouts have not arrived after a bank change. The processor pauses payouts during KYC re-verification. Check the KYC Summary section of the business details page; if re-verification is complete and payouts have still not resumed, contact the Zenoti Payments Operations team.
You cannot sign in to View business details because the registered mailbox no longer receives mail. Contact Zenoti Support.
A scheduled bank collection shows Failed. Collect the amount using another payment method and ask the guest to confirm the bank account is still valid. Review your retry rules in Configure recurring payment rules.
Was this article helpful?
Your feedback helps us improve our documentation.