The structure of objects sent to your webhook endpoints (both Account and Connect ones.) If an endpoint has an explicit version set, it will remain unaffected.The structure of objects received with Stripe.js methods such as confirmCardPayment.The API calls you make without a Stripe-Version header: the parameters you can send and the structure of objects returned.If you’re running an older version of the API, upgrade to the latest version to take advantage of new functionality or to streamline responses so the API is faster for you. Your webhook listener should gracefully handle unfamiliar event types. If for example you’re using MySQL, you should store IDs in a VARCHAR(255) COLLATE utf8_bin column (the COLLATE configuration ensures case-sensitivity in lookups). You can safely assume object IDs we generate will never exceed 255 characters, but you should be able to handle IDs of up to that length. This includes adding or removing fixed prefixes (such as ch_ on charge IDs). Stripe considers the following changes to be backwards-compatible:Īdding new optional request parameters to existing API methods.Īdding new properties to existing API responses.Ĭhanging the order of properties in existing API responses.Ĭhanging the length or format of opaque strings, such as object IDs, error messages, and other human-readable strings. If you make requests on behalf of other users using Connect, we’ll use your application’s API version, making it easy for you to write code that works for all your users no matter what API versions they’re individually running. To avoid breaking your code, we don’t change your version until you’re ready to upgrade. When a breaking change is introduced to the Stripe API, a new dated version is released. Your version gets set the first time you make an API request. Your API version controls the API and webhook behavior you see (for example, what properties you see in responses, what parameters you’re permitted to send in requests, and so on).
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |