pause-subscription-request.md

Pause Subscription Request

Defines input parameters in a request to the PauseSubscription endpoint.

Structure

Pause Subscription Request

Fields

Name	Type	Tags	Description
pause_effective_date	str	Optional	The YYYY-MM-DD-formatted date when the scheduled PAUSE action takes place on the subscription. When this date is unspecified or falls within the current billing cycle, the subscription is paused on the starting date of the next billing cycle.
pause_cycle_duration	long|int	Optional	The number of billing cycles the subscription will be paused before it is reactivated. When this is set, a RESUME action is also scheduled to take place on the subscription at the end of the specified pause cycle duration. In this case, neither resume_effective_date nor resume_change_timing may be specified.
resume_effective_date	str	Optional	The date when the subscription is reactivated by a scheduled RESUME action. This date must be at least one billing cycle ahead of pause_effective_date.
resume_change_timing	str (Change Timing)	Optional	Supported timings when a pending change, as an action, takes place to a subscription.
pause_reason	str	Optional	The user-provided reason to pause the subscription. Constraints: Maximum Length: 255

Example (as JSON)

{
  "pause_effective_date": "pause_effective_date2",
  "pause_cycle_duration": 98,
  "resume_effective_date": "resume_effective_date0",
  "resume_change_timing": "IMMEDIATE",
  "pause_reason": "pause_reason6"
}