Troubleshooting ACH Bank Account Setup Errors
Introduction
This article guides Sellers through resolving ACH bank account setup errors that occur when integrating with Stripe through the AppXite Platform. When adding bank account information via the portal, users may encounter communication errors with the Payment Service. The article explains the root cause—incomplete Stripe financial connection registration—and provides step-by-step resolution instructions, including required permission configurations.
In this article:
When adding bank account (ACH) information through the AppXite Platform, users may encounter the following error message displayed in a modal dialog:
Understanding the Error Message
The system displays the following error when ACH bank account setup fails:
"Sorry, there is an error during communication with Payment Service. Please, try again or contact support for more details."
This error appears in a payment method configuration dialog and indicates a failure in the communication between AppXite and Stripe's financial connections service.
Root Cause Analysis
AppXite Platform integrates with Stripe for processing ACH payments. The error occurs due to insufficient Stripe account configuration:
- Your Stripe account lacks a registered financial connection
- Financial connections may be enabled but require completed registration process
- Required permissions are not properly configured in your Stripe dashboard
Even when financial connections appear "enabled" in Stripe, the service requires a fully completed registration process with appropriate permissions to function correctly with AppXite.
Resolution Steps
Follow these sequential steps to resolve the ACH setup error:
- Initiate Connection Attempt Begin by attempting to add your ACH bank account from the AppXite Platform. This step is necessary to initiate the connection with Stripe. If you encounter the error message described above, proceed to step 2.
- Complete Stripe Financial Connection Setup Navigate to your Stripe dashboard and complete the financial connection configuration: https://dashboard.stripe.com/settings/financial-connections The Seller must enable all necessary permissions on Stripe as detailed in the next section.
Configuring Stripe Permissions
In the Stripe financial connections setup, you must enable the following data types by selecting all applicable checkboxes:
- Tokenized account and routing number - Enables secure bank account identification and money transfers
- Balances - Provides access to current and pending account balances for transaction verification
- Transactions - Allows viewing transaction details including amounts, merchants, and dates
- Account ownership details - Enables verification of account holder information for fraud prevention
After configuring all required permissions, you can proceed with adding bank account (ACH) information for your Customers through the AppXite Platform.
Summary
ACH bank account setup errors in AppXite typically result from incomplete Stripe financial connection registration. Sellers can resolve these issues by completing the Stripe financial connections setup and enabling all required permissions (tokenized account information, balances, transactions, and account ownership details). Once properly configured, the integration allows seamless ACH payment processing for Customer transactions.
Add comment
Please sign in to leave a comment.