Chapter 3: Membership Setup — 3.4 Membership Integration Settings
Use Membership Integration Settings to connect your EQuip loyalty system with external CRM or marketing platforms. This allows member data, point balances, and transaction history to sync with your other business tools.
When to use this: When you want to connect your loyalty system with an external CRM or marketing platform.

This is a single-page settings screen (not a list). It lets you select an integration type and enter the connection details. The integration keeps member data synced in real-time between EQuip and your external loyalty provider.
Currently supported integration type: CRM (e.g., ProSeller or compatible loyalty providers).
| Field | Type | Description |
|---|---|---|
| Membership Integration Type | Dropdown | Select None (local only) or CRM (external provider) |
When None is selected, all membership data is managed entirely within EQuip — no external sync occurs.
When CRM is selected, additional configuration fields appear:

| Field | Type | Description |
|---|---|---|
| Company URL | Text | Your company's URL in the CRM portal |
| Company ID | Text | Your unique company identifier assigned by the CRM provider |
| Base URL | Text | REST API base URL for the CRM (e.g., https://api.proseller.com) |
| WSS Base URL | Text | Real-time connection address provided by your CRM provider (e.g., wss://ws.proseller.com) |
| API Token | Text | Security key for connecting to the CRM — provided by your CRM provider |
| Voucher Payment Type | Dropdown | How voucher redemptions are posted as a payment type at POS |
| SVC Payment Type | Dropdown | How stored value card payments are posted at POS |
| Reference By | Text | Field used to look up members in the CRM (e.g., "Mobile", "MembershipNo") |
| API Security Protocol | Text | Security setting — leave as default unless instructed by your IT team |
| Point Rounding Mode | Text | How fractional points are handled (e.g., "INT" = round to nearest integer) |
| Merchant Portal URL | Text | Link to the CRM provider's merchant admin portal |
| Toggle | When ON | When OFF |
|---|---|---|
| Use SVC | Stored Value Card balances are kept in sync between EQuip and the CRM provider | SVC is managed in EQuip only — balances are not shared with the CRM |
| Allow Manual Membership Search | Cashiers can manually search and attach members at POS via keyboard entry | Member identification is scan-only (barcode, NFC) — no manual search |
| Enabled Paid Membership | Paid membership plan purchase is available at POS | No paid membership plans presented at checkout |
The Enabled button (green) at the bottom right activates or deactivates the entire integration.
| State | Effect |
|---|---|
| Enabled (green) | All member transactions sync to the CRM in real-time via WebSocket |
| Disabled (grey) | EQuip runs in local-only mode — no CRM sync |
These AppSettings control the CRM integration at the POS terminal level:
| Setting | Purpose | Default |
|---|---|---|
UseCRMIntegration | Master switch for CRM integration at POS | false |
UsePaidMembership | Enable paid membership plan options | false |
[!IMPORTANT] The Integration Settings page controls the backend/web portal configuration. For the POS terminal to use CRM integration, the
UseCRMIntegrationsetting must also be enabled in POS terminal settings. Both must be active for end-to-end sync to function.
When CRM integration is active, here's what happens for each member transaction:
Member scanned at POS
→ POS sends lookup to CRM via WSS
→ CRM returns member profile + points + SVC balance
→ Transaction completed at POS
→ POS sends sale event to CRM
→ CRM updates member points, tier status, SVC balance
→ Member's app/portal reflects updated dataScenario: A multi-outlet retail chain uses ProSeller as their CRM and wants real-time member sync.
Configuration:
2. Enter Company ID and API Token from ProSeller dashboard
3. Set Base URL: https://api.proseller.com
4. Set WSS Base URL: wss://ws.proseller.com
5. Enable Use SVC → ON (sync stored value balances)
6. Set Reference By: Mobile (member lookup by phone number)
7. Set Point Rounding Mode: INT
8. Click Enabled to activate

Result: When a member taps their card at any outlet's POS, their points, SVC balance, and tier status are fetched live from ProSeller. When the transaction completes, ProSeller's records update instantly.
[!WARNING] Changing integration settings on a live system will temporarily disrupt member lookups at POS while the new connection initialises. Schedule configuration changes during off-peak hours and test with a single outlet before rolling out to all locations.
[!CAUTION] Never share your API Token in screenshots, support tickets, or emails. If your token is compromised, regenerate it from the CRM provider's portal immediately and update this page. All POS terminals will need to sync before they can reconnect.
| Role | View | Create | Edit | Delete |
|---|---|---|---|---|
| Admin | Yes | Yes | Yes | Yes |
| Supervisor | Yes | Yes | Yes | No |
| Cashier | No backend access | — | — | — |
[!NOTE] Exact permissions depend on the Privileges Setup configured for each role. Contact your administrator if you cannot access this page.
Expected Result: Changes are saved successfully and reflected across the system after the next POS sync.
Expected Result: The new membership integration settings appears in the list and will be available across the system after the next POS sync.
Expected Result: The updated membership integration settings is saved and changes are reflected across the system after the next POS sync.
Expected Result: The record is soft-deleted — it is hidden from the active list and POS terminals but can be restored later using the "Show Deleted" filter.
[!WARNING] Records linked to active transactions or other modules cannot be deleted. The system will display an error if deletion is not allowed.
Q: Why is the member not receiving points? A: Check that the member's group has benefit rules configured in Membership Benefit. Also verify the transaction qualifies (minimum spend, eligible products).
Q: Can I merge duplicate member records? A: This must be done by your system administrator. Contact support with both member IDs for assistance.
Q: How do I transfer a member to a different group? A: Edit the member record and change the Membership Group field. The change takes effect immediately.
| Issue | Possible Cause | Solution |
|---|---|---|
| Cannot save the record | Required fields are empty or invalid | Check all fields marked with * and fill in valid data |
| Record not appearing in POS | POS terminal has not synced yet | Wait for the next sync cycle or manually trigger sync from Terminal Status |
| Cannot delete the record | Record is being used by other modules | Check if the record is linked to active transactions, products, or other settings |
| Changes not taking effect | Browser cache showing old data | Refresh the page (Ctrl+F5) or clear browser cache |
| "Duplicate" error on save | A record with the same name/code already exists | Search the list (including deleted records) for duplicates |
| Page not loading | Session expired or network issue | Log out and log back in. Check your internet connection |
[!NOTE] The following items may vary depending on your system version and configuration:
- Exact permission settings depend on your Privileges Setup configuration
- Sync timing to POS terminals depends on network conditions and sync schedule
- Some features may require additional licensing or module activation
- Field behavior may differ between EQuip versions
If you encounter behavior not described in this manual, contact your system administrator or EQuip support team.