> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.payroc.com/llms.txt.
> For full documentation content, see https://docs.payroc.com/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.payroc.com/_mcp/server.

# Payment Plans

> **Important:** Our solution for repeat payments is very flexible and uses the Payment Plans, Secure Tokens, and Subscriptions endpoints. To help you understand how it works, we recommend that you go to [Repeat Payments](/guides/take-payments/repeat-payments).

Use our Payment Plans endpoints to create payment schedules that you can later assign customers to using our Subscriptions endpoints. A payment plan includes information about:

* How often our gateway collects a payment.
* How many payments our gateway collects.
* How much our gateway collects for each payment.

When you [create a payment plan](/api/schema/repeat-payments/payment-plans/create), you generate and include a paymentPlanId that you use to complete follow-on actions:

* [Retrieve the payment plan](/api/schema/repeat-payments/payment-plans/retrieve) - View the details of a payment plan. If you don't have the paymentPlanId you can use our [List Payment Plans](/api/schema/repeat-payments/payment-plans/list) method.
* [Update the payment plan](/api/schema/payments/payment-plans/update) - Update the details of a payment plan, including the frequency or amount.
* [Delete the payment plan](/api/schema/repeat-payments/payment-plans/delete) - Delete the payment plan.

After you create the payment plan, use the [Subscriptions endpoint](/api/schema/payments/subscriptions/overview) to assign customers to the payment plan.