---
title: "Trigger fund rollover"
method: POST
path: "/v1/ppdd/rollover"
tags: ["Prepaid with Drawdown"]
---

# Trigger fund rollover

`POST /v1/ppdd/rollover`

Prepaid with Drawdown Rollover enables you to transfer the accumulative carryover of your customers’ prepaid balance funds to the following validity period when using Prepaid with Drawdown. This REST API reference describes how to manually trigger fund rollover from source validity period to destination validity period. There are no path or query parameters.

**Note**: This API will not work if rollover is enabled in the associated prepayment charge. If you want to trigger rollover automatically, see <a href="https://docs.zuora.com/en/zuora-billing/bill-your-customer/usage-billing/prepaid-with-drawdown/create-prepayment-charge-with-rollover" target="_blank">Create prepayment charge with rollover</a> for more information.

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string
- `Zuora-Version` string

## Request body

- POSTTriggerRolloverRequestType
  - `destinationValidityPeriod` DestinationValidityPeriodInfo, required — Date range of the destination validity period to which the funds are transferred. It should be close to the source validity period.
    - `endDate` string, date, required — End date of the destination validity period.
    - `startDate` string, date, required — Start date of the destination validity period.
  - `prepaymentUom` string, required — Specifies the units of measure for prepayment charge. Units of measure are configured in the web-based UI. Your values depend on your configuration in **Billing Settings**. **Values**: a valid unit of measure
  - `priority` string, required — Specifies the priority of rolled over fund in case of drawdown. **Values**: ApplyLast / ApplyFirst
  - `sourceValidityPeriod` SourceValidityPeriodInfo, required — Date range of the source validity period from which the funds are transferred. It should be close to the destination validity period.
    - `endDate` string, date, required — End date of the source validity period.
    - `startDate` string, date, required — Start date of the source validity period.
  - `subscriptionNumber` string, required — The unique identifier number of the subscription.

## Response `200`

OK

- POSTTriggerRolloverResponseType
  - `message` string — Indicates the result.
  - `rolloverFundCount` integer — Indicates the number of funds which have been rolled over.
  - `success` boolean — Indicates whether the call succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)