Cycle Execution

August 21, 2026 ยท View on GitHub

The regular and trial execution details for a billing cycle.

Structure

CycleExecution

Fields

NameTypeTagsDescriptionGetterSetter
TenureTypeTenureTypeRequired, Read-onlyThe type of the billing cycle.

Constraints: Minimum Length: 1, Maximum Length: 24, Pattern: ^[A-Z_]+$
TenureType getTenureType()setTenureType(TenureType tenureType)
SequenceintRequiredThe order in which to run this cycle among other billing cycles.

Constraints: >= 0, <= 99
int getSequence()setSequence(int sequence)
CyclesCompletedintRequired, Read-onlyThe number of billing cycles that have completed.

Constraints: >= 0, <= 9999
int getCyclesCompleted()setCyclesCompleted(int cyclesCompleted)
CyclesRemainingIntegerOptional, Read-onlyFor a finite billing cycle, cycles_remaining is the number of remaining cycles. For an infinite billing cycle, cycles_remaining is set as 0.

Constraints: >= 0, <= 9999
Integer getCyclesRemaining()setCyclesRemaining(Integer cyclesRemaining)
CurrentPricingSchemeVersionIntegerOptional, Read-onlyThe active pricing scheme version for the billing cycle.

Constraints: >= 1, <= 99
Integer getCurrentPricingSchemeVersion()setCurrentPricingSchemeVersion(Integer currentPricingSchemeVersion)
TotalCyclesIntegerOptional, Read-onlyThe number of times this billing cycle gets executed. Trial billing cycles can only be executed a finite number of times (value between 1 and 999 for total_cycles). Regular billing cycles can be executed infinite times (value of 0 for total_cycles) or a finite number of times (value between 1 and 999 for total_cycles).

Constraints: >= 0, <= 999
Integer getTotalCycles()setTotalCycles(Integer totalCycles)

Example

import com.paypal.sdk.models.CycleExecution;

CycleExecution cycleExecution = new CycleExecution.Builder(
    null,
    99,
    0
)
.build();