Deleting Customers

Soft delete

Deleting a customer is a soft delete — the record is marked as deleted and removed from the customer list, but the underlying data is retained. This preserves payment history and accounting records.

Prerequisites

Close or cancel all active payment plans before deleting a customer. A customer with active plans cannot be deleted — the deletion will be blocked with a validation error.

Check the customer’s Payment Plans tab and close any open plans before proceeding.

Effect

After deletion:

• The customer no longer appears in the customer list or search results
• API calls using the customer’s cus_xxx ID return 404
• The customer cannot be recovered via the dashboard

Data retention

Payment history, payment intents, and transaction records associated with the customer are retained for accounting and compliance purposes. This data remains accessible in account reporting even after the customer is deleted.

Tip

To deactivate a customer without permanently deleting them, set their status to cancelled instead. Cancelled customers are hidden from active workflows but remain accessible and recoverable.