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

# Get Payout Detail

> Retrieve detailed information about a specific payout payment, including its status, total amount, failed transactions, and other relevant details. This endpoint allows you to check the payout payment’s current status and access additional information such as notification details and associated transactions.

Payout payment statuses:
- **created**: The payout payment has been created.
- **processing**: The payout is currently in progress and funds are being topped up to the PayID.
- **scheduled**: The payout is scheduled and awaiting transfer to the payee.
- **completed**: The payout payment has been successfully completed.
- **expired**: The payout payment has expired.




## OpenAPI

````yaml /api/openapi/v1-reference.yaml get /v1/payouts/detail
openapi: 3.0.3
info:
  title: Payment APIs (AUD only)
  description: >-
    ## Introduction

    The Payment API Solution (AUD) offers developers a comprehensive suite of
    API services to build innovative AUD payment solutions efficiently. These
    APIs enable seamless transactions using various payment methods and
    functionalities, ensuring a robust, reliable, and scalable payment
    infrastructure tailored for the Australian market.

    ### Key Features

    - **Payment Methods**:
      - **Payment Link**: Supports payments via card and PayID.
      - **PayID**: Provides instant payments using a unique identifier.
      - **PayTo**: Enables scheduled or recurring payments.
      - **BSB/Account Number**: Allows direct bank transfers.
      - **Payout**: Manage payouts to designated accounts.

    - **Additional Functionalities**:
      - **Balance Management**: Real-time balance inquiries and updates.
      - **Reporting Services**: Generate detailed transaction and payment reports.

    This documentation provides detailed guidance for integrating these
    capabilities into your application.
  termsOfService: https://helloclever.co/terms
  contact:
    email: support@helloclever.co
  version: 1.0.11
servers:
  - url: https://api.cleverhub.co/api
    description: Sandbox Environment
  - url: https://api-merchant.helloclever.co/api
    description: Production Environment
security: []
paths:
  /v1/payouts/detail:
    get:
      tags:
        - AUD Payout
      summary: Get Payout Detail
      description: >
        Retrieve detailed information about a specific payout payment, including
        its status, total amount, failed transactions, and other relevant
        details. This endpoint allows you to check the payout payment’s current
        status and access additional information such as notification details
        and associated transactions.


        Payout payment statuses:

        - **created**: The payout payment has been created.

        - **processing**: The payout is currently in progress and funds are
        being topped up to the PayID.

        - **scheduled**: The payout is scheduled and awaiting transfer to the
        payee.

        - **completed**: The payout payment has been successfully completed.

        - **expired**: The payout payment has expired.
      operationId: getPayoutDetail
      parameters:
        - name: id
          in: query
          required: true
          schema:
            type: integer
          description: |
            Unique identifier (ID) for the payout payment within Hello Clever.
          example: 12345
        - name: uuid
          in: query
          required: false
          schema:
            type: string
          description: >
            Unique UUID for the payout payment, used to identify the transaction
            uniquely.
          example: 123e4567-e89b-12d3-a456-426614174000
      responses:
        '200':
          description: Successfully retrieved payout payment details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PayoutObject'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '422':
          description: Unprocessable Entity
