🇺🇸 RedMaple Invoice Generator - Multilingual User Manual

Complete guide for multi-tenant SaaS invoicing, client CRM, Stripe/PayPal checkout, localized taxes, and secure PDF delivery.

1. Platform Architecture & Multi-Tenancy

Cryptographically isolated agency workspaces and tenant scopes

RedMaple is built on a strict multi-tenant schema where every agency operates in an isolated workspace container:

  • Tenant Scoping: All database queries are automatically scoped using WorkspaceScope, guaranteeing zero data leakage between agencies.
  • Enterprise Authentication: Strong Bcrypt credential hashing and CSRF token verification.
  • Role-Based Access Control (RBAC): Permissions segregated by Owner, Admin, and Staff tiers.

2. Client Directory & Multilingual Support (Urdu, Hindi, Turkish)

Multi-currency billing and localized customer preferences

When registering a client in the CRM, you can configure their specific language and billing rules:

Supported Languages English, Urdu (اردو), Hindi (हिन्दी), Turkish (Türkçe), Arabic (العربية), Spanish, French, German, Chinese.
Supported Currencies USD ($), EUR (€), GBP (£), AED (د.إ), SAR (﷼), CAD (C$), AUD (A$), INR (₹), TRY (₺), PKR (Rs).
Payment Terms Due on Receipt, Net 7 Days, Net 14 Days, Net 30 Days, Net 60 Days.

3. Invoicing Engine & Sequential Numbering Lock

Atomic gap-less sequence locking per workspace

Every issued invoice is assigned a concurrency-safe sequential code (e.g., INV-2026-0001). An atomic database sequence counter prevents duplicate numbering even under simultaneous checkout attempts.

4. Country Taxation Rules & PDF Security

GAAP/IFRS pre-tax discounts and optional client PIN protection

  • Pre-Tax Discount Calculation: Taxes are computed strictly after deducting discounts: Taxable Amount = Subtotal - Discount.
  • Regional Tax Presets: UK VAT (20%), DE MwSt (19%), UAE VAT (5%), Saudi Arabia VAT (15%), India GST (18%), Turkey KDV (20%), Pakistan Sales Tax (16%).
  • PDF Security PIN: When creating sensitive commercial invoices, enable "Password Protect PDF". The client must enter the assigned PIN before downloading the document.

5. Credit Notes & Ledger Refunds

Accounting integrity and immutable reversal trail

In commercial accounting, issued invoices must never be deleted. To correct errors, billing mistakes, or cancelled projects, an agency issues a **Credit Note** (CN-YYYY-XXXX).

Credit notes automatically adjust outstanding balances, update the financial audit trail, and maintain strict accounting compliance.

6. Stripe, PayPal & Webhook Processing

Idempotent automated reconciliation without duplicate charges

Configure your webhook endpoints in your gateway developer dashboard:

Stripe Webhook URL: https://redmapleagency.com/webhooks/stripe
PayPal Webhook URL: https://redmapleagency.com/webhooks/paypal

Every webhook payload is verified and indexed using its gateway event ID, preventing double-crediting if a webhook is retried.

7. SaaS Membership & Atomic Coupons

Promo codes for subscription signups and renewals

Agencies can subscribe to or renew SaaS tiers using discount coupons:

LAUNCH2026 20% off all plans
HOSTINGER50 50% promotional discount
SAVE10FIXED $10.00 flat discount

Coupons feature atomic concurrency checks preventing race conditions during checkout spikes.