> For the complete documentation index, see [llms.txt](https://docs.xplorpay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xplorpay.com/quick-starts/recurring-payments.md).

# Recurring Payments

The **Recurring Payments** engine securely stores customer information, including e-mail address, billing address, first name, and last name.

The [Recurring Payments Service](/api-reference/api/payments/recurring-payments-service.md) allows you to:

* Create customers and customer tokens for future payment process.
* Schedule payment plans at various frequencies.
* Automatically process payments according to the defined schedule.

### Prerequisites

To process recurring payments, ensure you have following:

✅ An active Xplor Pay account.

{% hint style="info" %}
Contact to [Xplor Pay](https://xplorpay.com/contact/) to create an active account.
{% endhint %}

✅ API access key issued to you by Xplor Pay.

{% hint style="info" %}
Visit [Let's Get Started - Xplor Pay](https://xplorpay.com/getting-started/) to get API access key.
{% endhint %}

{% stepper %}
{% step %}

### Create customer

To create a customer:

1. Use the POST method.
2. Send the customer request to the [Customer](/api-reference/api/payments/recurring-payments-service/customer.md) endpoint with required fields.

The success response returns the customer key in the `customer-key` field.
{% endstep %}

{% step %}

### Create customer token

To create a customer token:

1. Use the POST method.
2. Include the `customer-key` in the request header for authentication.

See the `customer-key` field in the successful response from the create customer endpoint.

3. Send the request to the [Customer Token](/api-reference/api/payments/recurring-payments-service/customer-token.md) URL with required fields.

The success response returns the customer payment token and card details.
{% endstep %}

{% step %}

### Create payment plan

To create a payment plan:

1. Use the POST method.
2. Send the request to the [Payment Plans](/api-reference/api/payments/recurring-payments-service/payment-plans.md) endpoint URL with required fields.

The success response returns the `plan-key` for specified date range payment frequency that confirm the payment plan is created and activated for the customer.

{% hint style="info" %}
See [Recurring Payments Service](/api-reference/api/payments/recurring-payments-service.md) for more information.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xplorpay.com/quick-starts/recurring-payments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.