SaaS Billing Asaas Integration Rails 8 Hosted on Heroku + Neon

Subscriptify

A full-stack subscription and recurring billing platform built on top of Asaas, focused on automating customer management, billing workflows, and recovery for recurring businesses (gyms, schools, digital subscriptions).

Subscriptify Dashboard

Platform Overview

Subscriptify is a business management layer on top of the Asaas API. Instead of forcing teams to work directly inside the payment provider dashboard, the platform centralizes customer lifecycle, plans, subscriptions, checkout flows, and webhook-driven updates into one place.

Architecture Highlights

Payments and subscriptions are handled through Asaas integration, while internal logic manages customer profiles, plan data, subscription states, checkout sessions, webhook persistence, and safe retries for critical operations.

Hosting

Server deployed on Heroku and PostgreSQL hosted on NeonDB. This setup keeps the platform cloud-ready while still lightweight for a portfolio deployment.

Work Breakdown (Based on Commit History)

Features 61%
Fixes 18%
Tests 11%
Refactors 10%

Percentages estimated from commit messages and categorized into features, fixes, tests, and refactors/migrations.

Implemented

  • Public plan landing pages with checkout CTA and FAQ.
  • Customer management (CRUD, validation, normalization, PII-safe updates).
  • Plans and products management with company scoping.
  • Subscriptions model, endpoints, and lifecycle activation logic.
  • Asaas integration with provider adapter, customer sync, and payment creation.
  • Checkout sessions and webhook persistence.
  • Webhook ingestion with access-token validation.
  • Race-condition guards in customer and subscription creation.
  • Hosted infrastructure on Heroku + NeonDB.

Not Yet Implemented

  • Notifications (email/WhatsApp delivery system).
  • Customer portal for self-service subscription management.
  • Webhook synchronization (async processing, retries, reconciliation).
  • Idempotency verification for provider requests.
  • Retention verification and churn analytics.
  • Feature flag system and audit logs.
  • API integrations for third-party apps.
  • Advanced automation (rule engine, retry storm protection, poisoning jobs).

Roadmap Focus

  • Operational hardening: idempotency, rate limiting, defensive analytics.
  • Automation: business rules engine + messaging templates.
  • UI/UX: client plans page, configuration page, onboarding flow.
  • Testing: spider test, JS tests, payment validation coverage.
  • Architecture: clean modal partials, safer dependent deletes.

Current Focus

  • Stabilize webhooks with async processing and retries.
  • Improve checkout validation and user error messaging.
  • Expand plan options (payment methods and subscription itemization).
  • System documentation for onboarding and maintenance.