get:
  tags:
    - Vouchers
  summary: Validate a coupon code
  description: |
    Checks if a voucher code is valid and returns information about the voucher.
  operationId: validateCouponCode
  parameters:
    - name: code
      in: query
      description: The voucher code or voucher ID to validate
      required: true
      schema:
        type: string
  responses:
    '200':
      description: Successful operation
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                type: object
                properties:
                  status:
                    type: string
                    enum: [success, error]
                    description: Status of the validation
                  status_msg:
                    type: string
                    description: Human-readable status message
                  currency:
                    type: string
                    description: Currency code of the voucher
                  coupon_id:
                    type: integer
                    description: ID of the voucher
                  amount_left:
                    type: number
                    description: Remaining amount that can be used from this voucher
                  amount_total:
                    type: number
                    description: Total amount of the voucher
                  is_test_payment:
                    type: string
                    enum: [Y, N]
                    description: Whether the voucher can only be used for test payments (Y) or real payments (N)
  security:
    - ApiKeyAuth: []