Skip to main content

​
Recurring Billing

Automate subscription and recurring payment processing for your customers.

​
What is Recurring Billing?

Subscription Management

Create, manage, and monitor automated recurring billing schedules for subscription services and regular payments.

​
Key Operations

Create Schedule

Set up new recurring billing schedules

Manage Schedule

Pause, resume, or modify existing schedules

Monitor Billing

Track recurring payment performance

​
How It Works

1

Customer Authorization

Customer must approve recurring billing with approve_recurring decision
2

Create Schedule

Set up billing frequency, amount, and duration
3

Automated Processing

System automatically processes payments on schedule
4

Monitor & Manage

Track performance and handle schedule changes

​
Create Recurring Schedule

{
  "agreementPhrase": "customer-agreement-phrase",
  "amount": 1500,
  "currency": "NGN",
  "frequency": "monthly",
  "description": "Netflix Premium Subscription",
  "startDate": "2024-02-01"
}

​
Manage Schedule

curl -X POST "https://api.peere.network/v1/recurring/{scheduleId}/pause" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Billing Frequencies

Daily

Every day

Weekly

Every 7 days

Monthly

Every 30 days

Custom

Custom intervals

​
Use Cases

Monthly or annual subscriptions for software, streaming, or membership services.
Customers must have approve_recurring permission for automated billing. One time approvals (approve_once) require manual billing for each transaction.

​
Schedule Management

Monitor your recurring billing schedules and handle failed payments gracefully. Implement retry logic and customer notification systems for optimal experience.

​
Next Steps

After setting up recurring billing:
  1. Transaction Management to monitor recurring payments
  2. Customer Decisions to handle permission changes
  3. Refund Management for subscription refunds