diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION index 7dc2959341..b6eb47d27b 100644 --- a/OPENAPI_VERSION +++ b/OPENAPI_VERSION @@ -1 +1 @@ -v376 \ No newline at end of file +v384 \ No newline at end of file diff --git a/file.go b/file.go index 4b5e60a6c9..8da5d4de4e 100644 --- a/file.go +++ b/file.go @@ -47,12 +47,15 @@ type FileListParams struct { Purpose *string `form:"purpose"` } -// FileFileLinkDataParams is the set of parameters allowed for the -// file_link_data hash. +// Optional parameters to automatically create a [file link](https://stripe.com/docs/api#file_links) for the newly created file. type FileFileLinkDataParams struct { - Params `form:"*"` - Create *bool `form:"create"` + Params `form:"*"` + // Set this to `true` to create a file link for the newly created file. Creating a link is only possible when the file's `purpose` is one of the following: `business_icon`, `business_logo`, `customer_signature`, `dispute_evidence`, `pci_document`, `tax_document_user_upload`, or `terminal_reader_splashscreen`. + Create *bool `form:"create"` + // A future timestamp after which the link will no longer be usable. ExpiresAt *int64 `form:"expires_at"` + // Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Metadata map[string]string `form:"metadata"` } // To upload a file to Stripe, you'll need to send a request of type multipart/form-data. The request should contain the file you would like to upload, as well as the parameters for creating a file. @@ -60,14 +63,15 @@ type FileFileLinkDataParams struct { // All of Stripe's officially supported Client libraries should have support for sending multipart/form-data. type FileParams struct { Params `form:"*"` - // FileReader is a reader with the contents of the file that should be uploaded. FileReader io.Reader // Filename is just the name of the file without path information. - Filename *string - Purpose *string - FileLinkData *FileFileLinkDataParams + Filename *string + // Optional parameters to automatically create a [file link](https://stripe.com/docs/api#file_links) for the newly created file. + FileLinkData *FileFileLinkDataParams `form:"file_link_data"` + // The [purpose](https://stripe.com/docs/file-upload#uploading-a-file) of the uploaded file. + Purpose *string `form:"purpose"` } // This is an object representing a file hosted on Stripe's servers. The diff --git a/invoice.go b/invoice.go index 28fdf53a4d..e83b523bb7 100644 --- a/invoice.go +++ b/invoice.go @@ -597,7 +597,7 @@ type InvoiceParams struct { AccountTaxIDs []*string `form:"account_tax_ids"` // A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees [documentation](https://stripe.com/docs/billing/invoices/connect#collecting-fees). ApplicationFeeAmount *int64 `form:"application_fee_amount"` - // Controls whether Stripe will perform [automatic collection](https://stripe.com/docs/billing/invoices/workflow/#auto_advance) of the invoice. When `false`, the invoice's state will not automatically advance without an explicit action. + // Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. AutoAdvance *bool `form:"auto_advance"` // Settings for automatic tax lookup for this invoice. AutomaticTax *InvoiceAutomaticTaxParams `form:"automatic_tax"` @@ -669,7 +669,7 @@ type InvoicePayParams struct { // Stripe automatically finalizes drafts before sending and attempting payment on invoices. However, if you'd like to finalize a draft invoice manually, you can do so using this method. type InvoiceFinalizeInvoiceParams struct { Params `form:"*"` - // Controls whether Stripe will perform [automatic collection](https://stripe.com/docs/invoicing/automatic-charging) of the invoice. When `false`, the invoice's state will not automatically advance without an explicit action. + // Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. AutoAdvance *bool `form:"auto_advance"` } @@ -1165,7 +1165,7 @@ type InvoiceTransferData struct { // If your invoice is configured to be billed through automatic charges, // Stripe automatically finalizes your invoice and attempts payment. Note // that finalizing the invoice, -// [when automatic](https://stripe.com/docs/billing/invoices/workflow/#auto_advance), does +// [when automatic](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection), does // not happen immediately as the invoice is created. Stripe waits // until one hour after the last webhook was successfully sent (or the last // webhook timed out after failing). If you (and the platforms you may have @@ -1212,7 +1212,7 @@ type Invoice struct { AttemptCount int64 `json:"attempt_count"` // Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the `invoice.created` webhook, for example, so you might not want to display that invoice as unpaid to your users. Attempted bool `json:"attempted"` - // Controls whether Stripe will perform [automatic collection](https://stripe.com/docs/billing/invoices/workflow/#auto_advance) of the invoice. When `false`, the invoice's state will not automatically advance without an explicit action. + // Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. AutoAdvance bool `json:"auto_advance"` AutomaticTax *InvoiceAutomaticTax `json:"automatic_tax"` // Indicates the reason why the invoice was created. `subscription_cycle` indicates an invoice created by a subscription advancing into a new period. `subscription_create` indicates an invoice created due to creating a subscription. `subscription_update` indicates an invoice created due to updating a subscription. `subscription` is set for all old invoices to indicate either a change to a subscription or a period advancement. `manual` is set for all invoices unrelated to a subscription (for example: created via the invoice editor). The `upcoming` value is reserved for simulated invoices per the upcoming invoice endpoint. `subscription_threshold` indicates an invoice created due to a billing threshold being reached. diff --git a/issuing_authorization.go b/issuing_authorization.go index 4fb7dbc602..b0870c4ea3 100644 --- a/issuing_authorization.go +++ b/issuing_authorization.go @@ -92,7 +92,7 @@ type IssuingAuthorizationParams struct { } // Approves a pending Issuing Authorization object. This request should be made within the timeout window of the [real-time authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations) flow. -// You can also respond directly to the webhook request to approve an authorization (preferred). More details can be found [here](https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling). +// You can also respond directly to the webhook request to approve an authorization (preferred). More details can be found [here](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling). type IssuingAuthorizationApproveParams struct { Params `form:"*"` // If the authorization's `pending_request.is_amount_controllable` property is `true`, you may provide this value to control how much to hold for the authorization. Must be positive (use [`decline`](https://stripe.com/docs/api/issuing/authorizations/decline) to decline an authorization request). @@ -100,7 +100,7 @@ type IssuingAuthorizationApproveParams struct { } // Declines a pending Issuing Authorization object. This request should be made within the timeout window of the [real time authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations) flow. -// You can also respond directly to the webhook request to decline an authorization (preferred). More details can be found [here](https://site-admin.stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling). +// You can also respond directly to the webhook request to decline an authorization (preferred). More details can be found [here](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling). type IssuingAuthorizationDeclineParams struct { Params `form:"*"` } diff --git a/issuing_card.go b/issuing_card.go index d0260de29d..ad347c70fe 100644 --- a/issuing_card.go +++ b/issuing_card.go @@ -224,7 +224,7 @@ type IssuingCardPINParams struct { // Additional information that may be required for clearing customs. type IssuingCardShippingCustoms struct { - // A registration number used for customs in Europe. See https://www.gov.uk/eori and https://ec.europa.eu/taxation_customs/business/customs-procedures-import-and-export/customs-procedures/economic-operators-registration-and-identification-number-eori_en. + // A registration number used for customs in Europe. See [https://www.gov.uk/eori](https://www.gov.uk/eori) for the UK and [https://ec.europa.eu/taxation_customs/business/customs-procedures-import-and-export/customs-procedures/economic-operators-registration-and-identification-number-eori_en](https://ec.europa.eu/taxation_customs/business/customs-procedures-import-and-export/customs-procedures/economic-operators-registration-and-identification-number-eori_en) for the EU. EORINumber string `json:"eori_number"` } diff --git a/paymentintent.go b/paymentintent.go index 9720a4a60b..fdd962d473 100644 --- a/paymentintent.go +++ b/paymentintent.go @@ -1708,7 +1708,8 @@ type PaymentIntentConfirmRadarOptionsParams struct { // If the selected payment method requires additional authentication steps, the // PaymentIntent will transition to the requires_action status and // suggest additional actions via next_action. If payment fails, -// the PaymentIntent will transition to the requires_payment_method status. If +// the PaymentIntent transitions to the requires_payment_method status or the +// canceled status if the confirmation limit is reached. If // payment succeeds, the PaymentIntent will transition to the succeeded // status (or requires_capture, if capture_method is set to manual). // If the confirmation_method is automatic, payment may be attempted diff --git a/setupintent.go b/setupintent.go index 8b81e99d3c..11df2fdcfb 100644 --- a/setupintent.go +++ b/setupintent.go @@ -971,7 +971,8 @@ type SetupIntentConfirmPaymentMethodDataParams struct { // Otherwise, it will transition to the requires_action status and // suggest additional actions via next_action. If setup fails, // the SetupIntent will transition to the -// requires_payment_method status. +// requires_payment_method status or the canceled status if the +// confirmation limit is reached. type SetupIntentConfirmParams struct { Params `form:"*"` // This hash contains details about the Mandate to create