Paddle Payment Plugin for Acelle

🚀 Overview

The Paddle Payment Plugin for Acelle connects your Acelle installation to Paddle, enabling
one-time purchases, recurring subscriptions, EU/UK-friendly tax handling, and automated lifecycle events through signed webhooks.
It’s designed for SaaS owners, email marketers, and agencies who monetize lists, plans, or credits inside Acelle.

Experience-led design: This integration follows real-world billing flows used in production—trial → subscribe → invoice → prorate → cancel—so teams can launch paid plans faster while keeping payment ops auditable and compliant.

✨ Key Features

• Native Paddle Checkout — Overlay and hosted checkout with locale & currency support.
• Subscriptions & Trials — Create, upgrade/downgrade, pause, resume, and cancel plans mapped to Acelle packages.
• Secure Webhooks — Signature verification for events (payment_succeeded, subscription_created, updated, canceled, refund_issued, etc.).
• Customer Sync — Auto-provision user access on success; suspend on failed/expired payments.
• Tax & Invoicing — Leverage Paddle’s built-in VAT/GST handling and invoicing.
• Coupons & Promotions — Apply Paddle coupons to Acelle plan purchases.
• Refund & Dispute Hooks — Reflect refunds/chargebacks in Acelle usage states.
• Sandbox Mode — End-to-end testing with Paddle sandbox credentials.
• Activity Logs — Store webhook payloads, statuses, and responses for audit trails.
• Multi-Currency — Price localization using Paddle pricing models.
• Fail-Safe Retries — Graceful retry and idempotency keys to avoid duplicate records.

⚙️ Technical Stack

• Language/Framework: PHP (Acelle is Laravel-based), JavaScript for checkout UI, JSON for webhooks.
• Server Requirements (typical): PHP 7.4+ or 8.x, MySQL/MariaDB, OpenSSL, curl, mbstring, json, HTTPS enabled.
• Acelle: Works with modern Acelle builds (plugin architecture enabled, webhook endpoint reachable).
• Dependencies: Paddle SDK / REST endpoints; Composer for autoloading (optional, if not bundled).
• Infrastructure: Apache or Nginx, Linux recommended; queue/cron for webhook processing & retries.

🧩 Installation Guide

1. Upload the plugin folder to your Acelle /plugins (or the designated extensions directory).
2. Install & Enable the plugin from the Acelle admin panel → Plugins.
3. Configure Credentials: add Paddle Vendor ID, API Key, and Public Key; toggle Sandbox if testing.
4. Set Webhook URL: copy the plugin’s webhook endpoint into Paddle Dashboard → Webhooks; enable event types.
5. Map Plans: link Paddle products/prices to Acelle plans/packages.
6. Test Flow: run a sandbox checkout, confirm user provisioning and invoice records.
7. Go Live: switch to live keys, verify DNS/HTTPS, and announce availability.

📦 Deliverables

• Complete plugin source code (GPL-licensed).
• Configuration file(s) & environment examples.
• Webhook verifier & sample payloads.
• Plan mapping & pricing templates.
• Quick-start guide & basic troubleshooting notes.
• Changelog & structured README.

📱 Supported Platforms

• Server OS: Linux (recommended), works on standard LAMP/LEMP stacks.
• Web Server: Apache or Nginx with HTTPS.
• Database: MySQL or MariaDB (as used by Acelle).
• Admin/Client UI: Modern browsers (Chrome, Firefox, Edge, Safari) on desktop & mobile.

🧠 Notes

• License: Distributed under the GPL (free to use, modify, and redistribute under the same license).
• Customization Tips:
  • Override checkout UI texts and locales via the plugin’s view layer.
  • Extend webhook handlers to post events to your CRM, Slack, or accounting tools.
  • Use queue workers for resilient webhook processing at scale.
• SEO Assurance: Clean URL endpoints, structured headings, concise metadata, and human-readable copy help search engines understand your product page and changelog entries.

👨‍💻 Original Developer Credit

This plugin credits its original author. For provenance and authoritativeness, see the
original listing on CodeCanyon.

🔒 Disclaimer

This download is a GPL redistribution intended for educational and archival purposes. We are not the original seller and
do not claim ownership of the trademark(s) or brand(s) mentioned. All files are provided “as-is,” without bundled commercial
support or license keys. If you require official support, automatic updates, or commercial licensing, please purchase directly from the
original developer or marketplace.