Welcome to Customer Onboarding for
Salesforce Payment Gateway with InterWeave SmartSolutions
InterWeave SmartSolutions offers a structured onboarding process to facilitate seamless integration between your Customer Relationship Management (CRM) system and various financial applications. This process is designed to be collaborative, involving both your team and InterWeave’s Technical Specialists to ensure the integration aligns with your specific business processes and workflows.
Onboarding
This report provides a detailed, practical, and actionable guide for organizations seeking to implement, configure, and manage the integration between Salesforce, the InterWeave Customer Payment Portal, and InterWeave SmartSolutions. It addresses essential aspects from initial setup to ongoing operations and troubleshooting, offering precise information for technical administrators, IT managers, and implementation specialists responsible for system deployments. The analysis maintains a formal, instructional, and authoritative tone, guiding the reader through each step with clarity and precision.
This foundational section provides a comprehensive overview of InterWeave’s SmartIntegration Platform, detailing its core functionalities and how it facilitates seamless integration with Salesforce, with a specific focus on payment processing via its Customer Payment Portal.
- 1.1 Overview of InterWeave‘s SmartIntegration Platform and its Core Capabilities
InterWeave is positioned as an intelligent Cloud Integration Platform specifically designed for Customer Relationship Management (CRM) systems. It excels at integrating Financial Applications, Payments, and various Multi-Cloud Solutions, extending its capabilities to business-to-business (B2B) and business-to-consumer (B2C) connectivity, optimizing business processes, and enabling robust application integration.
A key differentiator of the platform is its highly configurable environment, which empowers business users to create, monitor, and manage sophisticated integration solutions in real-time. The user-friendly interface supports configuration through pick lists, drop-downs, and the addition of unlimited custom fields. Furthermore, the direction of integration (unidirectional or bi-directional) can be selected at the object level, offering significant flexibility in aligning with specific business processes and workflows. This deep-seated configurability, as opposed to rigid, code-heavy integrations, implies a significant reduction in the time and cost associated with both initial setup and ongoing maintenance. For a technical administrator, this translates directly into enhanced strategic agility, enabling the organization to rapidly adapt its integration workflows in response to evolving business processes, regulatory changes, or new market demands, all without requiring extensive custom coding or developer intervention. This inherent flexibility also minimizes the risk of vendor lock-in by supporting open APIs and a broad array of systems, positioning InterWeave as a highly adaptable solution for dynamic enterprise environments.
InterWeave boasts a proven track record, having integrated with over 48 ERP systems since 2006. Its platform includes 28 Protocol Specific Connectors, which collectively address more than 90% of known protocol standards, allowing for real-time data import and export from virtually any application possessing an API. The SmartIntegration Platform is strategically organized into three primary integration tenants: the Financial Accounting Integration Cloud, Payment Processing Solutions, and Multi-Cloud Integration, providing a structured approach to diverse integration needs. The cloud-native architecture directly translates to significant reductions in IT infrastructure, maintenance, and troubleshooting efforts related to on-premise software. This simplifies deployment, ensures higher availability and security (as Rackspace Managed Hosting is HIPAA and PCI-DSS compliant, and enables quicker “go-live” times, often within 10 to 15 business days.
- 1.2 Understanding the InterWeave Customer Payment Portal’s Role and Functionalities
The InterWeave Customer Payment Portal serves as a critical component, specifically configured to streamline Accounts Receivable (AR) processing. It acts as a central hub that unifies CRM, financial, and payment integrations, providing a cohesive ecosystem for managing customer transactions. This portal offers a hosted, self-service environment, empowering customers to independently view their invoices online, update their payment methods, and conveniently make payments. This self-service capability significantly enhances the customer experience by providing transparency and control over their financial interactions. From a business perspective, the self-service payment portal is more than just a technical feature; it is a strategic tool for improving the customer experience. By providing convenience and transparency, it reduces the need for manual intervention from the organization’s Accounts Receivable team, leading to faster payment cycles, improved cash flow, and ultimately, higher customer satisfaction.[1, 9] This directly translates into tangible business value, extending beyond mere technical functionality to impact financial health and customer loyalty.
Core payment functionalities supported by the portal include real-time acceptance or decline of transactions, the ability to set up scheduled payments for outstanding balances that execute automatically, and comprehensive recurring payment options. These include Automated Recurring Billing (ARB) for standard subscriptions and Custom Recurring Billing (CRB) for flexible payment plans with custom schedules. InterWeave’s extensive compatibility with over 48 Merchant Service Providers (MSPs) is a major advantage for businesses. This broad network includes industry leaders such as Authorize.net, PayPal, Transfirst, Chase Paymenttech, First Data, Vanco, iCash, Payment XP, Banktec, Teledraft, and Cybersource, ensuring that most businesses can integrate with their existing payment infrastructure.
1.3 Compatibility and Editions: Salesforce Versions Supported by InterWeave SmartSolutions
InterWeave’s SmartSolutions are designed for broad compatibility, supporting all major editions of Salesforce, including Professional, Enterprise, Unlimited, and Developer editions.[4] This ensures that organizations of varying sizes, complexities, and existing Salesforce deployments can seamlessly leverage InterWeave’s integration capabilities. The licensing and annual subscription fees for InterWeave’s internal e-commerce connector are structured to align with the specific Salesforce Edition chosen by the customer, indicating a tiered pricing model that scales with your business needs.
Beyond core integrations, InterWeave offers various editions and add-ons for its platform, which are feature-rich and extensible. These include specialized editions for Financial Services Integration, Payment Integration, and Multi-Cloud Integration, allowing businesses to tailor their solution precisely to their requirements enters this broad compatibility and tiered offering indicate that InterWeave is built for long-term scalability. An organization can initiate its integration with a basic Salesforce edition and a corresponding InterWeave solution, and then seamlessly upgrade both its Salesforce environment and InterWeave subscriptions as its business expands and integration requirements become more complex. This approach effectively “future-proofs” the initial investment, significantly reducing the long-term total cost of ownership and mitigating the complexities and disruptions typically associated with large-scale system migrations or re-architectures.
This crucial section outlines the essential preparatory steps and prerequisites that must be addressed before initiating the InterWeave-Salesforce integration. Adhering to these guidelines will ensure a smoother deployment, minimize potential roadblocks, and contribute significantly to the overall success of the project.
- 2.1 Salesforce System Requirements and Best Practices for Integration
While InterWeave emphasizes that its cloud-based integration requires no software installation on users’ machines, it is imperative to ensure that the Salesforce environment itself meets its own system requirements for web browsers and other clients. An optimized Salesforce instance is foundational for any successful integration. Salesforce recommends using the latest stable browser versions (Chrome, Firefox, IE 9-11, Safari 5.x-7.x) and specifies operating system compatibility (Windows 7, 8.1, 10, Mac OS X). For IT administrators utilizing.msi installers, specific prerequisites like Microsoft.NET Framework and Visual Studio Tools for Office Runtime may be necessary. Salesforce also supports various network configurations, including proxy servers, and offers Single Sign-On (SSO) options via delegated authentication or SAML with My Domain. InterWeave Digital further supports SSO via OIDC compliant providers for its care portal.
Adhering to general Salesforce integration best practices is paramount. This includes meticulous project planning, allocating appropriate resources and budget, selecting the most suitable integration types (e.g., App-Based, Data, Security), choosing the right solution (such as AppExchange apps like InterWeave), understanding Salesforce API limits, thoroughly preparing and managing data, and selecting an optimal integration pattern.[16] Specific best practices for enhancing Salesforce performance and integration reliability include implementing batch processing for API calls, employing effective caching strategies, optimizing requests, scheduling data operations during off-peak hours, and utilizing dedicated integration users to manage system interactions. The fact that general Salesforce integration guides highlight the need for understanding API limits, preparing and managing data, and using dedicated integration users, and that common errors include API limit breaches and data mismatches, underscores that the success of the integration is not solely dependent on the InterWeave platform. It is fundamentally tied to the underlying health and configuration of the Salesforce environment. Simply acquiring InterWeave is insufficient; the user must ensure their Salesforce instance is “integration-ready” and optimized according to Salesforce’s own guidelines. Neglecting these foundational elements can lead to critical issues such as API limit breaches, performance degradation, and data integrity problems, even with a sophisticated integration platform like InterWeave. This emphasizes that integration is a comprehensive strategic project, not merely a technical task, requiring attention to both the integration tool and the integrated systems.
- 2.2 Defining Salesforce User Permissions for InterWeave Integration
It is strongly recommended to establish a dedicated integration user within Salesforce for InterWeave’s operations. This practice enhances security and simplifies auditing. This dedicated user account must be granted specific, granular access permissions. These include “View All” and “Read Access” to all Salesforce objects with which integration projects will be associated. Additionally, the user requires “Full access” to any relevant InterWeave custom objects (e.g., RfpioDetails), “API Access” to enable programmatic interaction, and “Access to Responsive Custom Setting Definitions”. To manage these permissions effectively, it is necessary to assign appropriate permission set licenses (such as “Salesforce API Integration”) and create specific permission sets that open up access to all required objects. It is crucial to remember that all other standard Salesforce sharing rules and organizational-wide defaults will continue to apply. InterWeave simplifies the setup by helping users define Salesforce Integration Users. The emphasis on using dedicated integration users and assigning specific, granular permissions like “View All and Read Access,” “Full access,” and “API Access” directly points to the implementation of a security-first approach. Adhering to the “Principle of Least Privilege” for the integration user is a critical security measure. By granting only the minimum necessary permissions, organizations can significantly minimize the attack surface and reduce the risk of unauthorized data access, accidental data modifications, or malicious activities. This not only enhances the overall security posture of the integrated environment but also contributes to system stability by preventing unintended interactions or data corruption that could arise from over-privileged access. This proactive security stance is vital for maintaining data integrity and compliance.
- 2.3 InterWeave Account Registration and Credential Management
The initial step in engaging with InterWeave involves contacting their sales representative to schedule a demo. Following the demo, prospective customers are typically asked to complete an InterWeave survey to facilitate the provision of a detailed quote tailored to their needs. Once the decision to proceed with InterWeave is made, customers will be provided with a sign-on and password to access the dedicated InterWeave help site (help.interweave.biz), which serves as a central resource for documentation and support.
The formal registration and configuration process commences within the InterWeave Solutions Portal (ISP). Here, the user is required to input their company or organization details, the administrator’s email address, and select the specific integration solution they intend to implement (e.g., Salesforce to QuickBooks). Upon successful completion of this step, InterWeave Support personnel will issue an email containing the unique InterWeave company name and a crucial company token. These credentials are indispensable for subsequent setup and configuration steps within the integration process/ Ongoing credential management is also covered, with documentation on how to change Salesforce credentials within the InterWeave Company Profile and guidance on understanding and adhering to Salesforce password policies. The process involves registering with InterWeave and managing credentials for both InterWeave and Salesforce within the InterWeave portal. The mention of “Salesforce Password Policies” and “security token reset” for troubleshooting implies the need for robust credential management. This highlights the critical importance of secure password practices, regular credential rotation, and understanding the impact of Salesforce password policy changes on the integration. Technical administrators should implement a clear process for managing these credentials, potentially leveraging a secure vault or secrets management system, and ensure that the integration user’s credentials are not hardcoded or easily compromised. The ability to change Salesforce credentials within InterWeave’s profile [23] is a key operational feature.
- 2.4 Network and Firewall Considerations for Cloud-Based Integration
InterWeave assures customers that its core cloud-based integration platform does not require any software installation on users’ machines, which inherently minimizes common connectivity issues related to firewalls or VPNs for the cloud component. However, it is critical to understand that for integrations involving on-premise components, such as QuickBooks Desktop, specific network configurations are mandatory. These include establishing Remote Desktop Connection (RDC) access to the QuickBooks server for the Windows admin user, and ensuring that Port 4500 is forwarded and opened for both TCP and UDP communication in both directions. The QuickBooks company file name and location must also be provided. The fact that while InterWeave is broadly described as “cloud-based”, there is a specific, detailed mention of “Remote Desktop Connection (RDC) access to the QB server” and “Port 4500 forwarded/opened” for QuickBooks Desktop integration highlights a crucial nuance: while the core InterWeave platform operates in the cloud, the overall integration solution can be hybrid, especially when connecting with on-premise financial systems. For organizations utilizing such setups, network and firewall configurations are not merely optional but critical prerequisites. The “no software installation on user machines” statement primarily applies to the InterWeave client-side interaction, not necessarily to all components of the integrated ecosystem. Technical administrators must fully grasp this distinction to proactively address potential connectivity issues and ensure that on-premise components are securely accessible and properly configured for seamless cloud integration. Troubleshooting often involves checking network connections, ensuring internet access, good signal strength, correct IP address/subnet, and whitelisting domains. Proxy configurations can also cause issues.
2.5 Object and Field Level Mapping for Salesforce and the Customer Payment Portal
InterWeave’s SmartIntegration Platform allows for configurable integration at the object and field level, enabling seamless data synchronization between Salesforce and connected financial applications, which are integral to the Customer Payment Portal’s functionality. The platform supports integration with standard and custom objects in Salesforce.
Key object correlations include:
- eCommerce Customer seamlessly correlates with a Salesforce Account.
- eCommerce Sales Order corresponds to a Salesforce Opportunity.
- eCommerce Item mirrors a Salesforce Product.
The integration flow from an Order Management System (OMS) Customer to a Salesforce Account involves critical considerations such as binding criteria, primary contacts, parent-child hierarchies, sync operations, and custom mapping. Similarly, OMS Sales Orders to Salesforce Opportunities (or Sales Receipts) offer in-depth configuration options tailored to specific business processes and workflows. For product integration, the focus is on matching products in the eCommerce system to those in Salesforce, considering factors like chart of accounts, class, category, income and expense accounts, and item types (e.g., Inventory, Non-Inventory, Service).
InterWeave simplifies the setup of credentials and helps users define Salesforce Integration Users. The process of data binding involves executing flows like SFAcct2QBCustBind and QBCust2SFActBind to link records between Salesforce Accounts and QuickBooks Customers. After these runs, administrators should monitor logs for “update Customer” lines to confirm successful binding. Reports in both Salesforce (e.g., for Accounts where QB FullName is empty) and QuickBooks (e.g., for Custom Field AccountID is empty) should be run to identify any non-bound items.
- 2.6 Business Process and Workflow Automation
InterWeave SmartSolutions are designed to create integrated solutions tailored to specific business processes and workflows, enhancing real-time information flow and employee collaboration. The platform’s configurable environment allows for selecting integration flows that connect source and target objects using pick lists, drop-downs, and the addition of unlimited custom fields. A key feature is the ability to choose the integration direction at the object level, including unidirectional (one way), unidirectional (the other way), or bi-directional, allowing organizations to implement their business processes as needed.
InterWeave’s eCommerce Solution captures information at user-defined intervals and, based on customer status, creates or updates Salesforce Accounts, Products, and Opportunities. This automation extends to invoicing, where required information is seamlessly imported directly into the application, reducing manual tasks and potential errors. Invoices can be created from the Invoice object in Salesforce to generate single-line or multi-line invoices and can be automatically created in QuickBooks at user-defined intervals. All QuickBooks history, including invoices and payment history, can be made available in Salesforce.
The platform supports comprehensive payment processing functionalities, including one-time payments, recurring payments, credit memos, and refunds. This includes Automated Recurring Billing (ARB) for subscription-based transactions and Custom Recurring Billing (CRB) for flexible payment plans with custom schedules. Advanced features within Salesforce billing, such as payment runs and processing ACH payments and credit cards in batches, streamline billing operations and save time. InterWeave also supports financial management, HR management, inventory management, and order and supply chain management workflows. The configurable options allow organizations to change or select new integration configurations as their business requirements evolve.
- Must-Have Table 1: Essential Salesforce Custom Fields for InterWeave Integration
This table outlines the mandatory and recommended custom fields that need to be created or verified within your Salesforce organization to ensure seamless data synchronization and proper functionality with InterWeave SmartSolutions, particularly for integrations with financial systems like QuickBooks. Proper field configuration is foundational for data binding and flow management. The research explicitly details the requirement to “create custom fields in Salesforce and QuickBooks” and provides a comprehensive list of both mandatory and optional fields for various Salesforce objects (Accounts, Opportunities, Products, Contacts) and corresponding QuickBooks objects (Customer, Vendor, Inventory Item). Consolidating this fragmented information into a single, structured table significantly enhances usability and reduces manual lookup effort for the user. This table serves as a clear, actionable checklist for the Salesforce administrator to prepare their Salesforce org before the integration configuration call, saving time and preventing delays. These custom fields are crucial for the data binding and synchronization processes. Without them, data flow would be incomplete or erroneous. For example, “QB Full Name” and “AccountID” are explicitly mentioned for binding. Fields like “Sales Order Number” or “Invoice Number” indicate how transaction data flows and is tracked within Salesforce, enabling specific business processes. If data is not syncing correctly, checking these fields’ existence, type, and visibility is a primary troubleshooting step, as indicated by the “visible by integration user” note.
Salesforce Object | Field Label (Example) | Salesforce Field Type | Purpose/Notes |
Account | QB Full Name | Text (210) | Mandatory for binding Salesforce Accounts to QuickBooks Customers. |
Curr Bal Pymts | Currency (9,2) | Required if 30/60/90 option is selected. | |
Acc Recv Over30 | Currency (9,2) | Required if 30/60/90 option is selected. | |
Acc Recv Over60 | Currency (9,2) | Required if 30/60/90 option is selected. | |
Acc Recv Over90 | Currency (9,2) | Required if 30/60/90 option is selected. | |
Account Number | Text | Must be accessible by integration user (checked “Visible” in security settings). | |
Description | Text | Must be accessible by integration user. | |
Fax | Text | Must be accessible by integration user. | |
Employees | Number | Must be accessible by integration user. | |
Parent Account | Lookup | Must be accessible by integration user. | |
Phone | Text | Must be accessible by integration user. | |
Rating | Picklist | Must be accessible by integration user. | |
Type | Picklist | Must be accessible by integration user. | |
Website | URL | Must be accessible by integration user. | |
Primary Contact | Lookup Relationship (Contact) | Required if primary contact for an account is determined by contact lookup in account. | |
Contact | Level | Picklist | Required if primary contact for an account is determined by a contact-level custom field (values: Primary, Secondary, Tertiary). |
Opportunity | QuickBooks Transaction Number | Auto-Number | Mandatory if transaction number is generated in Salesforce; must be unique. |
Primary Contact | Lookup (Contact) | Required if primary contact for an account is determined by contact lookup in account. | |
Sales Order Number | Text (11) | Required for integrating Opportunities to Sales Orders; unique. | |
Sales Estimate Number | Text (11) | Required for integrating Opportunities to Sales Estimates; unique. | |
Sales Receipt Number | Text (11) | Required for integrating Opportunities to Sales Receipts; unique. | |
Invoice Number | Text (11) | Required for integrating Opportunities to Invoices; unique. | |
Purchase Order Number | Text (11) | Required for integrating Opportunities to Purchase Orders; unique. | |
Billing Status | Text (20) | Required if using custom billing/shipping address fields. | |
Billing Company Name | Text (210) | Required if using custom billing/shipping address fields. | |
Billing FirstName | Text (210) | Required if using custom billing/shipping address fields. | |
Billing LastName | Text (210) | Required if using custom billing/shipping address fields. | |
Billing Company Street | Text (210) | Required if using custom billing/shipping address fields. | |
Billing City | Text (210) | Required if using custom billing/shipping address fields. | |
Billing State | Text (210) | Required if using custom billing/shipping address fields. | |
Billing Postal Code | Text (210) | Required if using custom billing/shipping address fields. | |
Billing Country | Text (210) | Required if using custom billing/shipping address fields. | |
Billing PhoneNumber | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping Company Name | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping FirstName | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping LastName | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping Company Street | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping City | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping State | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping Postal Code | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping Country | Text (210) | Required if using custom billing/shipping address fields. | |
Shipping PhoneNumber | Text (210) | Required if using custom billing/shipping address fields. | |
Product | ItemCode | Text | Required if binding between Salesforce products and QuickBooks inventory items is based on product code/item SKU. |
QuickBooks Customer Object | AccountID | Text | Mandatory custom field in QuickBooks for binding to Salesforce Accounts. |
QuickBooks Vendor Object | AccountID | Text | Mandatory custom field in QuickBooks for binding to Salesforce Vendors. |
This section guides the user through the active implementation phase, from initial engagement to setting up data flows and payment gateways.
- 3.1 Initiating the Integration: The First Configuration Call and Information Gathering
The onboarding process typically begins with contacting an InterWeave sales representative to schedule an initial demo. Prospective customers are encouraged to “fill out the InterWeave survey” to facilitate the provision of a “detailed quote” tailored to their needs. This initial information gathering helps InterWeave understand the specific integration requirements and scope. Upon formal engagement, customers are granted a sign-on and password to the dedicated InterWeave help site (help.interweave.biz), which serves as a central resource hub for documentation and support throughout the integration journey.
A pivotal step in the setup is the “First Configuration Call,” specifically for setting up the Salesforce/QuickBooks Solution. This call is estimated to take approximately 30 to 45 minutes. During this call, specific information is required, particularly for QuickBooks Online version setup, to ensure a smooth initiation of the integration process. The fact that solutions can be configured, tested, and implemented within “10 to 15 business days,” but this timeline is “dictated by the customer’s level of detail required and their schedule”, indicates that customer preparedness is a key factor in achieving this rapid deployment. For a technical administrator, this means that proactive preparation of all necessary Salesforce configurations, financial system details, and internal business process documentation before engaging with InterWeave can significantly accelerate the implementation timeline. A well-prepared customer can move through the initial phases much more quickly, minimizing delays and achieving faster time-to-value for the integrated solution.
- 3.2 The 8-Step Document: A Collaborative Implementation Roadmap
InterWeave provides an “eight-step document” that outlines the sequential steps for both InterWeave and the customer to collaboratively “create and Implement their solution”. This document serves as a shared roadmap, ensuring both parties understand their responsibilities and the progression of the project. This collaborative framework is designed to facilitate a relatively rapid implementation, typically ranging from “10 to 15 business days”. However, this schedule remains contingent on “the customer’s level of detail required. and their schedule”, emphasizing the importance of active customer participation. The explicit involvement of “both InterWeave. and the customer” in the “eight-step document” frames the implementation as a joint effort, rather than a purely vendor-driven deployment. This highlights that successful integration is a partnership. Technical administrators and their internal teams must be prepared to actively participate, provide timely input, and dedicate resources for testing and feedback throughout the process. This active engagement fosters internal ownership of the solution and is crucial for achieving the desired rapid deployment and long-term operational success, as it ensures the solution is tailored to the organization’s specific workflows.
- 3.3 Configuring Data Flows: Scheduled (Production) and Utility (Test & Bulk Load) Flows
InterWeave’s Integration Manager Portal is the central interface for configuring and managing data synchronization. It distinguishes between two primary types of data flows: “Scheduled (Production) and Utility (Test & Bulk Load) Flows”.
- Scheduled Flows: These are designed for continuous, regular data movement between Salesforce and the integrated financial application. They ensure that data remains consistent and up-to-date across systems. Users have the capability to “force running Scheduled flow immediately” for ad-hoc synchronization needs or specific business requirements outside of the regular schedule.
- Utility Flows: These flows serve specific, often non-routine purposes. They are used for tasks such as “testing your QuickBooks Connection,” executing “single-run utility flows” for specific data operations, and performing “bulk load flows” to efficiently catch up on missing data or for initial large-scale data migrations. Production Flows: As the integration matures and moves into live operation, managing “Production Flows” involves advanced considerations like determining “Time Zone Shift” to ensure accurate timestamps across systems, configuring “Custom BNF Field Mapping” for precise data translation, and troubleshooting issues such as 30/60/90 not updating in SF Accounts.
The clear differentiation between “Scheduled” and “Utility” flows indicates a thoughtful design for managing data across different operational phases. Scheduled flows address ongoing synchronization, while utility flows cater to specific, often one-off, data management tasks like initial migrations or error correction. This modular approach provides technical administrators with fine-grained control over data synchronization processes. It allows for a structured and efficient approach to initial data onboarding (bulk load), continuous real-time updates, and targeted data remediation. This flexibility is crucial for maintaining data consistency and system performance in dynamic business environments without requiring manual intervention for every data operation.
- 3.4 Data Binding and Bulk Loading: Establishing Master Data and Initial Synchronization
A foundational decision, prior to initiating data binding, is to definitively determine “whether the CRM (Salesforce) or the Financial System is Master” for specific data entities.This decision is critical, especially for elements like invoice numbering, as it, “once decided – you can’t change”. The explicit warning that the decision on which system is “Master” for data (especially invoice numbering) “once decided – you can’t change” elevates this technical configuration to a critical data governance decision. This is not merely a technical setting but a fundamental business policy that impacts data integrity and reporting across the enterprise. Technical administrators must engage deeply with business stakeholders (e.g., finance, sales) early in the planning phase to define clear data ownership rules for each integrated entity. A well-defined master data strategy is paramount to prevent data conflicts, ensure accuracy, and streamline reporting. Rushing this decision or making it without full business alignment can lead to significant, costly, and difficult-to-rectify data integrity issues in the long term.
The process involves executing specific binding flows, such as SFAcct2QBCustBind and QBCust2SFActBind, which are designed to link corresponding records between Salesforce and QuickBooks. Technical administrators should monitor the logs after these runs, specifically looking for “update Customer …” lines to confirm successful binding and data synchronization. Post-binding, it is essential to run reports in both Salesforce (e.g., for Accounts where QB Full Name is empty) and QuickBooks (e.g., for Custom Field AccountID is empty) to identify any “non-bound items” that require manual intervention or further troubleshooting. For initial large-scale data transfers or to rectify missing data, “bulk load utility transaction flows” are employed, enabling efficient and comprehensive data catch-up.
- 3.5 Setting Up the InterWeave Payment Gateway: Connecting Merchant Service Providers
The InterWeave Payment Gateway functions as a configurable integration layer, facilitating the collection of payments from consumer bank or credit card accounts and enabling secure data transfer between Salesforce (or other websites) and various Merchant Service Providers. InterWeave boasts extensive compatibility, integrating with “over 48 Merchant Service Providers”. This includes widely recognized providers such as Authorize.net, Transfirst, Chase Paymenttech, First Data, PayPal, Vanco, iCash, Payment XP, Banktec, Teledraft, and Cybersource. The repeated emphasis on integrating with “over 48 Merchant Service Providers”. and the extensive list of examples is a strong indicator of InterWeave’s strategic positioning within the payment’s ecosystem. This broad compatibility offers significant flexibility to businesses, allowing them to either retain their existing preferred payment processor or choose from a wide array of options without being locked into a specific vendor. For technical administrators, this translates to simplified integration of current
Training Course Daily Flow Management Document for
Salesforce Payment Gateway with InterWeave SmartSolutions
This document serves as a practical and actionable training guide for the daily operational management of payment processes integrated within the Salesforce, InterWeave SmartSolutions, and Payment Gateway ecosystem. It is specifically designed to bridge the gap identified in existing resources, providing targeted training topics for users and administrators on managing daily payment flows, effectively utilizing the InterWeave Customer Portal, and systematically troubleshooting common operational issues.
At its core, this integrated setup leverages Salesforce as the central hub for managing customer relationships, sales orders, and invoices. InterWeave SmartSolutions acts as the intelligent bridge, automating data synchronization and orchestrating complex payment workflows between Salesforce and various payment gateways. The payment gateways themselves are the facilitators of the actual financial transactions, securely processing credit card and direct payments.
The interconnected nature of these systems means that a disruption or misconfiguration in one component can have immediate and far-reaching effects across the entire payment lifecycle. The guide emphasizes “real-time & bi-directional sync” and “automated workflows” , which certainly leads to enhanced efficiency and reduced manual effort. However, this tight coupling also introduces increased interdependency. For instance, if InterWeave experiences a synchronization failure, Salesforce records could quickly become outdated, directly impacting financial reporting and any subsequent automated actions. Similarly, an outage at the payment gateway would halt all new transactions, irrespective of the operational status of Salesforce or InterWeave. Therefore, effective daily management extends beyond merely performing individual component tasks; it demands a comprehensive understanding of the entire payment flow, identifying potential choke points or failure modes across the entire chain. This necessity for proactive monitoring and a holistic troubleshooting approach will be a consistent theme throughout this training.
A clear understanding of each component’s role and its daily interaction within the integrated payment ecosystem is fundamental for efficient operation and effective problem resolution.
Salesforce: Your Daily CRM and Business Process Hub
Salesforce functions as the primary CRM and business process automation platform, managing critical entities such as accounts, contacts, sales orders, and invoices, which form the bedrock for payment collection. It includes a dedicated “Payments” section for tracking transaction records, and its robust business process designer allows for the automation of various sales and service workflows, which can be extended to include payment-related triggers and actions once integrated.
In daily operations, users will primarily interact with Salesforce for tasks such as creating and managing invoices, viewing the real-time status of payments, and triggering payment-related workflows. Salesforce’s comprehensive set of APIs (OData, DataService, custom web services, REST API, ProcessEngineService) enables seamless data exchange with external applications like InterWeave, making it highly extensible for integrations.
InterWeave SmartSolutions: The Integration Bridge in Action
InterWeave SmartSolutions serves as the crucial Integration Platform as a Service (iPaaS), acting as the bridge between Salesforce and numerous payment gateways. It ensures real-time and bi-directional synchronization of payment information, transaction statuses, and related customer data between Salesforce and the chosen payment gateway. Key features vital for daily operations include Automated Recurring Billing (ARB), which facilitates automated, scheduled, and recurring payment processing for subscription-based businesses, and the Customer Self-Service Portal, enabling customers to manage invoices, update payment methods, and make payments independently.
While much of InterWeave’s functionality operates automatically in the background, administrators will actively utilize the InterWeave Integration Manager (IM) dashboard for critical tasks such as monitoring data flows, handling errors, and reprocessing failed transactions. This dashboard provides real-time alerts and detailed transaction logs, making it an indispensable tool for maintaining operational stability.
Payment Gateways: Facilitating Daily Transactions
Payment gateways are specialized services that authorize credit card or direct payment processing for online businesses. They securely transmit transaction information from the customer to the acquiring bank and back to the merchant. Their core functions include authorization and capture of funds, comprehensive transaction management (including IDs and statuses), and the ability to process refunds and voids. Payment gateways also incorporate essential security features such as fraud detection, tokenization (replacing sensitive card data with unique identifiers), and adherence to industry standards like PCI DSS. They often provide webhooks or Instant Payment Notifications (IPNs) for real-time updates to integrated systems like InterWeave regarding transaction status changes.
From an end-user perspective, direct interaction with the payment gateway is minimal; their payment experience is abstracted through Salesforce or the InterWeave Customer Portal. However, administrators may need to consult the payment gateway’s documentation for specific error codes or API details during advanced troubleshooting scenarios.
The abstraction provided by InterWeave, while simplifying daily operations for end-users, places a higher responsibility on administrators to comprehend the underlying technical flows for effective troubleshooting. When an issue arises, such as a payment failure, the end-user in Salesforce will observe a “failed” status but will not have immediate access to the root cause. It then becomes the administrator’s role to delve into InterWeave’s Integration Manager and potentially the payment gateway’s logs to diagnose the underlying problem. This requires a deeper technical understanding of how data flows
between the systems, not just within a single platform. Consequently, effective daily management necessitates a tiered support model where end-users report issues, and administrators possess the cross-platform knowledge to investigate and resolve them, leveraging the comprehensive monitoring tools provided by InterWeave.
This section details the common, automated business processes that users and administrators will encounter and manage on a daily basis within the integrated Salesforce-InterWeave-Payment Gateway ecosystem. These processes streamline financial operations and enhance customer experience.
3.1. Online Payment Processing
Scenario: A customer receives an invoice generated from Salesforce, typically via email or through the Customer Portal, and proceeds to make an online payment.
Process Flow:
- Salesforce generates an invoice or order, serving as the financial record.
- InterWeave creates a secure payment link or directs the customer to a hosted portal, ensuring secure data handling outside Salesforce’s direct storage.
- The customer submits payment securely via the chosen payment gateway.
- The Payment Gateway processes the transaction and sends the status back to InterWeave in real-time.
- InterWeave then updates the corresponding Invoice, Order, or Payment record in Salesforce to reflect the status as “Paid” or “Partially Paid” in real-time.
- Upon receiving the status update, Salesforce can automatically trigger subsequent workflows, such as sending a payment confirmation email to the customer, updating the sales pipeline, or notifying the finance department.
Daily Management Tasks:
- Receiving and Tracking Payments in Salesforce: Users should regularly monitor the “Payments” section within Salesforce to observe incoming transactions and their updated statuses. This ensures visibility into the revenue stream.
- Generating Secure Payment Links via InterWeave: Understand the process for generating or accessing these secure payment links for customers, which are often initiated directly from within Salesforce.
- Monitoring Transaction Status Updates: Verify that Salesforce records are updated promptly and accurately, checking for “Paid,” “Partially Paid,” or “Failed” statuses to ensure data integrity.
3.2. Managing Recurring Billing & Subscriptions
Scenario: A customer signs up for a subscription service, with the subscription details managed within Salesforce.
Process Flow:
- Salesforce records the comprehensive subscription details, including the chosen plan, billing frequency, and customer information.
- InterWeave initiates the recurring billing profile with the payment gateway, securely utilizing tokenized card data to avoid storing sensitive information in Salesforce.
- The payment gateway automatically charges the customer on the scheduled recurring basis.
- InterWeave receives the transaction status for each recurring charge and updates Salesforce accordingly, for example, by creating new payment records or updating the subscription status.
- InterWeave’s Automated Recurring Billing (ARB) engine is designed to handle retry logic for failed payments and manage dunning notifications, automating the follow-up process for overdue payments.
Daily Management Tasks:
- Setting Up and Monitoring Subscription Profiles in Salesforce: Ensure that all subscription details are accurately captured in Salesforce and correctly linked to the InterWeave recurring billing profiles.
- InterWeave’s Role in Automated Charges and Dunning: Develop an understanding that InterWeave is responsible for the automated charging process and the subsequent follow-up for failed payments through its dunning capabilities.
- Handling Failed Recurring Payments: Proactively identify failed recurring payments in Salesforce (as updated by InterWeave) and initiate manual dunning processes or follow-ups as dictated by company policy.
3.3. Processing Refunds and Cancellations
Scenario: A customer requests a refund for a purchase, or an order is cancelled, necessitating a reversal of payment.
Process Flow:
- A user initiates a refund or void request directly within Salesforce or through a linked financial system.
- InterWeave securely passes this refund or void request to the payment gateway.
- The payment gateway processes the refund or void transaction.
- InterWeave updates the corresponding Salesforce record with the refund status and detailed information, ensuring that Salesforce reflects the accurate financial state.
Daily Management Tasks:
- Initiating Refunds/Voids in Salesforce: Learn and follow the specific Salesforce workflow designed to trigger a refund or void transaction.
- Tracking Refund Status via InterWeave: Confirm that the refund status is accurately and promptly reflected in Salesforce, as updated by InterWeave, to ensure financial reconciliation.
3.4. Real-time Financial Reporting & Analytics
Scenario: Sales and finance teams require immediate, up-to-the-minute insights into revenue generation and payment success rates to inform strategic decisions.
Process Flow: InterWeave continuously feeds comprehensive payment data, including Monthly Recurring Revenue (MRR), Churn, Lifetime Value (LTV), Payment Success Rates, and Decline Analytics, back into Salesforce. This continuous data flow enables real-time dashboard updates and robust analytics directly within the CRM environment.
Daily Management Tasks:
- Accessing Payment Data in Salesforce Dashboards: Regularly review Salesforce dashboards that display financial metrics to gain up-to-date operational insights.
- Key Metrics for Daily Monitoring: Understand the significance of metrics such as MRR, Churn, LTV, Payment Success Rates, and Decline Analytics, and how to interpret them for actionable operational insights.
3.5. Utilizing the InterWeave Customer Self-Service Portal
Scenario: Customers desire the ability to manage their own billing information and payment history independently, reducing the administrative burden on internal teams.
Process Flow: The InterWeave Customer Portal, seamlessly integrated with Salesforce data, provides a secure environment where customers can: view and download invoices; update their billing or credit card information; make one-time or recurring payments; and receive automated email notifications and reminders for due payments.
Daily Management Tasks:
- Guiding Customers on Portal Usage: Be prepared to instruct customers on how to access and effectively use the InterWeave Customer Portal for their billing and payment needs.
- Managing Customer Billing Information and Payment History: Understand how customer actions performed within the portal are reflected in Salesforce, and how to efficiently assist customers with any portal-related queries or issues.
The automation embedded within these processes fundamentally shifts the daily operational focus from manual data entry to proactive monitoring and exception handling. All processes are described with explicit “Automation” steps , which significantly reduces manual workload and minimizes the potential for human error. Consequently, the primary daily task for users and administrators is no longer to
perform the individual transaction steps, but rather to verify that the automation is functioning as expected and to intervene only when exceptions, such as failed payments or data discrepancies, occur. This demands a shift from routine transactional processing to a focus on monitoring and problem-solving. This highlights the critical need for robust monitoring tools, such as the InterWeave Integration Manager , and clear troubleshooting protocols to manage operations by exception, thereby ensuring operational efficiency and minimizing potential revenue loss from unaddressed issues.
Table 1: Daily Operational Checklist
This checklist provides a structured approach to ensure all critical daily tasks related to payment flow management are consistently addressed, promoting efficiency and accuracy.
Task | Frequency | Responsible Role | Salesforce/InterWeave Path | Notes/Tips |
Review Salesforce Payment Section for new transactions | Daily | Payment Operations User | Salesforce > Payments | Prioritize transactions with “Pending” or “Failed” status. |
Check InterWeave IM Dashboard for errors | Daily | System Administrator | InterWeave IM > Dashboard | Look for red flags, error messages, and failed sync attempts. |
Follow up on failed recurring payments | Daily | Payment Operations User | Salesforce > Subscriptions/Payments (filter by failed) | Initiate dunning processes or customer outreach as per policy. |
Process pending refunds | Daily | Payment Operations User | Salesforce > Payments (filter by refund requests) | Ensure all necessary approvals are in place before processing. |
Review daily financial dashboards | Daily | Finance Analyst / Sales Lead | Salesforce > Dashboards (e.g., Sales, Finance) | Monitor MRR, Payment Success Rates, and Decline Analytics. |
Verify API credentials (InterWeave to Gateway) | Weekly | System Administrator | InterWeave IM > Connectors/Gateway Settings | Ensure keys are valid and not expired. |
Check Salesforce integration user permissions | Weekly | System Administrator | Salesforce > Setup > Users and Roles | Confirm “least privilege” is maintained for the dedicated user. |
Reconcile payments with accounting system | Weekly | Finance Analyst | Salesforce, Payment Gateway Reports, Accounting Software | Address any discrepancies promptly to ensure financial accuracy. |
Ensuring the integrity and accuracy of payment data is paramount for reliable reporting, seamless operations, and maintaining customer trust. This section outlines critical data management best practices.
Ensuring Data Consistency (Accounts, Contacts, Invoices)
Accurate and up-to-date customer records, including accounts and contacts, within Salesforce are fundamental. This information is directly utilized to create and update payment profiles in the payment gateway. Inconsistent or outdated data can lead to payment failures, incorrect billing, or customer dissatisfaction. Daily practice should involve a routine review and maintenance of customer and invoice data in Salesforce, ensuring all required fields for payment processing, such as billing address and email, are complete and accurate.
Leveraging Unique Identifiers for Transaction Tracking
The consistent use of unique identifiers, such as Salesforce Order or Invoice IDs, is essential for effectively linking transactions across Salesforce, InterWeave, and the payment gateway. This practice significantly facilitates seamless reconciliation and streamlines troubleshooting efforts. When investigating any transaction, the recommended daily practice is to always begin with the Salesforce Order or Invoice ID and use it as the primary reference to trace the transaction’s journey through InterWeave’s detailed logs and, if necessary, the payment gateway’s records.
4.1. Error Handling and Monitoring Procedures
Proactive error handling and continuous monitoring are critical for maintaining operational stability and minimizing revenue loss.
- Using the InterWeave Integration Manager (IM) Dashboard: The IM dashboard serves as the primary tool for real-time monitoring of integration activities. It provides immediate alerts, detailed transaction logs, and specific error messages. Administrators should incorporate regular checks of the IM dashboard into their daily routine, specifically looking for any red flags, failed transactions, or unusual activity that might indicate underlying issues.
- Configuring and Responding to Automated Alerts: InterWeave allows for the configuration of automated email alerts that notify relevant personnel, such as finance or support teams, about failed transactions or integration issues. Daily practice involves ensuring these alerts are correctly configured to reach the appropriate individuals and responding promptly to any notifications by investigating the root cause of the failure.
- Reprocessing Failed Transactions: InterWeave’s reprocessing capability is a powerful feature that allows administrators to correct underlying issues that caused a transaction failure and then re-attempt the payment without requiring manual re-entry. For failed transactions identified via Salesforce or IM alerts, the daily practice is to diagnose the issue (e.g., invalid card details, network glitch), rectify it, and then utilize InterWeave’s reprocessing feature to complete the transaction.
4.2. Daily/Weekly Reconciliation Process
Establishing a consistent process for daily or weekly reconciliation of payments across Salesforce, your payment gateway, and your accounting system is crucial. This ensures that all transactions are accurately accounted for and prevents financial discrepancies, significantly aiding auditing processes. Daily practice should involve implementing a routine to compare payment records in Salesforce with settlement reports from the payment gateway and corresponding entries in your accounting software, addressing any discrepancies immediately.
Proactive data management and robust error handling extend beyond merely fixing problems; they are about preserving the integrity of financial reporting and ensuring business continuity. The guide highlights “Data Consistency,” “Unique Identifiers,” and comprehensive “Error Handling and Monitoring” , alongside “Real-time Financial Reporting” as an automated process. If data consistency is neglected or errors are not promptly handled, the reliability of “real-time financial reporting” diminishes, which can undermine strategic decision-making based on metrics like MRR and churn. Furthermore, unaddressed errors can lead to lost revenue from failed payments or significant customer dissatisfaction due to incorrect billing. Therefore, daily data management and error handling are critical operational controls that directly influence financial health and customer trust, elevating them from purely technical tasks to strategic business functions. This underscores the necessity for clear ownership and accountability for these daily processes.
Table 3: Key Data Fields for Daily Monitoring
This table identifies the most critical data fields to monitor daily, their purpose, and where to find them, streamlining operational oversight and troubleshooting.
Field Name | Source System | Purpose for Daily Operations | Monitoring Location |
Payment Status | Salesforce / InterWeave | Track transaction success (Paid, Failed, Pending, Refunded) | Salesforce Payments section, Salesforce Dashboards |
Payment Gateway Transaction ID | InterWeave / Gateway | Link records across systems for reconciliation & tracing | Salesforce Payment object, InterWeave IM Logs |
Last 4 Digits of Card | Salesforce / InterWeave | Identify payment method for customer service (no full card #) | Salesforce Payment object |
Authorization Code | InterWeave / Gateway | Verify successful authorization | Salesforce Payment object, InterWeave IM Logs |
Error Code/Message | InterWeave / Gateway | Diagnose reasons for payment failures | InterWeave IM Logs, Salesforce Payment object |
Refund ID | Salesforce / InterWeave | Track refund transactions | Salesforce Payment object, InterWeave IM Logs |
Is Recurring Payment | Salesforce / InterWeave | Identify subscription-related payments | Salesforce Subscription/Payment object |
Subscription ID | Salesforce / InterWeave | Link payments to specific subscription profiles | Salesforce Subscription/Payment object |
Amount Due/Paid | Salesforce / InterWeave | Verify correct payment amounts and outstanding balances | Salesforce Invoice/Order/Payment object |
Handling payment data necessitates strict adherence to security and compliance standards, most notably PCI DSS. These are not one-time setup tasks but continuous operational responsibilities.
Maintaining PCI DSS Compliance
InterWeave Smart Solutions is PCI-DSS compliant, which means it securely handles the transmission and temporary storage (tokenization) of sensitive cardholder data. This significantly reduces the PCI DSS scope for your Salesforce environment, as Salesforce itself does not directly store raw card data.
A critical and absolute rule is to never store raw credit card numbers, CVVs, or full expiration dates directly in Salesforce. Instead, the integration utilizes tokenization provided by the payment gateway, where a unique, non-sensitive token replaces the actual card data. This token is then securely stored in Salesforce and passed to InterWeave for future transactions. Similarly, the InterWeave Customer Portal is designed to handle card input and storage securely within its own PCI-compliant environment. Daily practice must strictly adhere to this “no direct card storage” rule, and all users must be educated on this policy.
Authentication and Authorization Best Practices for Daily Users
Robust authentication and authorization practices are fundamental to security. This includes using strong, unique credentials for all users involved in the integration. It is also essential to implement OAuth 2.0 for secure API authentication where possible. Furthermore, the principle of least privilege must be rigorously adhered to, granting only the necessary permissions to integration users. Daily practice involves regularly reviewing user permissions in Salesforce, particularly for the dedicated integration user , to ensure they align with the least privilege principle. Implementing multi-factor authentication (MFA) where available further enhances security.
Ensuring Data Encryption (TLS/SSL)
All data in transit between Salesforce, InterWeave, and the payment gateway must be encrypted using TLS/SSL to protect sensitive information during transmission. Additionally, InterWeave encrypts data at rest, providing another layer of security for stored data. Daily practice includes verifying that any public-facing Salesforce portals or custom payment pages have proper and current SSL/TLS certificates installed to ensure secure communication.
Leveraging Audit Trails for Daily Monitoring and Troubleshooting
Maintaining detailed logs of all payment transactions and integration activities is essential for auditing purposes and effective troubleshooting. InterWeave’s Integration Manager (IM) provides comprehensive logging capabilities for these activities. Daily practice should involve regularly reviewing audit trails in both Salesforce and the InterWeave IM to track payment activities, identify any unauthorized actions, or pinpoint the precise source of errors.
Additional Security Practices for Daily Operations
If webhooks are utilized for real-time notifications, it is crucial to ensure they are secured through methods such as signed requests or IP whitelisting to prevent unauthorized notifications. Furthermore, understanding and implementing idempotency keys for transaction requests sent to the payment gateway is important. This feature helps prevent duplicate charges in cases of network issues or retries, a capability supported by most modern payment gateways.
Security and compliance are not one-time setup tasks but continuous operational responsibilities, where daily vigilance directly mitigates significant financial and reputational risks. The guide dedicates a full section to “Security and Compliance Best Practices” and frequently mentions PCI DSS compliance , along with technical measures like tokenization, encryption, and audit trails. While these are critical technical requirements for the integration, the
daily operational aspect lies in maintaining these standards. A single lapse, such as storing raw card data, using weak credentials, or failing to monitor audit logs, can compromise the entire compliant environment, potentially leading to data breaches, regulatory fines, and a severe loss of customer trust. The “least privilege” principle is not just an initial setup step but a continuous daily audit consideration. Therefore, daily security practices are not merely a technical checklist but a critical component of risk management. Organizations must cultivate a culture of security awareness among all users and administrators, recognizing that human error is often the weakest link, even within a technically secure system.
This section provides practical guidance for diagnosing and resolving issues that may arise during daily payment flow management. Effective troubleshooting requires a systematic, multi-layered approach that understands the flow of data and responsibility across the integrated systems, moving beyond isolated error messages.
Table 2: Common Error Codes and Troubleshooting Steps
This table provides a quick reference for common error codes encountered during daily operations, along with their likely causes and initial troubleshooting steps.
Common Error Code/Message (from Gateway/InterWeave) | Likely Cause | Initial Troubleshooting Steps (Salesforce/InterWeave) | Escalation Point (if needed) |
“Transaction Declined” | Bank rejection (insufficient funds, fraud flag) | Check Salesforce payment status for specific decline code. Advise customer to contact their bank or try another payment method. | Customer’s Bank, Payment Gateway Support |
“Invalid API Key” / “Authentication Failed” | Incorrect InterWeave configuration | Review InterWeave IM logs for authentication errors. Verify API credentials (keys, secrets) in InterWeave’s gateway settings against gateway docs. | InterWeave Support |
“Duplicate Transaction” | Idempotency issue / Retry logic | Check Salesforce for existing payment records with the same Order/Invoice ID. Review InterWeave IM logs for repeated attempts. | InterWeave Support, Payment Gateway Support |
“Card Expired” / “Invalid Card Details” | Customer card issue | Advise customer to update their payment method via the InterWeave Customer Portal or directly with support. | Customer, InterWeave Customer Portal Support |
“Gateway Timeout” / “Connection Error” | Network issue / Gateway outage | Check InterWeave IM for connectivity errors. Verify network access from InterWeave to gateway. Check payment gateway status page. | InterWeave Support, Payment Gateway Support |
“Data Mapping Error” | Incorrect field mapping in InterWeave | Review InterWeave IM logs for data transformation errors. Re-verify field mappings between Salesforce and gateway in InterWeave configuration. | InterWeave Support |
Export to Sheets
Identifying Payment Failures (Error Codes and Messages)
When a payment fails to process successfully in Salesforce, the initial step is to check the “Payment Status” field and any associated “Error Codes/Messages” that InterWeave has updated in the Salesforce record. For more detailed information, administrators should navigate to the InterWeave Integration Manager (IM) dashboard and review the detailed transaction logs. These logs often provide more granular error messages directly from the payment gateway. For cryptic or unfamiliar error codes, it is essential to consult the specific payment gateway’s developer documentation for a full explanation and suggested remedies.
Resolving Data Synchronization Discrepancies
Data synchronization discrepancies might manifest as payments marked “Paid” in the payment gateway but not accurately reflected in Salesforce, or as missing customer or invoice data. To diagnose these issues, administrators should examine InterWeave’s data flow logs for any mapping errors or failed synchronization attempts. It is also crucial to verify that Salesforce’s custom payment fields are correctly configured and mapped to the corresponding fields in InterWeave. Once the underlying data issue is identified and corrected (e.g., updating an incomplete Salesforce record), InterWeave’s reprocessing feature can be utilized to re-attempt the synchronization.
Addressing Recurring Billing Issues
Issues with recurring billing can include failed recurring charges, dunning notifications not being sent, or subscription statuses not updating correctly in Salesforce. To diagnose, review the recurring billing profiles within InterWeave and check the payment gateway for the status of the specific recurring charge. Verify if InterWeave’s Automated Recurring Billing (ARB) engine retry logic is functioning as expected. Resolution steps might involve manually triggering a retry if the issue was temporary, or guiding the customer to update their payment method information via the Customer Portal if, for example, their card has expired.
Common InterWeave IM Alerts and Their Resolutions
Administrators should familiarize themselves with the different types of alerts generated by InterWeave, such as API connection issues, data transformation errors, or payment gateway rejections. For each common alert type, a systematic approach to investigation is required. This may involve checking API credentials, verifying network access between InterWeave and other systems, or reviewing data mapping configurations within InterWeave.
When to Engage Support (Salesforce, InterWeave, Payment Gateway)
Complex issues often necessitate collaborative troubleshooting involving all three parties. It is important to define clear criteria for when to escalate to each support channel:
- Salesforce Support: Engage for issues related to core Salesforce functionality, such as Salesforce workflow problems, platform bugs, or unexpected behavior within Salesforce’s UI.
- InterWeave Support: Contact for integration platform errors, data mapping issues, problems with the ARB engine, or general InterWeave platform malfunctions.
- Payment Gateway Support: Reach out for specific transaction declines, suspected gateway outages, or problems related to API credentials provided by the gateway.
Effective troubleshooting requires a systematic, multi-layered approach that comprehends the flow of data and responsibility across the integrated systems, moving beyond isolated error messages. Troubleshooting involves checking Salesforce, the InterWeave Integration Manager, and payment gateway documentation. This indicates that no single system provides a complete picture for complex issues. For instance, a payment failure could originate from incorrect data in Salesforce, a mapping error within InterWeave, a network issue preventing InterWeave from reaching the gateway, or a specific decline reason from the payment gateway itself. A proficient troubleshooter must be capable of systematically tracing the error’s origin across these various layers, rather than simply reacting to the first error message encountered. This necessitates a “full-stack” understanding for administrators, requiring them to move beyond their primary domain (e.g., solely Salesforce administration) to grasp the interdependencies of the entire ecosystem. This also underscores the importance of clear communication and shared knowledge between different support teams, fostering a collaborative problem-solving environment.
Beyond daily operational tasks, periodic administrative checks and maintenance are crucial for ensuring the long-term stability, security, and optimal performance of the integrated payment system. These proactive measures often prevent daily operational issues from arising.
Monitoring Salesforce Permissions for Integration User
The dedicated Salesforce integration user must be configured with precisely the “necessary read and write permissions” on all relevant objects, including Contacts, Accounts, Orders, Invoices, Payments, and any custom objects involved in the payment process. Incorrect permissions can lead to data synchronization failures, operational disruptions, or even security vulnerabilities. A critical administrative task is to periodically review the permissions granted to this dedicated integration user in Salesforce. This ensures that no unnecessary permissions have been inadvertently granted and that all required permissions remain intact.
Verifying API Credentials and Webhook Configurations
API keys, secret keys, and transaction keys obtained from the payment gateway are “crucial for InterWeave to authenticate and interact with the gateway”. Similarly, correctly configured webhooks are essential for ensuring “real-time updates” from the payment gateway to InterWeave. Administrative tasks should include regularly confirming that the API credentials stored within InterWeave are current and valid. Additionally, periodic checks of webhook configurations on the payment gateway side are necessary to ensure they are correctly pointing to InterWeave’s provided URL and remain active.
Managing Custom Payment Fields in Salesforce
Custom fields are often created in Salesforce to capture specific payment-related data, such as the Payment Gateway Transaction ID, Payment Status, Card Type, Last 4 Digits of Card, Authorization Code, and Refund ID. These fields are vital for accurate data mapping, reporting, and troubleshooting. A routine administrative task involves periodically reviewing these custom payment fields in Salesforce to ensure they align with current business needs and that their data types and properties are appropriate. It is crucial to re-emphasize the absolute rule:
never create fields to store full credit card numbers directly in Salesforce.
Regular System Health Checks
Ensuring continuous network access is fundamental: Salesforce must be able to communicate with InterWeave’s servers, and InterWeave must be able to access the payment gateway’s APIs, typically over HTTPS/443. Furthermore, for any public-facing Salesforce portals or custom payment pages, it is essential to ensure that SSL/TLS certificates are current and valid. Administrators should implement a routine for network connectivity tests and proactive monitoring of SSL/TLS certificate expiry dates, addressing any upcoming expirations well in advance.
Proactive administrative oversight of the integration’s foundational configurations is paramount for preventing systemic failures and ensuring continuous, secure operation. The onboarding guide details prerequisites and setup steps like Salesforce permissions, API credentials, and custom fields. These are not “set-it-and-forget-it” items. Permissions can be accidentally altered, API keys can expire or be revoked, webhooks can become misconfigured, and certificates inevitably expire. If these foundational elements are not routinely checked, they will inevitably lead to operational failures that initially appear as “daily issues” but have deeper, administrative roots. This highlights a shift from initial “onboarding” to continuous “operational governance.” A robust daily flow management strategy
must include a schedule for these administrative checks, effectively transitioning from a reactive troubleshooting posture to a proactive maintenance one, thereby minimizing downtime and ensuring the long-term reliability and security of the payment ecosystem.
Effective daily flow management for the Salesforce Payment Gateway with InterWeave SmartSolutions integration is crucial for maintaining efficient financial operations, ensuring data integrity, and providing an optimal customer experience. This training document has emphasized the importance of understanding the integrated ecosystem, mastering daily operational flows, adhering to stringent data management and security best practices, and employing effective, multi-layered troubleshooting techniques.
The payment landscape is dynamic, and continuous learning and adaptation are crucial for sustained success. This training document provides a comprehensive foundation for daily operations, but it is a living resource that complements, rather than replaces, the official documentation and direct support channels.
For further support and in-depth documentation, the following resources are invaluable:
- Salesforce Academy: Provides extensive documentation, e-learning courses, and guides on general Salesforce functionalities, including API usage and business process design.
- InterWeave Academy & Support: Offers e-learning resources, training videos, and self-service portals to guide users through their platform. Their “SMART+ Support” plans typically include email and phone support, and potentially dedicated support managers for enterprise clients.
- Payment Gateway Documentation: Your chosen payment gateway (e.g., Stripe, Authorize.Net, PayPal) will have comprehensive developer documentation, API references, and support channels for detailed transaction management and error handling specific to their platform.
For complex issues that span across components, collaborative troubleshooting is often the most effective approach. Engaging Salesforce administrators or developers, InterWeave support, and your payment gateway’s support team can expedite resolution. This integrated approach ensures that operational teams are well-equipped for both routine tasks and unexpected challenges. Effective long-term management of the integrated system relies on a holistic knowledge ecosystem: this training document for daily operations, official vendor documentation for deep technical reference and new features, and direct support channels for complex, unresolved issues. This multi-pronged strategy ensures ongoing operational excellence.
By following this structured onboarding process, InterWeave SmartSolutions ensures a tailored integration that aligns with your organization’s specific business processes and workflows, facilitating efficient and accurate data synchronization between your CRM and financial, payment, ERP and all applications.