API Updates

checkout/session/client.go

@@ -52,6 +52,19 @@ func (c Client) Get(id string, params *stripe.CheckoutSessionParams) (*stripe.Ch
 	return session, err
 }
 
+// Expire is the method for the `POST /v1/checkout/sessions/{session}/expire` API.
+func Expire(id string, params *stripe.CheckoutSessionExpireParams) (*stripe.CheckoutSession, error) {
+	return getC().Expire(id, params)
+}
+
+// Expire is the method for the `POST /v1/checkout/sessions/{session}/expire` API.
+func (c Client) Expire(id string, params *stripe.CheckoutSessionExpireParams) (*stripe.CheckoutSession, error) {
+	path := stripe.FormatURLPath("/v1/checkout/sessions/%s/expire", id)
+	session := &stripe.CheckoutSession{}
+	err := c.B.Call(http.MethodPost, path, c.Key, params, session)
+	return session, err
+}
+
 // List returns a list of checkout sessions.
 func List(params *stripe.CheckoutSessionListParams) *Iter {
 	return getC().List(params)

checkout_session.go

@@ -163,6 +163,16 @@ const (
 	CheckoutSessionPaymentStatusUnpaid            CheckoutSessionPaymentStatus = "unpaid"
 )
 
+// The status of the Checkout Session, one of `open`, `complete`, or `expired`.
+type CheckoutSessionStatus string
+
+// List of values that CheckoutSessionStatus can take
+const (
+	CheckoutSessionStatusComplete CheckoutSessionStatus = "complete"
+	CheckoutSessionStatusExpired  CheckoutSessionStatus = "expired"
+	CheckoutSessionStatusOpen     CheckoutSessionStatus = "open"
+)
+
 // CheckoutSessionSubmitType is the list of allowed values for the submit type on  a Session.
 type CheckoutSessionSubmitType string
 
@@ -420,6 +430,13 @@ type CheckoutSessionParams struct {
 	TaxIDCollection           *CheckoutSessionTaxIDCollectionParams           `form:"tax_id_collection"`
 }
 
+// A Session can be expired when it is in one of these statuses: open
+//
+// After it expires, a customer can't complete a Session and customers loading the Session see a message saying the Session is expired.
+type CheckoutSessionExpireParams struct {
+	Params `form:"*"`
+}
+
 // CheckoutSessionListLineItemsParams is the set of parameters that can be
 // used when listing line items on a session.
 type CheckoutSessionListLineItemsParams struct {
@@ -587,6 +604,7 @@ type CheckoutSession struct {
 	SetupIntent               *SetupIntent                              `json:"setup_intent"`
 	Shipping                  *ShippingDetails                          `json:"shipping"`
 	ShippingAddressCollection *CheckoutSessionShippingAddressCollection `json:"shipping_address_collection"`
+	Status                    CheckoutSessionStatus                     `json:"status"`
 	SubmitType                CheckoutSessionSubmitType                 `json:"submit_type"`
 	Subscription              *Subscription                             `json:"subscription"`
 	SuccessURL                string                                    `json:"success_url"`

example/generated_examples_test.go

@@ -1492,3 +1492,9 @@ func TestCustomerListPaymentMethods(t *testing.T) {
 	result := customer.ListPaymentMethods(params)
 	assert.NotNil(t, result)
 }
+
+func TestCheckoutSessionExpire(t *testing.T) {
+	params := &stripe.CheckoutSessionExpireParams{}
+	result, _ := checkout_session.Expire("sess_xyz", params)
+	assert.NotNil(t, result)
+}