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

stripe / stripe-php / #7087

pending completion
#7087

push

php-coveralls

pakrym-stripe
Bump version to 10.14.0-beta.2

1831 of 2732 relevant lines covered (67.02%)

3.81 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 subscription by predefining expected changes.
9
 *
10
 * Related guide: <a href="https://stripe.com/docs/billing/subscriptions/subscription-schedules">Subscription schedules</a>
11
 *
12
 * @property string $id Unique identifier for the object.
13
 * @property string $object String representing the object's type. Objects of the same type share the same value.
14
 * @property null|string|\Stripe\StripeObject $application ID of the Connect Application that created the schedule.
15
 * @property null|\Stripe\StripeObject $applies_to
16
 * @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.
17
 * @property null|int $canceled_at Time at which the subscription schedule was canceled. Measured in seconds since the Unix epoch.
18
 * @property null|int $completed_at Time at which the subscription schedule was completed. Measured in seconds since the Unix epoch.
19
 * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
20
 * @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>.
21
 * @property string|\Stripe\Customer $customer ID of the customer who owns the subscription schedule.
22
 * @property \Stripe\StripeObject $default_settings
23
 * @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.
24
 * @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.
25
 * @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.
26
 * @property \Stripe\StripeObject[] $phases Configuration for the subscription schedule's phases.
27
 * @property null|\Stripe\StripeObject $prebilling Time period and invoice for a Subscription billed in advance.
28
 * @property null|int $released_at Time at which the subscription schedule was released. Measured in seconds since the Unix epoch.
29
 * @property null|string $released_subscription ID of the subscription once managed by the subscription schedule (if it is released).
30
 * @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>.
31
 * @property null|string|\Stripe\Subscription $subscription ID of the subscription managed by the subscription schedule.
32
 * @property null|string|\Stripe\TestHelpers\TestClock $test_clock ID of the test clock this subscription schedule belongs to.
33
 */
34
class SubscriptionSchedule extends ApiResource
35
{
36
    const OBJECT_NAME = 'subscription_schedule';
37

38
    use ApiOperations\All;
39
    use ApiOperations\Create;
40
    use ApiOperations\Retrieve;
41
    use ApiOperations\Update;
42

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

57
        return $this;
×
58
    }
59

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

74
        return $this;
1✔
75
    }
76

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

91
        return $this;
1✔
92
    }
93
}
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