Credit Topup for Booknetic SaaS

Sell SMS, WhatsApp & Email credit packs to your tenants — automatically.

When a tenant hits their monthly messaging limit, Booknetic Credit Top-up seamlessly switches to purchased credits. No manual actions, no support tickets, no broken workflows — just a clean, predictable top-up experience built specifically for Booknetic SaaS.

Built for: Booknetic SaaS owners running multi-tenant platforms with SMS, WhatsApp and Email messaging limits.

What this add-on does

Booknetic Credit Top-up adds a complete top-up system for SMS, WhatsApp and Email credits inside Booknetic SaaS:

• Super Admin creates top-up plans (name, price, credits) for each channel

• Tenants purchase plans from their Billing page

• Payments: Balance, Stripe Checkout or Mercado Pago (one-time)

• Auto-usage: monthly limit first → purchased credits second

• Depletion warnings: when credits are finished, the tenant sees a clear message

• Workflow automation: trigger notifications when credits are purchased or exhausted

• No core edits: integration is hook/filter based + runtime driver override (no file patching)

Why you'll want this

Reduce churn + reduce support load

Tenants don't want to upgrade their plan just because they had a busy week. Let them top-up instantly and keep sending messages without contacting you.

Better monetization for your SaaS

You can introduce top-ups as a lightweight upsell:

• Smaller, impulse purchases

• Flexible for seasonal usage

• Increases ARPU without forcing plan changes

It only works after monthly limits

Purchased credits are consumed only when monthly credits are exhausted — fully automatic.

Automate with workflows

Set up automatic notifications when a tenant purchases credits or runs out — no manual monitoring needed.

Key Features

✅ Super Admin: Create and manage Top-up Plans

• Separate tabs for SMS, WhatsApp and Email plans

• Active/Inactive visibility control

• Searchable plan tables

• Edit plan name/description/status (price + credits locked for integrity)

• Delete plans without affecting already purchased credits

✅ Super Admin: Settings & Customization

• Enable/disable each credit type (SMS, WhatsApp, Email)

• Enable/disable each payment method (Balance, Stripe, Mercado Pago)

• Set default payment method for tenants

• Display options: show/hide remaining credits, plan credits, descriptions

• Customize menu label and button color

• Currency settings with 19 supported currencies + custom symbol

• Settings presets (Minimal, Balanced, Sales) for quick configuration

• Success redirect delay (0–10 seconds)

✅ Tenant: Purchase credits from Billing

• TOP-UP buttons appear only when relevant (permissions + limits + active plans)

• Clean plan selection modal

• Shows remaining credits (configurable)

• Balance, Card or Mercado Pago payment

• Prices respect admin's decimal/thousands separator settings

✅ Payments: Balance + Stripe + Mercado Pago

• Balance: instant credit addition

• Stripe: one-time checkout session (not subscription)

• Mercado Pago: one-time checkout with IPN webhook support

• Proper handling for canceled/failed payments

• Configurable default payment method

✅ Smart credit logic

Credit consumption order:

• Unlimited plan? → use monthly only

• Monthly still available? → use monthly

• Monthly finished? → use purchased credits

• No credits left → block send + show warning

✅ Accurate tracking

• Monthly credits tracked via WorkflowLog

• Purchased credits tracked via user_meta

• Purchased credits never reset and are cumulative

✅ Workflow automation

Four workflow events for SaaS admin automation:

• Credit top-up purchased — fires when any credit pack is bought

• SMS credits exhausted — fires when all SMS credits run out

• WhatsApp credits exhausted — fires when all WhatsApp credits run out

• Email credits exhausted — fires when all Email credits run out

Five shortcodes available for the purchase event:
{topup_plan_name}, {topup_plan_type}, {topup_credits}, {topup_price}, {topup_payment_method}

Use case: SaaS admin creates a workflow → selects "Credit top-up purchased" event → adds "Send Email" action → uses shortcodes in the template → tenant automatically receives a purchase confirmation email.

✅ Reliability built-in

• Edge-case handling for disabled workflow add-ons (refund to balance)

• Acceptable race-condition behavior (worst-case +1 credit usage in simultaneous sends)

• Mercado Pago IPN webhook ensures credit assignment even if the tenant closes the browser

Requirements

• Booknetic Core Plugin (active)

• Booknetic SaaS Module (active)

• At least one workflow add-on active:

  • booknetic-workflow-twilio-sms (for SMS top-ups)

  • booknetic-workflow-twilio-whatsapp (for WhatsApp top-ups)

  • booknetic-workflow-email (for Email top-ups)

• For Stripe payments: Stripe keys configured in SaaS Settings (Secret + Public)

• For Mercado Pago payments: Access Token configured in Top-up Plans Settings

How it works (high level)

Admin flow

You create top-up plans in Top-up Plans (SMS/WhatsApp/Email tabs). Configure payment methods and display options in Settings. Optionally set up workflow automations for purchase confirmations and exhaustion alerts. Tenants see only active plans.

Tenant flow

Tenants open Billing → choose plan → pay (Balance / Stripe / Mercado Pago) → credits added immediately.

Messaging flow

When Booknetic sends a message, the enhanced workflow driver checks:

• Monthly credits first

• Purchased credits only if monthly limit is reached

• Stops and shows warning when nothing is available

• Triggers exhaustion workflow event when last credit is consumed

Payment setup (quick)

Stripe

• Uses SaaS currency settings

• Supports zero-decimal currencies (JPY, KRW, VND, etc.) correctly

• Uses Stripe Checkout: mode: payment (one-time)

• Includes metadata for reliable confirmation

• Success/cancel URLs are handled automatically

Mercado Pago

• Access token configured in Top-up Plans Settings

• Creates checkout preferences via Mercado Pago API

• IPN webhook for reliable payment confirmation (even if browser is closed)

• Success/failure/pending return URLs handled automatically

What makes this "clean" (developer-friendly)

• No edits to core Booknetic files

• No edits to Twilio/Email workflow add-on files

• Runtime driver override (priority-based, same slug replacement)

• Tracking stored in predictable places (TenantBilling + user_meta)

• Uninstall-safe: plan tables removed, user_meta preserved to prevent data loss

Database & tracking details (for transparency)

Creates:

• wp_bkntc_saas_sms_plans

• wp_bkntc_saas_whatsapp_plans

• wp_bkntc_saas_email_plans

Uses existing:

• wp_bkntc_tenant_billing for purchase history records

Stores purchased credit counters in wp_usermeta:

• topup_sms_purchased, topup_sms_used

• topup_whatsapp_purchased, topup_whatsapp_used

• topup_email_purchased, topup_email_used

What happens on uninstall?

When the plugin is deleted:

• Plan tables are dropped (SMS, WhatsApp, Email)

• DB version option removed

• Purchased credit user_meta is kept (prevents accidental data loss)

Who this is for

• Booknetic SaaS platform owners

• Anyone using Twilio SMS / WhatsApp or Email workflows with plan limits

• SaaS owners who want an upsell without forcing plan changes

• SaaS owners who want to automate credit-related notifications

FAQ

Do purchased credits reset monthly?
No. Purchased credits are cumulative and never reset.

Will tenants see top-up buttons on unlimited plans?
No. If the tenant's messaging limit is unlimited (-1), top-up buttons are hidden.

Does this affect monthly credit counters?
No. When purchased credits are consumed, the workflow does not write to WorkflowLog (monthly counters remain clean).

What if Stripe/Mercado Pago payment succeeds but the messaging add-on is disabled?
Credits aren't added. The paid amount is refunded back to the tenant's balance.

Can I disable a plan later?
Yes. Set it to Inactive — it won't appear for new purchases, but previously bought credits still work.

Can I set up automatic notifications for credit events?
Yes. The add-on registers workflow events in the SaaS admin panel. You can create workflows to send email/SMS/WhatsApp notifications when credits are purchased or exhausted.

Does it support Email credits too?
Yes. Full Email credit support is included — plans, purchase, consumption, and exhaustion warnings — with the same automatic logic as SMS and WhatsApp.

What you get

• Booknetic Credit Top-up add-on plugin files

• Full documentation (HTML)

• Future updates within the Gumroad download