Configure bank accounts for payments
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.
Link a bank account for payouts
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.
- In the onboarding wizard, navigate to the Bank Account step.
- Enter the bank account details:
- Account holder name
- Routing number (for U.S. banks)
- Account number
- Account type (checking or savings)
- 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.
- 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:
- In the bank account step of Adyen onboarding, select Automatic Bank Verification.
- The system opens a secure hosted bank authentication page.
- Select your bank from the list of supported institutions.
- Enter your online banking credentials.
- Provide additional verification if prompted (such as a one-time password sent by your bank).
- Select the bank account you want to use for payouts.
- 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:
- The guest enters their bank account details (routing number, account number, account type).
- The system creates the link with an initial status and begins verification through the ACH processor.
- Verification typically takes 1โ2 business days.
- 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.
Bank account link statuses
| 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. |
Handle expired or failed links
If a bank account link shows Expired or Failed status:
- Navigate to the bank account management area.
- Select the failed or expired link.
- Verify the bank account details are correct.
- 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:
- Go to Configuration > Payments > Process payments > Payment processor onboarding.
- Locate your Zenoti Payments business in the grid.
- Click the three-dot menu (โฎ) next to the business and select View business details.
- The system prompts for Sign in โ enter the one-time password (OTP) sent to your business email to verify your identity.
- In the left navigation, select Bank accounts.
- Select the bank account you want to update and click Edit.
- 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.
- 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.
- Click Save. The system redirects you to the Billing Account page to re-accept the Terms and Conditions.
- 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.
- 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.
- Next to Email, select Change.
- 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.
- Select Send Verification Code.
- 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. |