> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Coupon

> The "Delete Coupon" API allows you to permanently remove a coupon from your system using its unique identifier. Use this endpoint to discontinue promotional offers or clean up unused coupons. Note that this action cannot be undone.



## OpenAPI

````yaml /api-reference/payments/openapi.json delete /payments/coupon
openapi: 3.0.0
info:
  title: Payments API
  description: Documentation for payments API
  version: '1.0'
  contact: {}
servers:
  - url: https://services.leadconnectorhq.com
security: []
tags:
  - name: Payments
    description: Documentation for payments API
  - name: Integrations
    description: Documentation for payments API
  - name: Orders
    description: Documentation for payments API
  - name: Order fulfillments
    description: Documentation for payments API
  - name: Order Notes
    description: Documentation for payments API
  - name: Transactions
    description: Documentation for payments API
  - name: Subscriptions
    description: Documentation for payments API
  - name: Coupons
    description: Documentation for payments API
  - name: Custom Provider
    description: Documentation for payments API
paths:
  /payments/coupon:
    delete:
      tags:
        - Coupons
      summary: Delete Coupon
      description: >-
        The "Delete Coupon" API allows you to permanently remove a coupon from
        your system using its unique identifier. Use this endpoint to
        discontinue promotional offers or clean up unused coupons. Note that
        this action cannot be undone.
      operationId: delete-coupon
      parameters:
        - name: Version
          in: header
          description: API Version
          required: true
          schema:
            type: string
            enum:
              - '2021-07-28'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteCouponParams'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteCouponResponseDto'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnprocessableDTO'
      security:
        - Location-Access:
            - payments/coupons.write
components:
  schemas:
    DeleteCouponParams:
      type: object
      properties:
        altId:
          type: string
          description: Location Id
          example: BQdAwxa0ky1iK2sstLGJ
        altType:
          type: string
          description: Alt Type
          enum:
            - location
          example: location
        id:
          type: string
          description: Coupon Id
          example: 6241712be68f7a98102ba272
      required:
        - altId
        - altType
        - id
    DeleteCouponResponseDto:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates whether the delete was successful
          example: true
        traceId:
          type: string
          description: Unique identifier for tracing this API request
          example: c667b18d-8f5e-44cf-a914
      required:
        - success
        - traceId
    UnprocessableDTO:
      type: object
      properties:
        statusCode:
          type: number
          example: 422
        message:
          type: array
          items:
            type: string
          example:
            - Unprocessable Entity
        error:
          type: string
          example: Unprocessable Entity
      required:
        - statusCode
        - message
        - error

````