StripeKit - Delete Customer

`kit.customers.delete()`

Permanently deletes a customer in Stripe. This cannot be undone through the Stripe API.

Signature

Example request

Example response

Note this is a smaller shape than the other customer methods, it only ever contains id and deleted.

Errors

Exception	When
`StripeOperationError`	The customer ID does not exist, or Stripe refuses the deletion.

Notes

If a storage adapter is configured, StripeKit also calls saveCustomer() with a fully blanked-out record (email, name, phone, address, defaultPaymentMethodId all null, metadata empty) and deleted: true, so your own database reflects the deletion. Design your saveCustomer() implementation to treat deleted: true as a soft-delete flag rather than assuming every call is a full upsert of live data.

Deleting a customer in Stripe does not cancel their subscriptions automatically for all subscription statuses; check the Stripe documentation for your specific billing setup before deleting customers with active subscriptions.

Delete

kit.customers.delete()#

Signature#

Example request#

Example response#