Updates the webhook endpoint. You may edit the url, the list of enabled_, and the status of your endpoint.
Parameters
- descriptionstring
An optional description of what the webhook is used for.
- enabled_
eventsarray of enums The list of events to enable for this endpoint. You may specify
['*']to enable all events, except those that require explicit selection.Possible enum valuesaccount.application. authorized Occurs whenever a user authorizes an application. Sent to the related application only.
account.application. deauthorized Occurs whenever a user deauthorizes an application. Sent to the related application only.
account.external_ account. created Occurs whenever an external account is created.
account.external_ account. deleted Occurs whenever an external account is deleted.
account.external_ account. updated Occurs whenever an external account is updated.
account.updated Occurs whenever an account status or property has changed.
application_fee. created Occurs whenever an application fee is created on a charge.
application_fee. refund. updated Occurs whenever an application fee refund is updated.
application_fee. refunded Occurs whenever an application fee is refunded, whether from refunding a charge or from refunding the application fee directly. This includes partial refunds.
balance.available Occurs whenever your Stripe balance has been updated (e.g., when a charge is available to be paid out). By default, Stripe automatically transfers funds in your balance to your bank account on a daily basis. This event is not fired for negative transactions.
Show 202 more - metadataobject
Set of key-value pairs 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. - urlstring
The URL of the webhook endpoint.
More parameters
- disabledboolean
Returns
The updated webhook endpoint object if successful. Otherwise, this call raises an error.
{ "id": "we_1Mr5jULkdIwHu7ix1ibLTM0x", "object": "webhook_endpoint", "api_version": null, "application": null, "created": 1680122196, "description": null, "enabled_events": [ "charge.succeeded", "charge.failed" ], "livemode": false, "metadata": {}, "status": "disabled", "url": "https://example.com/new_endpoint"}Retrieves the webhook endpoint with the given ID.
Parameters
No parameters.
Returns
Returns a webhook endpoint if a valid webhook endpoint ID was provided. Raises an error otherwise.
{ "id": "we_1Mr5jULkdIwHu7ix1ibLTM0x", "object": "webhook_endpoint", "api_version": null, "application": null, "created": 1680122196, "description": null, "enabled_events": [ "charge.succeeded", "charge.failed" ], "livemode": false, "metadata": {}, "status": "enabled", "url": "https://example.com/my/webhook/endpoint"}Returns a list of your webhook endpoints.
Parameters
No parameters.
More parameters
- ending_
beforestring - limitinteger
- starting_
afterstring
Returns
A dictionary with a data property that contains an array of up to limit webhook endpoints, starting after webhook endpoint starting_. Each entry in the array is a separate webhook endpoint object. If no more webhook endpoints are available, the resulting array will be empty. This request should never raise an error.
{ "object": "list", "url": "/v1/webhook_endpoints", "has_more": false, "data": [ { "id": "we_1Mr5jULkdIwHu7ix1ibLTM0x", "object": "webhook_endpoint", "api_version": null, "application": null, "created": 1680122196, "description": null, "enabled_events": [ "charge.succeeded", "charge.failed" ], "livemode": false, "metadata": {}, "status": "enabled", "url": "https://example.com/my/webhook/endpoint" } ]}You can also delete webhook endpoints via the webhook endpoint management page of the Stripe dashboard.
Parameters
No parameters.
Returns
An object with the deleted webhook endpoints’s ID. Otherwise, this call raises an error, such as if the webhook endpoint has already been deleted.
{ "id": "we_1Mr5jULkdIwHu7ix1ibLTM0x", "object": "webhook_endpoint", "deleted": true}A claimable sandbox represents a Stripe sandbox that is anonymous. When it is created, it can be prefilled with specific metadata, such as email, name, or country. Claimable sandboxes can be claimed through a URL. When a user claims a sandbox through this URL, it will prompt them to create a new Stripe account. Or, it will allow them to claim this sandbox in their existing Stripe account. Claimable sandboxes have 60 days to be claimed. After this expiration time has passed, if the sandbox is not claimed, it will be deleted.