components:
  schemas:
    PayoutObject:
      type: object
      properties:
        id:
          type: integer
          description: >
            A unique identifier assigned to the payout payment, used for
            tracking and referencing purposes within the system.
          example: 12345
        uuid:
          type: string
          description: >
            A unique UUID assigned to the payout payment, providing a globally
            unique reference for the transaction.
          example: 550e8400-e29b-41d4-a716-446655440000
        description:
          type: string
          description: >
            A description of the payout payment, providing context or additional
            information such as the purpose of the payout.
          example: 'Payout for invoice #12345'
        payid:
          type: string
          description: >
            The PayID used for topping up the payout payment, allowing for easy
            routing of funds to the correct recipient.
          example: sample@payid.com
        total_amount:
          type: string
          description: >
            The total amount of all transactions included in the payout,
            providing the complete value being paid out.
          example: '1000.00'
        total_refund:
          type: string
          description: |
            The total amount that has been refunded to the payee, if applicable.
          example: '100.00'
        total_failed_transactions:
          type: string
          description: >
            The total number of transactions within the payout that failed to
            complete successfully.
          example: '2'
        scheduled_at:
          type: string
          format: date-time
          description: >
            The date and time when the payout transaction is scheduled to occur,
            expressed in UTC.
          example: '2024-12-31T23:59:59Z'
        status:
          type: string
          enum:
            - created
            - processing
            - scheduled
            - completed
            - expired
          description: |
            The current status of the payout payment. Possible values include:
            - `created`: The payout has been created but not yet processed.
            - `processing`: The payout is currently being processed.
            - `scheduled`: The payout is scheduled for a future date.
            - `completed`: The payout has been completed successfully.
            - `expired`: The payout has expired.
          example: processing
        export_url:
          type: string
          format: uri
          description: >
            A URL for downloading an attachment related to the payout payment,
            such as a receipt or transaction details.
          example: https://example.com/download/payout_attachment
        payout_notification:
          type: object
          description: >
            Details regarding the merchant callback settings for payout status
            updates, including the endpoint URL and authorization header.
          properties:
            endpoint_url:
              type: string
              format: uri
              description: >
                An internet-accessible URL that will be invoked when the status
                of the payout changes, allowing the merchant to receive
                real-time updates.
              example: https://merchant.com/payout_callback
            authorization_header:
              type: string
              description: >
                The authorization header value to be used in the callback
                request, helping ensure the request is authenticated.
              example: Bearer your_token
        error_code:
          type: string
          description: >
            An error code associated with the payout, indicating any issues that
            occurred during processing.
          example: HC_PAYOUT1
        error_message:
          type: string
          description: >
            A description of the error encountered during the payout process,
            providing context for troubleshooting.
          example: >-
            Insufficient funds to payout. Please top up balance in the
            dashboard.
        is_retry:
          type: boolean
          description: >
            Indicates whether the payout is being retried after a previous
            failure.
          example: false
        external_id:
          type: string
          description: >
            A custom identifier for the payout, provided by the merchant for
            tracking and reference purposes.
          example: custom-payout-id-6789
        payout_transactions:
          type: array
          description: >
            A list of individual transactions that are part of the payout,
            including details such as payee information and transaction status.
          items:
            type: object
            properties:
              id:
                type: integer
                description: >
                  A unique identifier assigned to the payout transaction, used
                  for tracking and referencing purposes.
                example: 123
              balance_id:
                type: string
                description: >
                  The UUID of the balance transaction associated with the
                  payout, providing a reference to the specific balance
                  movement.
                example: 550e8400-e29b-41d4-a716-446655441111
              payee:
                type: string
                description: >
                  The name of the payee receiving the payout, used to identify
                  the recipient of the funds.
                example: John Doe
              payid:
                type: string
                description: >
                  The PayID of the payee, used to route the payout to the
                  correct recipient.
                example: payee@payid.com
              payid_type:
                type: string
                description: >
                  The type of PayID being used by the payee. Valid values
                  include:

                  - `EMAIL`: An email address.

                  - `PHONE`: A phone number.

                  - `ABN`: An Australian Business Number.
                enum:
                  - EMAIL
                  - PHONE
                  - ABN
                example: EMAIL
              bsb:
                type: string
                description: >
                  The Bank-State-Branch (BSB) number of the payee's account,
                  used to identify the bank and branch for the transaction.
                example: '123456'
              account_number:
                type: string
                description: >
                  The account number of the payee, used to route the payout to
                  the correct bank account.
                example: '987654321'
              amount:
                type: string
                description: >
                  The amount being paid to the payee as part of the payout
                  transaction.
                example: '500.00'
              status:
                type: string
                description: >
                  The current status of the payout transaction. Possible values
                  include:

                  - `created`: The transaction has been created but not yet
                  processed.

                  - `processing`: The transaction is currently being processed.

                  - `settled`: The transaction has been completed successfully.

                  - `failed`: The transaction failed to complete successfully.
                enum:
                  - created
                  - processing
                  - settled
                  - failed
                example: settled
              error_message:
                type: string
                description: >
                  An error message providing details about why the payout
                  transaction failed, if applicable.
                example: Payment failed due to insufficient funds.
              created_at:
                type: string
                format: date-time
                description: >
                  The date and time when the payout transaction was created,
                  expressed in UTC.
                example: '2024-01-01T00:00:00Z'

````

## Related topics

- [Get Payout Details](/api/payout/get-payout-details.md)
- [Multi-Currency Payout API Reference (v2)](/api/v2/payout.md)
- [Handle Multi-Currency Payins and Payouts](/developer-reference/api-use-cases/handle-multi-currency-payins-and-payouts.md)
