Skip to main content
DELETE
/
v1
/
coupons
/
{id}
curl -X DELETE "https://api.affonso.io/v1/coupons/cpn_abc123" \
  -H "Authorization: Bearer sk_live_your_api_key"
{
  "success": true,
  "data": {
    "id": "cpn_abc123",
    "deleted": true
  }
}
Permanently delete a coupon. The coupon is also deleted at your payment provider.
This action cannot be undone. Once deleted, the coupon code becomes available for reuse.

Path Parameters

id
string
required
The unique identifier of the coupon to delete.

Response

success
boolean
Always true for successful responses
data
object
Confirmation object containing the deleted coupon’s ID.
curl -X DELETE "https://api.affonso.io/v1/coupons/cpn_abc123" \
  -H "Authorization: Bearer sk_live_your_api_key"
{
  "success": true,
  "data": {
    "id": "cpn_abc123",
    "deleted": true
  }
}

Error Responses

404 Not Found
Returned when the coupon doesn’t exist or has already been deleted.
502 Bad Gateway
Returned when the payment provider fails to delete the coupon. The coupon remains in Affonso’s database.