Fintech Processor Microservice
Zenoti integrates with the Fintech Processor microservice to support center-level payment account configurations, balance store migration, and reserve analysis webhook processing. This article explains what this integration does and how it affects your centers.
Audience: Organization administrators and center managers who oversee payment processor configuration and account management.
Before you begin
- Your organization must have an active payment processor configured in Zenoti.
- You must have access to center-level configuration settings.
Permission: You need the appropriate administrative permissions to manage payment processor settings at the center level. Contact your Zenoti administrator if you are unsure whether your security role includes these permissions.
Steps
Understand what the Fintech Processor microservice does
The Fintech Processor microservice operates at the center level and handles three distinct functions:
Center-level account configurations — The microservice manages payment account settings specific to each center. Each center maintains its own account configuration, which means changes made for one center do not automatically apply to other centers in your organization.
Balance store migration — When your organization migrates stored payment account data between processors or updates account structures, the microservice coordinates the movement of balance information to ensure continuity of stored accounts for your guests.
Reserve analysis webhook processing — The microservice receives and processes webhook events related to reserve analysis from your payment processor. These events update Zenoti with reserve status information that affects how funds are held and released for your centers.
Note: Webhook event names, payloads, and subscription configuration for reserve analysis are documented in the Zenoti APIs category. This article covers only the user-visible outcomes of webhook processing.
Verify center-level account configuration
After your payment processor is set up, confirm that each center has its account configuration applied correctly:
- Navigate to Configuration > Payments > Process payments.
- Select the center you want to review from the center selector.
- Confirm that the payment processor account details are active for that center.
- Repeat this process for each center that requires its own account configuration.
Important: Because the Fintech Processor microservice operates at the center level, each center must be configured individually. A configuration applied at the organization level does not automatically propagate to all centers through this microservice.
Monitor balance store migration status
If your organization is undergoing a balance store migration — for example, when switching payment processors or restructuring stored accounts — work with your Zenoti account team to initiate and track the migration. The microservice handles the technical transfer of balance data, but you should verify the following after migration is complete:
- Confirm that guest stored accounts are accessible at the point of sale.
- Process a test transaction to verify that stored accounts function correctly after migration.
- If a stored account is not available after migration, contact Zenoti Support to investigate the migration status for that account.
Note: Card migration is distinct from processor setup. For processing payments at the point of sale, see Invoices and Billing.
Review reserve analysis outcomes
Reserve analysis webhook processing runs automatically when your payment processor sends reserve-related events to Zenoti. You do not need to trigger this process manually. To review the outcome of reserve analysis for your centers:
- Navigate to Configuration > Payments > Process payments.
- Select the relevant center.
- Review the account status information displayed for that center to confirm reserve details are current.
If reserve information appears outdated or incorrect, contact Zenoti Support and provide the center name and the date range in question.
Tips
- Configure each center's payment account separately. The Fintech Processor microservice applies settings at the center level, so a single organization-level change does not automatically update all centers.
- Before initiating a balance store migration, document the current stored account count for each center so you can verify completeness after migration.
- If a center's reserve analysis data appears stale, check whether the payment processor has sent recent events. Reserve analysis updates depend on webhook delivery from the processor, so connectivity issues on the processor side can delay updates in Zenoti.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| A center's payment account configuration is missing after setup | The microservice applies configuration per center; the center may not have been configured individually | Navigate to Configuration > Payments > Process payments, select the affected center, and complete the account configuration for that center |
| Guest stored accounts are unavailable after a balance store migration | Migration may not have completed for all accounts | Contact Zenoti Support with the center name and affected guest details to investigate the migration status |
| Reserve analysis information for a center has not updated | Webhook delivery from the payment processor may have been interrupted | Verify that your payment processor is sending events; contact Zenoti Support if the issue persists |