How Payment Generation Works
FlexPortal automatically creates payment records for subscriptions:Automatic Generation
When a subscription is activated:- First payment is generated based on the start date
- Recurring payments are scheduled monthly or per billing frequency
- Payments continue until the contract ends
- Subscription starts: January 1
- Monthly payment: $89
- 12-month contract
- 12 payments generated: Jan 1, Feb 1, Mar 1… Dec 1
Payments are generated but not automatically collected. You must mark them as paid or integrate with a payment processor.
Payment Statuses
Payments flow through different statuses:| Status | Description |
|---|---|
| Pending | Payment is due, awaiting payment |
| Processing | Payment is being processed |
| Paid | Payment completed successfully |
| Failed | Payment attempt unsuccessful |
| Cancelled | Payment voided or cancelled |
Status Details
Pending
Payment has been generated and is awaiting payment:- Shows on customer invoice
- Due date is set
- Waiting for customer to pay
Processing
Payment is currently being processed:- Submitted to payment gateway
- Awaiting confirmation
- Usually brief transition state
Paid
Payment completed successfully:- Funds received
- Applied to subscription
- Increases cost recovery
Failed
Payment attempt was unsuccessful due to:- Payment declined
- Insufficient funds
- Expired card
- Bank rejection
Cancelled
Payment was voided:- Subscription cancelled before payment
- Payment no longer needed
- Invoice withdrawn
Viewing Payments
Navigate to Payments in the left sidebar to see all payments across all subscriptions. The payment list shows:- Customer name
- Subscription reference
- Amount
- Due date
- Status
- Payment method
Payment Details
The payment detail page includes:Payment Information
- Amount
- Currency
- Due date
- Payment date (when paid)
- Status
Subscription Reference
- Subscription ID
- Product and variant
- Customer name
- Monthly payment amount
Invoice
- Invoice number
- Invoice date
- Downloadable PDF
- Line items and totals
Payment Method
- Card type (if card payment)
- Last 4 digits
- Payment processor reference
Marking Payments as Paid
When you receive payment outside the system (bank transfer, check, cash):- Navigate to Payments
- Find the pending payment
- Click on the payment
- Click Mark as Paid in the top right
- Enter:
- Payment date - When payment was received
- Payment method - How customer paid
- Reference - Check number, transaction ID, etc.
- Click Confirm
Payment Search and Filtering
Find payments quickly:Search by:
- Customer name
- Subscription ID
- Invoice number
- Reference number
Filter by:
- Status - Pending, Paid, Failed, Cancelled
- Due date range - Payments due in specific period
- Payment date range - When payments were received
- Customer - All payments for specific customer
- Billing Group - All payments for a group
Sort by:
- Due date (oldest first)
- Amount (high to low)
- Customer name (A-Z)
- Status
Billing Frequency
Subscriptions can have different billing frequencies:- Monthly - Payment every month (most common)
- Quarterly - Payment every 3 months
- Annually - One payment per year
Monthly billing is default and most common. Quarterly or annual billing reduces transaction costs but increases customer commitment.
Failed Payments
When payments fail, take action promptly:Handling Failed Payments
- Payment fails (declined card, insufficient funds)
- Status changes to “Failed”
- Customer is notified
- Contact customer about failure
- Update payment method
- Retry the payment manually
Retry Process
- Navigate to the failed payment
- Click Retry Payment
- Confirm payment method is updated
- Process retry
- Status changes to Paid if successful
Payment Terms for Business Customers
Business customers can have extended payment terms:| Term | Due Date |
|---|---|
| Net 7 | 7 days after invoice date |
| Net 14 | 14 days after invoice date |
| Net 30 | 30 days after invoice date |
Setting Payment Terms
- Open business customer profile
- Edit customer details
- Select Payment Terms
- Save changes
- Invoice generated: January 1
- Payment terms: Net 30
- Due date: January 31
Individual customers have immediate payment due dates (same as invoice date).
Billing Groups
Dashboard UI Coming Soon — Billing Group management in the dashboard is currently in development. You can create and manage Billing Groups today using the Billing Groups API.
What is a Billing Group?
A Billing Group combines multiple customers (usually employees) and subscriptions into a single consolidated invoice with one payment for all subscriptions. Example:- Company: Acme Corp
- Employees: 5 people with laptops
- Each has subscription
- One invoice to Acme Corp for all 5
- One payment covers all subscriptions
Creating a Billing Group
- Navigate to Billing Groups
- Click New Billing Group
- Enter:
- Group name - Company or department name
- Primary contact - Billing contact person
- Email - Where to send invoices
- Payment terms - Net 7, 14, or 30
- Click Save
Adding Customers to Billing Group
- Open the Billing Group
- Click Add Customer
- Search for customer by name or email
- Select customer
- Click Add
Billing Group Invoices
Consolidated invoices show:- All subscriptions in the group
- Line item for each subscription
- Customer name for each line
- Total amount due
- Single payment to cover all
- Open Billing Group
- View Invoices section
- Click Generate Invoice for the billing period
- Download PDF
- Send to billing contact
Invoices
Each payment has an associated invoice:Invoice Contents
- Invoice number (unique)
- Invoice date
- Due date
- Customer information
- Billing address
- Line items:
- Product and variant
- Subscription period
- Amount
- Subtotal
- Tax (if applicable)
- Total amount due
Viewing Invoices
- Navigate to payment
- Click Download Invoice
- PDF opens or downloads
- Open subscription
- Scroll to Payments section
- Each payment has invoice link
Sending Invoices
Email invoices to customers:- Download invoice PDF
- Email to customer’s billing contact
- Include payment instructions
- Reference invoice number
Future update: Automatic invoice email when payments are generated.
Payment Methods
FlexPortal supports various payment methods:Credit/Debit Cards
- Visa, Mastercard, Amex
- Stored securely in payment gateway
- Automatic retry on failure
Bank Transfer
- Customer transfers funds directly
- Provide bank details on invoice
- Manually mark as paid when received
Direct Debit
- Automatic withdrawal from customer account
- Requires customer authorization
- Lower failure rate than cards
Check
- Physical or electronic checks
- Mark as paid when check clears
- Reference check number
Cash
- In-person payments
- Issue receipt
- Mark as paid immediately
Payment Reports
Track payment performance:Key Metrics
- Total income - All paid payments
- Outstanding balance - Pending payments total
- Payment success rate - Paid / Total
- Average payment value - Mean payment amount
- Failed payment rate - Failed / Total
Viewing Payment Reports
Navigate to Reports to see:- Income over time
- Payment status distribution
- Failed payment trends
- Customer payment history
- Billing Group performance
Common Scenarios
Recording Bank Transfer Payment
- Check bank account for transfer
- Note transfer reference and amount
- Find corresponding pending payment
- Mark as Paid
- Enter transfer reference
- Save
Handling Card Decline
- Payment fails with status “Failed”
- System notifies customer
- Contact customer about decline
- Customer updates card information
- Retry payment
- Verify payment succeeds
Generating Monthly Invoices for Billing Group
- Navigate to Billing Group
- Review all subscriptions in group
- Generate consolidated invoice
- Download PDF
- Email to billing contact
- Wait for payment
- Mark group payment as paid
Customer Disputes Payment
- Review payment details
- Check subscription terms
- Verify payment amount is correct
- Provide invoice and contract
- Resolve dispute
- Adjust payment if necessary
Setting Up Recurring Card Payments
- Customer provides card details
- Store securely in payment gateway
- Mark card as default payment method
- Payments automatically attempt to charge card
- Monitor for failures
- Update card when expired
Payment Collection Best Practices
Timing
- Send invoices 7 days before due date
- Send reminder 2 days before due date
- Follow up immediately on failed payments
- Offer grace period before suspension
Communication
- Clear payment instructions on invoices
- Multiple payment method options
- Prompt notification of failed payments
- Easy way to update payment methods
Billing Groups
- Consolidate invoices for businesses
- Single contact person for billing
- Flexible payment terms
- Professional invoice presentation
Failed Payment Management
- Immediate follow-up
- Multiple retry attempts
- Clear communication of consequences
- Flexible resolution options
Payment Security
Protect customer payment information.PCI Compliance
- Never store full card numbers
- Use payment gateways for card storage
- Tokenize payment methods
- Encrypt sensitive data
Best Practices
- Secure payment forms
- Verify customer identity
- Monitor for fraud
- Use secure communication channels
Refunds and Credits
Handle refunds when needed:Processing Refunds
- Navigate to the payment
- Click Refund Payment
- Enter:
- Refund amount (full or partial)
- Reason for refund
- Confirm refund
- Funds returned to customer
When to Refund
- Customer charged incorrectly
- Subscription cancelled mid-period
- Early return with refund policy
- Payment dispute resolution
- Service failure or issue
Integration with Payment Processors
FlexPortal integrates with payment processors for automated collection:Supported Processors (Coming Soon)
- Stripe
- PayPal
- Square
- Bank integrations
Benefits of Integration
- Automatic payment collection
- Reduced manual work
- Faster payment processing
- Better success rates
- Real-time payment status