https://stripe.com/docs/api
When we make backwards-incompatiblechanges to the API, we release new, dated versions. The current version is 2018-09-24.
Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard. Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.
Authentication to the API is performed viaHTTP Basic Auth. Provide your API key as the basic auth username value. You do not need to provide a password.
All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.
Expanding Objects
Many objects contain the ID of a related object in their response properties. For example, a
Charge
may have an associated Customer
ID. Those objects can be expanded inline with the expand
request parameter. Objects that can be expanded are noted in this documentation. This parameter is available on all API requests, and applies to the response of that request only.
You can nest expand requests with the dot property. For example, requesting
invoice.customer
on a charge will expand the invoice
property into a full Invoice
object, and will then expand the customer
property on that invoice into a full Customer
object.
You can expand multiple objects at once by identifying multiple items in the
expand
array.When we make backwards-incompatiblechanges to the API, we release new, dated versions. The current version is 2018-09-24.