Skip to content

Auto Renewal

D edited this page Aug 2, 2026 · 1 revision

Auto-Renewal (Subscriptions)

Subscriptions are supported out of the box (WooCommerce Subscriptions, Subscriptions for WooCommerce, YITH, Flexible Subscriptions, etc.). After the first subscription payment, customers are prompted to Setup Auto-Renewal on the order-received page.

How a Customer Enables Auto-Renewal

  1. After the first payment, the order-received page shows a Setup Auto-Renewal section
  2. The customer opens their CLINK wallet (ShockWallet, ZEUS, Amethyst)
  3. They click Get your nDebit string, which points to my.shockwallet.app/lapps
  4. They copy the ndebit1... string and paste it into the auto-renewal field
  5. Future payments are processed automatically — no QR scanning required

Customers can also skip the setup with Not now and enable it later.

My Account → View Subscription

The Payment row on the View Subscription page reflects the ndebit status:

State Display
No ndebit saved "Activate Auto-Renewal" link pointing back to the parent order's order-received page for setup
Ndebit saved "Auto-Renewal" (plain text)

Disabling Auto-Renewal

Customers can disable auto-renewal at any time from My Account → Subscriptions. Subscriptions without an ndebit show a Get nDebit String action link to enable auto-renewal later.

How Renewal Payments Work

  1. When a subscription renews, a renewal order is created by WooCommerce
  2. The order-received page loads in "processing renewal" mode and requests a BOLT 11 invoice for the renewal amount
  3. If the customer's wallet has the ndebit authorization, it pays automatically — the page shows "Auto-renewal in progress. Your wallet should pay this automatically."
  4. The payment is confirmed via a CLINK receipt and the renewal order is marked complete

Security

The ndebit string is stored per-subscription and the subscription is always resolved server-side from the verified parent order — the client never supplies a subscription ID. See Security.

Clone this wiki locally