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

# Raise a Ticket Request

> Use this API to raise a support ticket for a previously processed bill payment.
This is an **async** API. It returns an acknowledgement with a `ref_id`.
Poll the Ticket Status API using `ref_id` to get the current status of your ticket.

<Accordion title="Disposition codes">

Pass one of the following codes in the `disposition` field:

| Disposition code | Description | Type |
|---|---|---|
| `D11` | Transaction Successful, Amount Debited but services not received | Dispute |
| `D12` | Transaction Successful, Amount Debited but Service Disconnected or Service Stopped | Dispute |
| `D13` | Transaction Successful, Amount Debited but LPSC Late Payment Surcharge Charges added in next bill | Dispute |
| `D21` | Erroneously paid in wrong account | Dispute |
| `D22` | Duplicate Payment | Dispute |
| `D23` | Erroneously paid the wrong amount | Dispute |
| `D31` | Payment information not received from Biller or delay in receiving payment information from the Biller | Complaint |
| `D32` | Bill paid but amount not adjusted or still showing due amount | Complaint |

</Accordion>



## OpenAPI

````yaml openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/request/ticket
openapi: 3.0.3
info:
  title: BBPS for Customers (Customer Operating Unit)
  version: 1.0.0
  description: >
    APIs for Agent Institutions to integrate with the Bharat Bill Payment System
    (BBPS) as a Customer Operating Unit (COU). These APIs enable bill discovery,
    bill fetch, bill payment, ticket management, and wallet operations.
servers:
  - url: https://sandbox.cashfree.com
    description: Sandbox (Testing) environment.
  - url: https://api.cashfree.com
    description: Production environment.
security:
  - XClientID: []
    XClientSecret: []
paths:
  /bbps/cou/v1/billers/request/ticket:
    post:
      tags:
        - Ticket
      summary: Raise Ticket Request
      description: >-
        Use this API to raise a support ticket for a previously processed bill
        payment.

        This is an **async** API. It returns an acknowledgement with a `ref_id`.

        Poll the Ticket Status API using `ref_id` to get the current status of
        your ticket.


        <Accordion title="Disposition codes">


        Pass one of the following codes in the `disposition` field:


        | Disposition code | Description | Type |

        |---|---|---|

        | `D11` | Transaction Successful, Amount Debited but services not
        received | Dispute |

        | `D12` | Transaction Successful, Amount Debited but Service
        Disconnected or Service Stopped | Dispute |

        | `D13` | Transaction Successful, Amount Debited but LPSC Late Payment
        Surcharge Charges added in next bill | Dispute |

        | `D21` | Erroneously paid in wrong account | Dispute |

        | `D22` | Duplicate Payment | Dispute |

        | `D23` | Erroneously paid the wrong amount | Dispute |

        | `D31` | Payment information not received from Biller or delay in
        receiving payment information from the Biller | Complaint |

        | `D32` | Bill paid but amount not adjusted or still showing due amount
        | Complaint |


        </Accordion>
      operationId: raiseTicket
      requestBody:
        description: Request parameters to raise a ticket for a processed bill payment.
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - ticket_raise_request
              properties:
                ticket_raise_request:
                  type: object
                  required:
                    - agent_id
                    - txn_reference_id
                    - disposition
                    - description
                    - customer_mobile
                  properties:
                    agent_id:
                      type: string
                      description: >-
                        Unique identifier of the Agent Institution raising the
                        ticket.
                      example: OU01XXXXINT001123456
                    txn_reference_id:
                      type: string
                      description: Reference ID of the original bill payment transaction.
                      example: OU011010ABCD12345601
                    disposition:
                      type: string
                      description: >-
                        Predefined disposition code describing the nature of the
                        ticket. See the disposition codes table above for valid
                        values.
                      enum:
                        - D11
                        - D12
                        - D13
                        - D21
                        - D22
                        - D23
                        - D31
                        - D32
                      example: D11
                    description:
                      type: string
                      description: >-
                        Free-text description providing additional context for
                        the ticket.
                      example: >-
                        Customer did not receive confirmation for a successful
                        payment.
                    customer_mobile:
                      type: string
                      description: >-
                        Mobile number of the customer associated with the
                        transaction.
                      example: '9876543210'
                    customer_email_id:
                      type: string
                      description: >-
                        Email address of the customer associated with the
                        transaction. Optional.
                      example: customer@example.com
                    customer_name:
                      type: string
                      description: >-
                        Full name of the customer associated with the
                        transaction. Optional.
                      example: Rahul Sharma
            example:
              ticket_raise_request:
                agent_id: OU01XXXXINT001123456
                txn_reference_id: OU011010ABCD12345601
                disposition: D11
                description: Customer received no service despite a successful debit.
                customer_mobile: '9876543210'
                customer_email_id: customer@example.com
                customer_name: Rahul Sharma
      responses:
        '202':
          description: Ticket raise request accepted for processing.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      Always "ACCEPTED" when the ticket request is successfully
                      queued.
                    example: ACCEPTED
                  message:
                    type: string
                    description: >-
                      Human-readable confirmation that the ticket request has
                      been accepted for async processing.
                    example: Ticket raise request accepted for processing
                  data:
                    type: object
                    description: >-
                      Acknowledgement data returned immediately upon request
                      acceptance.
                    properties:
                      ref_id:
                        type: string
                        description: >-
                          Unique reference ID for this ticket request. Use this
                          to poll the Ticket Status API.
                        example: TKREF4QOS7X1UGPY7JGUV444P10102202
                      status:
                        type: string
                        description: >-
                          Processing status of the ticket request. Always
                          "PROCESSING" at this stage.
                        example: PROCESSING
              example:
                status: ACCEPTED
                message: Ticket raise request accepted for processing
                data:
                  ref_id: TKREF4QOS7X1UGPY7JGUV444P10102202
                  status: PROCESSING
        '400':
          description: Bad request error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedResponse'
        '429':
          description: Rate Limit Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitResponse'
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
      security:
        - XClientID: []
          XClientSecret: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable description of the validation or request error.
          example: >-
            bill_fetch_request.agent_id : is missing in the request. Value
            received: 
        code:
          type: string
          description: >-
            Machine-readable error code identifying the specific validation
            failure.
          example: bill_fetch_request.agent_id_missing
        type:
          type: string
          description: Category of the error, indicating the error class.
          example: invalid_request_error
    UnauthorizedResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable description of the authentication failure.
          example: authentication Failed
        code:
          type: string
          description: Machine-readable error code identifying the failure reason.
          example: request_failed
        type:
          type: string
          description: Category of the error, indicating the error class.
          example: authentication_error
    RateLimitResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable description of the rate limit breach.
          example: Too many requests from IP. Check headers
        code:
          type: string
          description: Machine-readable error code identifying the failure reason.
          example: request_failed
        type:
          type: string
          description: Category of the error, indicating the error class.
          example: rate_limit_error
    InternalServerErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable description of the server-side error.
          example: internal Server Error
        code:
          type: string
          description: Machine-readable error code identifying the failure reason.
          example: internal_error
        type:
          type: string
          description: Category of the error, indicating the error class.
          example: api_error
  securitySchemes:
    XClientID:
      type: apiKey
      in: header
      name: x-client-id
      description: >-
        Your unique client identifier issued by Cashfree. You can find this in
        your [Merchant
        Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).
    XClientSecret:
      type: apiKey
      in: header
      name: x-client-secret
      description: >-
        Your unique client secret issued by Cashfree. Keep this confidential and
        never expose it in client-side code. You can find this in your [Merchant
        Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).

````