Skip to main content

​
Recurring Billing

Manage subscription and recurring payment schedules for your merchants.

​
What is Recurring Billing?

Subscription Management for Merchants

Create and manage automated recurring billing schedules on behalf of your merchants, enabling subscription services and regular payment processing.

​
Key Operations

Create Schedules

Set up recurring billing for merchants

Manage Schedules

Pause, resume, or modify existing schedules

Monitor Performance

Track recurring payment success rates

​
How It Works

1

Customer Authorization

Customer must approve recurring billing with approve_recurring decision
2

Schedule Creation

Create recurring billing schedule on behalf of merchant
3

Automated Processing

System processes payments automatically on schedule
4

Performance Monitoring

Track success rates and handle failures

​
Create Recurring Schedule

{
  "entityId": "merchant_456",
  "agreementPhrase": "customer-agreement-phrase",
  "amount": 2999,
  "currency": "NGN",
  "frequency": "monthly",
  "description": "Premium subscription",
  "startDate": "2024-02-01"
}

​
Manage Schedules

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

Enable software merchants to bill customers monthly or annually for their services.

​
Schedule Management

Monitor recurring billing performance across all merchants and provide insights to help them optimize their subscription strategies and reduce churn.
Track payment success rates and identify patterns in failed payments.
Customers must have approve_recurring permission for automated billing. Schedules created with approve_once permissions will fail.

​
Next Steps

After implementing recurring billing:
  1. Transaction Management to monitor recurring payments
  2. Refund Management to handle subscription refunds