Skip to main content
Recurring payments are the fixed-cadence branch of the shared stream product. They are enforced by RecurringPaymentCovenant and appear in the same create, detail, activity, and batch workflows used for other stream families.

What Recurring Payments Support

CapabilityCurrent behavior
Fixed cadence payoutsWeekly, monthly, quarterly, or custom cadence where the interval divides the full schedule evenly
BCH and CashTokensBoth are supported
Refillable runwaySupported for recurring streams configured as refillable
Pause / ResumeSupported when the stream is cancelable
CancelSupported when the stream is cancelable
Recipient transferNot supported for recurring streams

Two Recurring Modes

Fixed recurring schedule

The sender defines:
  • total amount
  • schedule duration
  • interval cadence
The contract derives a fixed amount per interval and releases the overdue intervals when the recipient claims.

Refillable recurring runway

The sender creates an open-ended recurring stream with refill enabled. In this mode:
  • the cadence is fixed
  • the sender can add more runway later with a contract-aware refill action
  • the stream detail page shows the current funded runway and refill controls
Refillable recurring streams must be topped up with the dedicated refill flow. Sending BCH directly to the contract address is not the supported mechanism.

Claiming a Recurring Payment

1

Open the stream

Navigate to the recurring stream from the personal stream list or the treasury stream workspace.
2

Review due cadence

The detail page shows the amount per interval, the cadence, the next payment checkpoint, and whether the stream is refillable.
3

Claim

Click Claim. The backend builds a recurring payment claim transaction and the wallet signs it.
4

Confirm

After broadcast, FlowGuard confirms the claim and updates the recurring state and activity feed.

Refill Flow

If the stream is refillable and you are the sender:
  1. Open the recurring stream detail page
  2. Enter the refill amount
  3. Sign the refill transaction
  4. Confirm the refill broadcast
The stream remains the same on-chain stream. The refill extends runway by increasing the funded amount tracked for that recurring covenant.

Where to Use It

  • Payroll
  • Contributor stipends
  • Retainers
  • Treasury operating budgets
  • Subscription-style BCH or CashToken payouts