> ## 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.

# Get Refund

> Use this API to retrieve detailed information about a specific refund transaction using its unique identifier. This API returns refund status, amounts, processing details, and gateway references.




## OpenAPI

````yaml /openapi/payments/flowwise.yaml get /refunds/{refund_id}
openapi: 3.0.3
info:
  title: Flowwise Native API
  version: 1.0.0
  description: >
    Manage orders, payments, refunds, and customers using the Flowwise Native
    API.

    [Source](https://cashfree.atlassian.net/wiki/spaces/ORC/pages/1084032020/API+Documentation)
servers:
  - url: https://sandbox.flowwise.com/router
    description: Sandbox
  - url: https://app.flowwise.com/router
    description: Production
security:
  - ApiKeyAuth: []
    ApiSecret: []
paths:
  /refunds/{refund_id}:
    get:
      summary: Get Refund
      description: >
        Use this API to retrieve detailed information about a specific refund
        transaction using its unique identifier. This API returns refund status,
        amounts, processing details, and gateway references.
      parameters:
        - $ref: '#/components/parameters/RefundId'
      responses:
        '200':
          description: Success response for refund retrieval.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefundResponse'
              example:
                payment_id: pay_summer_fashion_001_upi
                order_id: order_summer_fashion_001
                refund_id: refund_summer_fashion_001_size_issue
                refund_amount: 1149.75
                refund_status: SUCCESS
                refund_type: MERCHANT_INITIATED
                refund_note: >-
                  Customer requested size exchange - partial refund for size
                  difference
                refund_message: >-
                  Refund processed successfully. Amount will be credited within
                  5-7 business days
                gateway_details:
                  refund_reference_id: RFD434512345678901234
                  refund_utr: REF434512345678
        '400':
          description: Bad Request - Invalid refund ID format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Invalid refund ID format provided
                code: invalid_refund_id
                type: validation_error
        '401':
          description: Unauthorized - Invalid or missing authentication credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Invalid API credentials provided
                code: unauthorized
                type: authentication_error
        '404':
          description: Not Found - Refund not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Refund not found with the provided refund ID
                code: refund_not_found
                type: resource_error
        '500':
          description: Internal Server Error - Something went wrong on the server
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Internal server error occurred while retrieving refund
                code: internal_error
                type: server_error
      security:
        - ApiKeyAuth: []
          ApiSecret: []
components:
  parameters:
    RefundId:
      name: refund_id
      in: path
      required: true
      description: Unique identifier for the refund transaction.
      schema:
        type: string
        example: refund_summer_fashion_001_size_issue
  schemas:
    RefundResponse:
      type: object
      properties:
        payment_id:
          type: string
          description: Unique identifier for the original payment transaction.
          example: pay_summer_fashion_001_upi
        order_id:
          type: string
          description: Unique identifier for the associated order.
          example: order_summer_fashion_001
        refund_id:
          type: string
          description: Unique identifier for the refund transaction.
          example: refund_summer_fashion_001_size_issue
        refund_amount:
          type: number
          description: Amount that was refunded to the customer.
          example: 1149.75
        refund_status:
          type: string
          description: Current status of the refund transaction.
          example: SUCCESS
        refund_type:
          type: string
          description: Type of refund that was processed.
          example: MERCHANT_INITIATED
        refund_note:
          type: string
          description: Additional notes or reason for the refund.
          example: >-
            Customer requested size exchange - partial refund for size
            difference
        refund_message:
          type: string
          description: Message describing the refund status or outcome.
          example: >-
            Refund processed successfully. Amount will be credited within 5-7
            business days
        gateway_details:
          type: object
          description: Details from the payment gateway regarding the refund.
          properties:
            refund_reference_id:
              type: string
              description: Reference identifier for the refund from the gateway.
              example: RFD434512345678901234
            refund_utr:
              type: string
              nullable: true
              description: Unique Transaction Reference number for the refund.
              example: REF434512345678
    ErrorResponse:
      type: object
      description: Error response structure returned when an API request fails.
      properties:
        message:
          type: string
          description: Human-readable error message describing what went wrong.
        code:
          type: string
          description: Machine-readable error code for programmatic handling.
        type:
          type: string
          description: Category or type of error that occurred.
      required:
        - message
        - code
        - type
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-client-id
      description: >-
        Client app ID. You can find your app ID in the [Merchant
        Dashboard](https://merchant.cashfree.com/auth/login/pg/developers/api-keys?env=prod).
    ApiSecret:
      type: apiKey
      in: header
      name: x-client-secret
      description: >-
        Client secret key. You can find your secret key in the [Merchant
        Dashboard](https://merchant.cashfree.com/auth/login/pg/developers/api-keys?env=prod).

````