# Recurring Payments

Build subscription and scheduled payment experiences.

Recurring payments allow you to automatically initiate payments on a defined schedule without requiring a new payment request for each occurrence.

Use recurring payments to:

- Collect subscription fees
- Process membership dues
- Automate recurring invoice payments
- Schedule periodic transfers
- Support installment payment plans
- Create and manage payment schedules
- Pause and resume scheduled payments
- Update recurring payment details
- Cancel recurring payment schedules


Recurring payments provide developers with the flexibility to automate repeat payment workflows while managing schedules as customer or business requirements change. Payment schedules can be created, updated, paused, resumed, or canceled throughout the recurring payment lifecycle.

### Why Use Recurring Payments?

Recurring payments help reduce operational overhead by automating payment processing.

| Use Case | Example |
|  --- | --- |
| Subscriptions | Monthly software billing |
| Memberships | Annual association dues |
| Installments | Loan repayment schedules |
| Utilities | Scheduled bill collection |
| Service Contracts | Recurring maintenance fees |


### Prerequisites

Before creating a recurring payment schedule, ensure that:

- Payment initiation capabilities have been integrated.
- The payer's payment method supports recurring transactions.
- Required payment authorization has been obtained.
- Your application can receive webhook notifications for payment events.
- Appropriate credentials are configured for your environment.


### How It Works

The recurring payment workflow shows how a payment schedule is created and activated, allowing payments to execute automatically according to the configured schedule. Each payment is processed and produces a success or failure notification. The schedule can continue recurring and can be updated, paused, resumed, or canceled as needed.

**Create Schedule**
Configure the payment frequency and execution rules.

**Activate Schedule**
Enable the schedule to begin recurring payments.

**Execute Scheduled Payment**
The payment executes automatically when the configured schedule rules are met.

**Process Payment**
Process the scheduled payment.

**Receive Success or Failure Notification**
Receive a notification indicating the outcome of the payment.

**Continue Schedule**
Continue the recurring payment schedule. Update, pause, resume, or cancel the schedule as needed before subsequent scheduled payments are processed.

For request and response schemas, see

Recurring Payments API →


### Schedule Configuration

Recurring schedules typically define:

| Attribute | Description |
|  --- | --- |
| Frequency | How often payments occur |
| Start Date | First scheduled payment date |
| End Date | Optional schedule expiration date |
| Amount | Payment amount |
| Currency | Payment currency |
| Maximum Occurrences | Optional payment limit |
| Payment Method | Funding source used for payments |
| Status | Active, Paused, or Cancelled |


#### Supported Frequencies

Typical schedule frequencies include:

- Daily
- Weekly
- Biweekly
- Monthly
- Quarterly
- Annually


Supported frequencies may vary by payment type and processor implementation.

### Schedule Statuses

| Status | Description |
|  --- | --- |
| Active | Payments execute automatically according to the configured schedule. |
| Paused | Future scheduled payments are temporarily suspended. |
| Cancelled | Future scheduled payments are permanently stopped. |


### Manage a Schedule

Recurring payment schedules can be managed throughout their lifecycle.

| Action | Purpose |
|  --- | --- |
| Create | Create a new recurring payment schedule. |
| Retrieve | View schedule details and execution status. |
| Update | Modify future payment executions. |
| Pause | Temporarily stop future executions. |
| Resume | Reactivate a paused schedule. |
| Cancel | Permanently stop future scheduled payments. |


For request and response schemas, see Subscriptions API →

Updates commonly include:

- Payment amount
- Frequency
- End date
- Description
- Payment method


Changes apply to future scheduled executions and do not modify payments that have already been processed.

### Payment Notifications

Webhooks can be used to track recurring payment activity and schedule lifecycle events.

| Event | Description |
|  --- | --- |
| `schedule.created` | Schedule successfully created |
| `schedule.updated` | Schedule modified |
| `schedule.paused` | Schedule paused |
| `schedule.resumed` | Schedule resumed |
| `schedule.cancelled` | Schedule cancelled |
| `payment.executed` | Scheduled payment processed |
| `payment.failed` | Scheduled payment failed |


Webhook notifications provide the most reliable method for monitoring recurring payment activity.

### Troubleshooting

#### Scheduled Payment Did Not Execute

Verify that:

- The schedule status is Active.
- The payment method is valid.
- Required authorization is still active.
- No account restrictions exist.


#### Schedule Update Not Reflected

Verify that:

- The update request completed successfully.
- Changes apply only to future executions.
- The schedule has not been cancelled.


#### Repeated Payment Failures

Review:

- Payment method status
- Authorization expiration
- Account funding availability
- Failure details returned by webhook events


### Best Practices

#### Use Idempotency

Use idempotent requests when creating schedules to prevent duplicate recurring payment configurations.

#### Subscribe to Webhooks

Webhook notifications provide the most reliable method for tracking schedule activity and payment execution outcomes.

#### Monitor Failures

Implement automated handling for failed payments and retry workflows when supported.

#### Provide Customer Controls

Allow customers to:

- View schedules
- Update schedules
- Pause schedules
- Cancel schedules


Providing visibility and control helps reduce support requests and improves the customer experience.

### Related Resources

Payment Methods
Learn which payment methods support recurring payment schedules.

Vault
Store payment methods securely for future recurring payment execution.

Transaction Types
Understand payment lifecycle concepts including purchase, authorization, capture, and refund.