Promote Orders
Payment · Promotion · Marketing
Job Promotion System
The Promote Orders system enables companies to pay for job promotion through PayPal integration. When a promotion order is paid, the job is automatically marked as promoted and pinned to the top of search results, increasing visibility to qualified candidates.
PayPal Integration
Secure payment processing with PayPal Orders API v2.
Automatic Promotion
Jobs are automatically promoted and pinned after payment.
Order Management
Complete order tracking with status management and reporting.
Key Features
Essential promotion tools.
PayPal Payment Processing
Secure payment integration with PayPal Orders API v2 and webhook support.
Automatic Job Promotion
Jobs are automatically marked as promoted and pinned to top after payment.
Order Management Dashboard
Comprehensive order tracking with filtering, search, and status management.
Email Notifications
Automatic payment confirmation emails sent to users.
Advanced Search & Filtering
Search orders by user, job, transaction ID with status-based filtering.
Invoice Generation
Generate printable invoices for all promotion orders.
Super Admin Features
Cross-company order viewing and login-as-user capabilities.
Multi-Currency Support
Configurable promotion costs with currency conversion for PayPal.
Promotion Management Overview
Visual guide to promotion management features.
This video demonstrates the complete promotion management workflow including payment initiation, PayPal integration, order tracking, and automatic job promotion features.
Payment Flow
Step-by-step payment process.
Initiate Payment
User selects job to promote and fills payment details. System creates PromoteOrder record and calls PayPal API.
PayPal Redirect
User is redirected to PayPal hosted payment page for secure payment completion.
Payment Capture
After PayPal approval, system captures payment and updates order status to 'paid'.
Job Promotion
System automatically marks job as promoted, pins it to top, and sends confirmation email.
Order Status Management
Order lifecycle states.
Pending
Payment initiated, awaiting user action or PayPal processing.
Paid
Payment successful, job is promoted and pinned to top.
Failed
Payment processing failed or was declined.
Cancelled
User cancelled the payment process.
Permissions
Required permissions for promotion operations.
| Action | Permission |
|---|---|
| View Promote Orders | promote-orders.view |
| Initiate Promotion | promote-orders.create |
| Manage Promote Costs | promote-cost.update |
| View All Companies Orders | superadmin |
Best Practices
Promotion management guidelines.
| Practice | Recommendation |
|---|---|
| Payment Testing | Always test with PayPal sandbox before going live |
| Cost Configuration | Set appropriate promotion costs based on market rates |
| Webhook Setup | Configure PayPal webhooks for reliable payment confirmations |
| Order Monitoring | Regularly monitor order statuses and failed payments |
| Currency Support | Configure supported currencies and conversion rates |
Troubleshooting
Common issues and solutions.
| Issue | Fix |
|---|---|
| PayPal connection failed | Check PayPal API credentials and ensure correct mode (sandbox/live) |
| Payment not captured | Verify webhook configuration and check capture endpoint logs |
| Job not promoted after payment | Check if payment webhook was received and job promotion logic executed |
| Currency not supported | System auto-converts to USD for PayPal transactions |
| Email notifications not sent | Check email configuration and mail service settings |