# Recurring

Recurring payments are used to charge customers on a regular basis. MoneyCollect now supports merchants to initiate recurring payments through our powerful API, in which way to facilitate your customers with an easy first payment and then ready to collect payments recurrently without any effort.

To reduce the risk of chargebacks, it’s recommended to communicate how often and how much the customer will be charged as clearly as possible. We suggest notifying the customer a couple of days in advance of the next payment, for example by sending them an email.

### Initial payment

Intial payment is the first transaction of a rebilling cycle. In order to get started with recurring payments you need to require the customer’s consent through the initial payment.

<div align="left"><figure><img src="https://3906929740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQyT5pndc80PGeNrMulEU%2Fuploads%2FDrJpgLYdy8k5QAYanyfo%2Fimage.png?alt=media&#x26;token=bcfc6efa-a974-436d-bc9a-6ad7740211ab" alt=""><figcaption></figcaption></figure></div>

Merchants can start a recurring transaction through [create payment api](https://apireference.moneycollect.com/docs/api-v1/7f574d73b54f4-create-a-payment).For the initial transaction of a rebilling cycle, <mark style="color:blue;">`initial`</mark> must be set to `true`, <mark style="color:blue;">`relationPaymentId`</mark> must be `null`, and <mark style="color:blue;">`setupFutureUsage`</mark> must be set to `on`.

{% hint style="info" %}
For the initial payment, cutomers need to complete [<mark style="color:blue;">3D Secure authentication</mark>](https://docs.moneycollect.com/docs/payment/3d-secure-authentication) process to prevent fraud.
{% endhint %}

### Rebill  payment

Rebill payment is the subsequent transaction of a rebilling cycle.

<div align="left"><figure><img src="https://3906929740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQyT5pndc80PGeNrMulEU%2Fuploads%2F9lMys9LzFTcOwIY2MWg1%2Fimage.png?alt=media&#x26;token=f8e4c87c-58c5-4f30-a14a-2f64c04fa41a" alt=""><figcaption></figcaption></figure></div>

For the subsequent transaction of a rebilling cycle, the <mark style="color:blue;">`initial`</mark> can be `null` or set to be `false` , the <mark style="color:blue;">`relationPaymentId`</mark> must be the `Payment ID`of its initial payment, and <mark style="color:blue;">`setupFutureUsage`</mark> must be set to `on`.

{% hint style="info" %}
Recurring payment are not available for visitors, that is to say, the<mark style="color:blue;">`customerID`</mark>cannot be `null`in recurring payments for both initial payment and rebill  payment.

[Create a customer](https://apireference.moneycollect.com/docs/api-v1/54da7edbbe496-create-a-customer) for your shopper,then associate the returned `customerId` with the membership identifier in your system.
{% endhint %}

### MoneyCollect dashboard

MoneyCollect enables merchants to view their existing recurring payments from MoneyCollect Dashboard.

1. Navigate to <mark style="color:purple;">`Payments`</mark> page in your Dashboard，and click <mark style="color:purple;">`Edit view`</mark>.
2. Tick <mark style="color:purple;">`Description`</mark>.
3. You can tell from  <mark style="color:purple;">`Description`</mark> which are initial payments and which are rebill payments.
4. Select one of payments to <mark style="color:purple;">`Payment details`</mark> page.
5. In<mark style="color:purple;">`Payment details`</mark> page, you can also tell from  <mark style="color:purple;">`Description`</mark> if this is an initial payment or a rebill payment.

![](https://3906929740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQyT5pndc80PGeNrMulEU%2Fuploads%2FOvnRQFii6gjgCeCKhGgR%2FJG7%60CM%5B0X\(G_\)%25%7DAN%25C%7B_%602.png?alt=media\&token=bdaff363-4f15-4327-906a-018213cce216)

![](https://3906929740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQyT5pndc80PGeNrMulEU%2Fuploads%2F5DIE4gd0TadYSqyIHmpg%2F78V6HJMT46T%40%40N0_W8KF%7BF5.png?alt=media\&token=11d66704-b460-414d-bf23-1f5c70e56354)

![Initial payment](https://3906929740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQyT5pndc80PGeNrMulEU%2Fuploads%2FvQlu8HHx2UzByBxUQbaf%2Fimage.png?alt=media\&token=20db14a4-e251-4502-980a-264bebc5dfb7)

![Rebill payment](https://3906929740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQyT5pndc80PGeNrMulEU%2Fuploads%2FKn3VzoyVqBcRsHBsq3B3%2FOA%5BX\(M\)6PN6G3%7BQ__DUMKD3.png?alt=media\&token=d1c769f7-ef51-48fc-8d8a-da507d895dff)

### Zero-Amount Authorization + Recurring Use Case

In certain **Recurring (subscription / periodic payment)** scenarios, you may need to perform an initial card validation (such as triggering a 3D Secure authentication or verifying card viability) without actually charging the card. In these cases, you can use a **Zero-Amount Authorization + Recurring** flow.

This flow enables you to initiate the first transaction with an amount of **0**, solely to validate the payment method and cardholder authentication. After successful authorization, subsequent recurring charges proceed normally under the standard recurring mechanism.

#### Overview of the Use Case

* When the first transaction is intended for card validation or to trigger a cardholder authentication (e.g., 3D Secure) but no actual amount is to be charged, a **zero-amount authorization** can be utilized.
* Once card verification succeeds, the payment method can be used for subsequent periodic charges as defined by the recurring schedule.

#### Permission and Activation

* **Zero-amount authorization is not enabled by default.** Merchants must contact their MoneyCollect account manager to request activation of this capability.
* After activation, merchant systems can submit a recurring subscription request where the **first transaction amount is set to `0`** for authorization and validation without capturing funds.

#### Request Example (Zero Amount Authorization)

When creating the initial recurring transaction, set the transaction field <mark style="color:$primary;">`amount`</mark> to **0** to indicate that this is an authorization request rather than a charge.the <mark style="color:blue;">`setupFutureUsage`</mark> must be set to `on`.

<figure><img src="https://3906929740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQyT5pndc80PGeNrMulEU%2Fuploads%2F5z54Z7JyBjVVGU31JIYm%2Fimage.png?alt=media&#x26;token=e31c04ff-93d0-46bd-920c-2cf3e4f452e4" alt=""><figcaption></figcaption></figure>

#### Subsequent Recurring Charge Logic

After the zero-amount authorization completes successfully (including cardholder authentication such as 3D Secure where required), the subsequent recurring charges follow the **same flow and parameter requirements** as a standard recurring subscription.
