> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peere.co/llms.txt
> Use this file to discover all available pages before exploring further.

# guides

# Recurring Billing

Automate subscription and recurring payment processing for your customers.

## What is Recurring Billing?

<Card title="Subscription Management" icon="arrows-rotate">
  Create, manage, and monitor automated recurring billing schedules for subscription services and regular payments.
</Card>

## Key Operations

<CardGroup cols={3}>
  <Card title="Create Schedule" icon="plus">
    Set up new recurring billing schedules
  </Card>

  <Card title="Manage Schedule" icon="settings">
    Pause, resume, or modify existing schedules
  </Card>

  <Card title="Monitor Billing" icon="chart-line">
    Track recurring payment performance
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Customer Authorization">Customer must approve recurring billing with approve\_recurring decision</Step>
  <Step title="Create Schedule">Set up billing frequency, amount, and duration</Step>
  <Step title="Automated Processing">System automatically processes payments on schedule</Step>
  <Step title="Monitor & Manage">Track performance and handle schedule changes</Step>
</Steps>

### Create Recurring Schedule

<CodeGroup>
  ```json Request theme={null}
  {
    "paymentID": "customer-agreement-phrase",
    "amount": 1500,
    "currency": "NGN",
    "frequency": "monthly",
    "description": "Netflix Premium Subscription",
    "startDate": "2024-02-01"
  }
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.peere.network/v1/billing/recurring/create" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "paymentID": "customer-agreement-phrase",
      "amount": 1500,
      "currency": "NGN",
      "frequency": "monthly",
      "description": "Netflix Premium Subscription"
    }'
  ```
</CodeGroup>

### Manage Schedule

<CodeGroup>
  ```bash Pause Schedule theme={null}
  curl -X POST "https://api.peere.network/v1/recurring/{scheduleId}/pause" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```bash Resume Schedule theme={null}
  curl -X POST "https://api.peere.network/v1/recurring/{scheduleId}/resume" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```
</CodeGroup>

## Billing Frequencies

<CardGroup cols={4}>
  <Card title="Daily" icon="calendar-day">
    Every day
  </Card>

  <Card title="Weekly" icon="calendar-week">
    Every 7 days
  </Card>

  <Card title="Monthly" icon="calendar">
    Every 30 days
  </Card>

  <Card title="Custom" icon="clock">
    Custom intervals
  </Card>
</CardGroup>

## Use Cases

<Tabs>
  <Tab title="Subscription Services">Monthly or annual subscriptions for software, streaming, or membership services.</Tab>
  <Tab title="Utility Billing">Regular billing for utilities, rent, or other fixed recurring expenses.</Tab>
  <Tab title="Installment Payments">Break large purchases into smaller recurring payments over time.</Tab>
</Tabs>

<Warning>Customers must have approve\_recurring permission for automated billing. One time approvals (approve\_once) require manual billing for each transaction.</Warning>

## Schedule Management

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

## Next Steps

After setting up recurring billing:

1. [Transaction Management](/merchant-apis/transaction-management/overview) to monitor recurring payments
2. [Customer Decisions](/merchant-apis/customer-decisions/overview) to handle permission changes
3. [Refund Management](/merchant-apis/refund-management/overview) for subscription refunds