API Reference · Customers

Delete a customer

Permanently deletes a customer.

DELETE/v1/customers/:id

Deletion is blocked if the customer has any invoices, payments, or active recurring templates — delete or void those first. The Stripe Customer on your connected account is not deleted.

Path parameters

idstringRequired

Customer id (`cus_…`).

Errors

404

resource_missing

No customer exists with that id.

409

resource_in_use

Customer has dependent invoices, payments, or recurring templates.

Request

curl -X DELETE https://lunipay.io/api/v1/customers/cus_01JRZK2Q4T9ZS0VCNA3HX7W9EY \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "id": "cus_01JRZK2Q4T9ZS0VCNA3HX7W9EY",
  "object": "customer",
  "deleted": true
}