• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

stripe / stripe-php / #6995

pending completion
#6995

push

php-coveralls

richardm-stripe
Bump version to 10.13.0-beta.2

1802 of 2668 relevant lines covered (67.54%)

3.75 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

66.67
/lib/SubscriptionSchedule.php
1
<?php
2

3
// File generated from our OpenAPI spec
4

5
namespace Stripe;
6

7
/**
8
 * A subscription schedule allows you to create and manage the lifecycle of a
9
 * subscription by predefining expected changes.
10
 *
11
 * Related guide: <a
12
 * href="https://stripe.com/docs/billing/subscriptions/subscription-schedules">Subscription
13
 * Schedules</a>.
14
 *
15
 * @property string $id Unique identifier for the object.
16
 * @property string $object String representing the object's type. Objects of the same type share the same value.
17
 * @property null|string|\Stripe\StripeObject $application ID of the Connect Application that created the schedule.
18
 * @property null|\Stripe\StripeObject $applies_to
19
 * @property null|string $billing_behavior Configures when the subscription schedule generates prorations for phase transitions. Possible values are <code>prorate_on_next_phase</code> or <code>prorate_up_front</code> with the default being <code>prorate_on_next_phase</code>. <code>prorate_on_next_phase</code> will apply phase changes and generate prorations at transition time.<code>prorate_up_front</code> will bill for all phases within the current billing cycle up front.
20
 * @property null|int $canceled_at Time at which the subscription schedule was canceled. Measured in seconds since the Unix epoch.
21
 * @property null|int $completed_at Time at which the subscription schedule was completed. Measured in seconds since the Unix epoch.
22
 * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
23
 * @property null|\Stripe\StripeObject $current_phase Object representing the start and end dates for the current phase of the subscription schedule, if it is <code>active</code>.
24
 * @property string|\Stripe\Customer $customer ID of the customer who owns the subscription schedule.
25
 * @property \Stripe\StripeObject $default_settings
26
 * @property string $end_behavior Behavior of the subscription schedule and underlying subscription when it ends. Possible values are <code>release</code> or <code>cancel</code> with the default being <code>release</code>. <code>release</code> will end the subscription schedule and keep the underlying subscription running.<code>cancel</code> will end the subscription schedule and cancel the underlying subscription.
27
 * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
28
 * @property null|\Stripe\StripeObject $metadata Set of <a href="https://stripe.com/docs/api/metadata">key-value pairs</a> that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
29
 * @property \Stripe\StripeObject[] $phases Configuration for the subscription schedule's phases.
30
 * @property null|\Stripe\StripeObject $prebilling Time period and invoice for a Subscription billed in advance.
31
 * @property null|int $released_at Time at which the subscription schedule was released. Measured in seconds since the Unix epoch.
32
 * @property null|string $released_subscription ID of the subscription once managed by the subscription schedule (if it is released).
33
 * @property string $status The present status of the subscription schedule. Possible values are <code>not_started</code>, <code>active</code>, <code>completed</code>, <code>released</code>, and <code>canceled</code>. You can read more about the different states in our <a href="https://stripe.com/docs/billing/subscriptions/subscription-schedules">behavior guide</a>.
34
 * @property null|string|\Stripe\Subscription $subscription ID of the subscription managed by the subscription schedule.
35
 * @property null|string|\Stripe\TestHelpers\TestClock $test_clock ID of the test clock this subscription schedule belongs to.
36
 */
37
class SubscriptionSchedule extends ApiResource
38
{
39
    const OBJECT_NAME = 'subscription_schedule';
40

41
    use ApiOperations\All;
42
    use ApiOperations\Create;
43
    use ApiOperations\Retrieve;
44
    use ApiOperations\Update;
45

46
    /**
47
     * @param null|array $params
48
     * @param null|array|string $opts
49
     *
50
     * @throws \Stripe\Exception\ApiErrorException if the request fails
51
     *
52
     * @return \Stripe\SubscriptionSchedule the amended subscription schedule
53
     */
54
    public function amend($params = null, $opts = null)
55
    {
56
        $url = $this->instanceUrl() . '/amend';
×
57
        list($response, $opts) = $this->_request('post', $url, $params, $opts);
×
58
        $this->refreshFrom($response, $opts);
×
59

60
        return $this;
×
61
    }
62

63
    /**
64
     * @param null|array $params
65
     * @param null|array|string $opts
66
     *
67
     * @throws \Stripe\Exception\ApiErrorException if the request fails
68
     *
69
     * @return \Stripe\SubscriptionSchedule the canceled subscription schedule
70
     */
71
    public function cancel($params = null, $opts = null)
72
    {
73
        $url = $this->instanceUrl() . '/cancel';
1✔
74
        list($response, $opts) = $this->_request('post', $url, $params, $opts);
1✔
75
        $this->refreshFrom($response, $opts);
1✔
76

77
        return $this;
1✔
78
    }
79

80
    /**
81
     * @param null|array $params
82
     * @param null|array|string $opts
83
     *
84
     * @throws \Stripe\Exception\ApiErrorException if the request fails
85
     *
86
     * @return \Stripe\SubscriptionSchedule the released subscription schedule
87
     */
88
    public function release($params = null, $opts = null)
89
    {
90
        $url = $this->instanceUrl() . '/release';
1✔
91
        list($response, $opts) = $this->_request('post', $url, $params, $opts);
1✔
92
        $this->refreshFrom($response, $opts);
1✔
93

94
        return $this;
1✔
95
    }
96
}
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc