Sample - Stripe API
DELETE/v1/coupons/{coupon}

Delete a coupon

Deletes a coupon so that new customers can no longer redeem it. Deleting the coupon does not affect customers who have already applied it, so use this operation only when you want to prevent future redemptions.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
couponstringrequired
The unique identifier of the coupon to delete.

2 status codes
200Returns a deleted coupon object containing its identifier, object type, and `deleted: true` marker.
deletedbooleanrequired
Always true for a deleted object
Allowed:true
idstringrequired
Unique identifier for the object.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:coupon
defaultReturned when the API reports an error and includes an `error` object describing the failure.
errorobjectrequired

Error handling

coupon must be a string of no more than 5000 characters and identify the coupon to delete. Deletion prevents new customers from redeeming the coupon but does not remove discounts already applied to existing customers.