Delete Customer

Permanently delete a customer and all associated data.

DELETEhttps://api.uprails.com/customers/:customer_id

Permanently deletes a customer. This also removes any saved payment methods associated with the customer. This action cannot be undone.

Irreversible Action

Deleting a customer is permanent. All associated data including saved payment methods will be removed. Historical payment records will remain but will no longer reference the customer.

Path Parameters

Parameter	Type	Description
`customer_id`	string	Required. The ID of the customer to delete.

Request Example

curl -X DELETE https://api.uprails.com/customers/cus_1234567890abcdef \
  -H "api-key: snd_YOUR_API_KEY"

Response

200OK

{
  "customer_id": "cus_1234567890abcdef",
  "deleted": true
}

Restrictions

You cannot delete a customer if they have:

Active subscriptions (cancel subscriptions first)
Pending payments (wait for completion or cancel)