# Customer Approval
{% hint style="info" %}
**Controlled Customer Registration** 🔒 The Customer Approval system allows you to manually review and approve new customer registrations before they can access your store, perfect for B2B portals, exclusive memberships, and high-security environments.
{% endhint %}
## Introduction
Customer Approval in OpenCart 4 provides a controlled registration process where new customer accounts require manual approval by an administrator. This feature is essential for stores that need to vet customers before granting access, such as B2B portals, exclusive memberships, or high-security environments.
## How Customer Approval Works
The approval process follows a structured workflow:
{% stepper %}
{% step %}
**Step 1: Customer Registration**
Customer completes the registration form on your storefront.
**Outcome:** Registration is submitted to the system.
{% endstep %}
{% step %}
**Step 2: Approval Check**
System checks if the customer's selected group requires approval.
**Possible paths:**
* **No approval required** → Account activated immediately
* **Approval required** → Account placed in pending approval queue
{% endstep %}
{% step %}
**Step 3: Admin Review (If Required)**
Administrator reviews the pending registration in the admin panel.
**Review includes:**
* Customer information
* Custom field data (if applicable)
* Any additional registration details
{% endstep %}
{% step %}
**Step 4: Decision & Notification**
Administrator makes a decision:
**Approve:**
* Account activated
* Customer receives approval notification email
* Customer can now log in and shop
**Deny:**
* Registration rejected
* Customer receives rejection notification email
* Registration data removed from system
{% endstep %}
{% endstepper %}
## Accessing Customer Approval
To access the Customer Approval interface:
1. Log in to your OpenCart admin panel
2. Navigate to **Customers → Customer Approval**
3. You'll see the approval list with pending requests
## Approval Types
OpenCart 4 supports two types of approval:
| Type | Description | Typical Use |
| ---------------- | ------------------------------- | -------------------------------------- |
| **Customer** 👤 | Standard customer registrations | Regular store customers, B2B portals |
| **Affiliate** 🤝 | Affiliate program registrations | Referral partners, affiliate marketers |
{% hint style="success" %}
**Type Selection Tip** 💡
Choose **Customer** approval for regular store registrations and **Affiliate** approval for partner program applications. Each type has separate approval queues and settings.
{% endhint %}
## Configuring Approval Requirements
Approval requirements are configured at the **customer group** level:
{% stepper %}
{% step %}
**Step 1: Access Customer Groups**
Navigate to **Customers → Customer Groups**
{% hint style="info" %}
**Group Management** 👥
Customer groups control which registrations require approval. Different groups can have different approval settings.
{% endhint %}
{% endstep %}
{% step %}
**Step 2: Edit Group Settings**
Click **Edit** on the customer group you want to configure
{% endstep %}
{% step %}
**Step 3: Set Approval Required**
In the group form, find **Approval Required** and select:
* **Yes** - Manual approval required
* **No** - Automatic approval (default)
{% hint style="warning" %}
**Approval Required Setting** ⚠️
* **Yes**: Each registration requires manual review (B2B portals, exclusive memberships)
* **No**: Automatic approval upon registration (standard retail stores)
{% endhint %}
{% endstep %}
{% step %}
**Step 4: Save Changes**
Click **Save** to update the group settings
{% hint style="success" %}
**Settings Applied** ✅
Approval requirements are now configured. New registrations in this group will follow the specified approval workflow.
{% endhint %}
{% endstep %}
{% endstepper %}
## Reviewing Pending Approvals
Customer Approval List 📋
The approval list displays all pending requests with the following information:
* **Name** - Customer/affiliate name
* **Email** - Contact email
* **Customer Group** - Requested group
* **Type** - Customer or Affiliate
* **Date Added** - Registration date
{% hint style="info" %}
**List Navigation Tips** 🔍
* Use pagination to navigate through large lists
* Refresh the page to see new pending requests
{% endhint %}
Filtering Approval Requests 🔎
Use the filter options to narrow down the list:
| Filter | Description |
| ---------------------- | --------------------------------- |
| **Name** 👤 | Search by customer name |
| **Email** 📧 | Search by email address |
| **Customer Group** 🏷️ | Filter by requested group |
| **Type** 📝 | Customer or Affiliate |
| **Date Added** 📅 | Filter by registration date range |
{% hint style="success" %}
**Filtering Best Practices** 🎯
* Combine multiple filters for precise searches
* Save frequent filter combinations as bookmarks
* Clear filters regularly to see all pending requests
{% endhint %}
## Approving or Denying Requests
{% stepper %}
{% step %}
**Step 1: Make Decision**
Based on your review, choose one of these actions:
**Approve Request** ✅
* Click **Approve** to activate the account
* Customer receives approval notification email
* Account becomes immediately active
**Deny Request** ❌
* Click **Deny** to reject the registration
* Customer receives rejection notification email
* Registration is removed from the system
{% hint style="warning" %}
**Decision Considerations** ⚖️
* **Approve**: When registration meets all requirements and seems legitimate
* **Deny**: When information is incomplete, suspicious, or doesn't meet criteria
* **Follow-up**: Consider requesting additional information if needed
{% endhint %}
{% endstep %}
{% step %}
**Step 2: Confirm Action**
Confirm your decision. The system will process the request and send appropriate notifications.
{% hint style="success" %}
**Action Completed** 🎉
The approval decision has been processed. Check the approval list to verify the request has been removed from pending queue.
{% endhint %}
{% endstep %}
{% endstepper %}
## Bulk Approval Operations
Batch Processing 🔄
To process multiple requests at once:
1. **Select requests** - Check boxes next to the requests you want to process
2. **Choose action** - From the bulk action dropdown:
* **Approve Selected** ✅ - Approve all selected requests
* **Deny Selected** ❌ - Deny all selected requests
{% hint style="warning" %}
**Bulk Operation Warning** ⚠️
Bulk operations apply to **all selected requests**. Double-check your selections before proceeding, as actions cannot be undone.
{% endhint %}
{% hint style="success" %}
**Efficiency Tip** ⚡
Use filters to narrow down requests before bulk operations. For example, filter by customer group to approve all wholesale applications at once.
{% endhint %}
## Email Notifications
OpenCart 4 sends automatic email notifications for approval actions:
Approval Email (Sent to Customer) ✅
* **Subject:** "Your account has been approved!"
* **Content:** Welcome message and login instructions
* **Includes:** Store contact information, login URL, support details
{% hint style="success" %}
**Approval Email Tips** 📧
* Customize email content in **System → Settings → Mail**
* Include store branding for professional appearance
* Test email delivery to ensure customers receive notifications
{% endhint %}
Denial Email (Sent to Customer) ❌
* **Subject:** "Your account registration"
* **Content:** Notification of rejection
* **Optional:** Include reason for denial (configurable)
{% hint style="warning" %}
**Denial Email Considerations** ⚠️
* Be professional and courteous in denial messages
* Consider offering alternative options when appropriate
* Comply with privacy regulations when explaining denials
{% endhint %}
Admin Notifications (Optional) 👨💼
Configure email alerts to notify administrators of new pending requests.
* **Setup:** Configure in **System → Settings → Mail**
* **Frequency:** Real-time or daily digest options
* **Recipients:** Multiple admin emails can be specified
{% hint style="info" %}
**Notification Management** 🔔
Use admin notifications to ensure timely review of pending requests, especially for time-sensitive applications.
{% endhint %}
## Approval Workflow Best Practices
{% hint style="success" %}
**Registration & Communication** 📝
1. **Clear Requirements**: Specify approval requirements on registration page
2. **Process Explanation**: Explain the approval process to potential customers
3. **Realistic Expectations**: Set realistic expectations for approval time
4. **Consistent Communication**: Maintain regular communication with applicants
{% endhint %}
{% hint style="warning" %}
**Efficient Review Process** ⚡
1. **Review Criteria**: Establish criteria for different customer groups
2. **Staff Designation**: Designate specific staff for approval tasks
3. **Response Time SLAs**: Set service level agreements for response time
4. **Daily Monitoring**: Check pending requests daily
{% endhint %}
{% hint style="info" %}
**Documentation & Improvement** 📊
1. **Decision Documentation**: Keep notes on approval decisions
2. **Denial Reasons**: Provide clear reasons for denials when appropriate
3. **Follow-up**: Follow up on incomplete applications
4. **Criteria Review**: Regularly review and update approval criteria
{% endhint %}
## Integration with Customer Groups
Group-Specific Approval 🏷️
Different customer groups can have different approval requirements:
| Group Type | Approval Setting | Use Case |
| -------------------------- | ----------------- | ---------------------------------- |
| **Retail Customers** 🛍️ | No approval | Standard public store |
| **Wholesale Customers** 🏢 | Approval required | B2B customers with special pricing |
| **VIP Members** 🥇 | Approval required | Exclusive membership program |
| **Affiliates** 🤝 | Approval required | Controlled affiliate network |
{% hint style="info" %}
**Group Strategy** 🎯
Configure approval requirements based on customer group risk and value. High-value groups (wholesale, VIP) often require approval, while retail customers can be auto-approved.
{% endhint %}
Custom Fields in Approval Process 📝
Custom fields assigned to customer groups appear in the approval review, providing additional information for decision-making.
* **Business Information**: Company details, VAT numbers, industry classification
* **Compliance Data**: Age verification, tax exemption status
* **Preferences**: Communication preferences, product interests
{% hint style="success" %}
**Enhanced Decision-Making** 💡
Use custom field data to make informed approval decisions. For example, require business registration documents for wholesale accounts.
{% endhint %}
## Troubleshooting
### Common Issues
Approval emails not sending 📧
**Possible Causes:**
* Email configuration incorrect
* SMTP server issues
* Email templates missing or misconfigured
**Solutions:**
1. Check email configuration in **System → Settings → Mail**
2. Test email functionality with test messages
3. Verify email templates exist and are properly formatted
Requests not appearing in list 🔍
**Possible Causes:**
* Customer group not set to require approval
* Registration not completed successfully
* Filter settings hiding requests
**Solutions:**
1. Verify customer group has "Approval Required" set to Yes
2. Check customer registration logs
3. Clear all filters to see all pending requests
Cannot approve/deny requests ❌
**Possible Causes:**
* Insufficient admin permissions
* System errors or conflicts
* Request already processed
**Solutions:**
1. Check admin permissions for customer approval module
2. Review system error logs
3. Refresh the approval list page
Bulk operations failing 🔄
**Possible Causes:**
* Mixed request types selected
* System timeout or resource limits
* Permission issues
**Solutions:**
1. Ensure all selected requests are of the same type (Customer or Affiliate)
2. Process smaller batches to avoid timeouts
3. Verify bulk operation permissions
{% hint style="info" %}
**Performance Tips** ⚡
* **Batch Processing**: Process approvals in batches at scheduled times
* **Smart Filtering**: Use filters to focus on specific customer groups
* **Automation**: Consider automated approval for low-risk groups
* **Cleanup**: Regularly clean up old denied requests to maintain performance
{% endhint %}
## Security Considerations
### Fraud Prevention 🕵️♂️
* Review IP addresses and geographic information
* Check for duplicate or suspicious email patterns
* Verify business information for B2B applications
### Data Privacy 🔒
* Handle customer information securely during review
* Comply with GDPR and other privacy regulations
* Securely dispose of denied application data
{% hint style="success" %}
**Documentation Summary** 📋
You've now learned how to:
* Configure and manage customer approval workflows in OpenCart 4
* Review and process pending approval requests
* Set up email notifications for approval decisions
* Integrate approval with customer groups and custom fields
* Apply best practices for efficient and secure approval processes
**Next Steps:**
* [Customer Groups](https://docs.opencart.com/admin-interface/customers/broken-reference) - Configure which groups require approval
* [Customer Management](https://docs.opencart.com/admin-interface/customers/broken-reference) - Manage approved customer accounts
* [Custom Fields](https://docs.opencart.com/admin-interface/customers/broken-reference) - Add custom information to approval reviews
* [GDPR Management](https://docs.opencart.com/admin-interface/customers/broken-reference) - Ensure approval process complies with data privacy regulations
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.opencart.com/admin-interface/customers/customer-approval.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.