Billing Cycle

The billing cycle providing details of the billing frequency, amount, duration and if the billing cycle is a free, discounted or regular billing cycle. The sequence of the billing cycle will be in the following order - free trial billing cycle(s), discounted trial billing cycle(s), regular billing cycle(s).

Structure

BillingCycle

Fields

Name	Type	Tags	Description	Getter	Setter
TenureType	TenureType	Required	The tenure type of the billing cycle identifies if the billing cycle is a trial(free or discounted) or regular billing cycle. Constraints: Minimum Length: 1, Maximum Length: 24, Pattern: ^[A-Z_]+$	TenureType getTenureType()	setTenureType(TenureType tenureType)
PricingScheme	PricingScheme	Optional	The pricing scheme details.	PricingScheme getPricingScheme()	setPricingScheme(PricingScheme pricingScheme)
TotalCycles	Integer	Optional	The 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). Default: 1 Constraints: >= 0, <= 999	Integer getTotalCycles()	setTotalCycles(Integer totalCycles)
Sequence	Integer	Optional	The order in which this cycle is to run among other billing cycles. For example, a trial billing cycle has a sequence of 1 while a regular billing cycle has a sequence of 2, so that trial cycle runs before the regular cycle. Default: 1 Constraints: >= 1, <= 3	Integer getSequence()	setSequence(Integer sequence)
StartDate	String	Optional	The stand-alone date, in Internet date and time format. To represent special legal values, such as a date of birth, you should use dates with no associated time or time-zone data. Whenever possible, use the standard date_time type. This regular expression does not validate all dates. For example, February 31 is valid and nothing is known about leap years. Constraints: Minimum Length: 10, Maximum Length: 10, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$	String getStartDate()	setStartDate(String startDate)
Frequency	CycleFrequency	Optional	The frequency of the terms reset cycle.	CycleFrequency getFrequency()	setFrequency(CycleFrequency frequency)

Example

import com.paypal.sdk.models.BillingCycle;
import com.paypal.sdk.models.CycleFrequency;
import com.paypal.sdk.models.FrequencyIntervalUnit;
import com.paypal.sdk.models.Money;
import com.paypal.sdk.models.PricingModel;
import com.paypal.sdk.models.PricingScheme;
import com.paypal.sdk.models.TenureType;

BillingCycle billingCycle = new BillingCycle.Builder(
    TenureType.REGULAR
)
.pricingScheme(new PricingScheme.Builder(
        PricingModel.AUTO_RELOAD
    )
    .price(new Money.Builder(
            "currency_code8",
            "value4"
        )
        .build())
    .reloadThresholdAmount(new Money.Builder(
            "currency_code0",
            "value6"
        )
        .build())
    .build())
.totalCycles(1)
.sequence(1)
.startDate("start_date8")
.frequency(new CycleFrequency.Builder(
        FrequencyIntervalUnit.LIFETIME
    )
    .intervalCount(94)
    .build())
.build();