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

# Capture Payments in Bulk

> Use this API to process bulk capture operations for multiple pre-authorised payments within a specified date range. This API is useful for merchants who need to capture multiple authorised payments at once.




## OpenAPI

````yaml /openapi/payments/flowwise.yaml post /payment/preauth/capture
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:
  /payment/preauth/capture:
    post:
      summary: Capture Payments in Bulk
      description: >
        Use this API to process bulk capture operations for multiple
        pre-authorised payments within a specified date range. This API is
        useful for merchants who need to capture multiple authorised payments at
        once.
      requestBody:
        required: true
        description: Request parameters for bulk capture operation.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkCaptureRequest'
            example:
              start_date_time: '2024-12-01T00:00:00Z'
              end_date_time: '2024-12-01T23:59:59Z'
      responses:
        '200':
          description: Success response for bulk capture.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkCaptureResponse'
              example:
                total_payment_to_be_captured: 147
                start_date_time: '2024-12-01T00:00:00Z'
                end_date_time: '2024-12-01T23:59:59Z'
        '400':
          description: Bad Request - Invalid date range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Invalid date range or start date is after end date
                code: invalid_date_range
                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
        '500':
          description: Internal Server Error - Bulk capture processing failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Bulk capture processing failed due to server error
                code: bulk_capture_failed
                type: server_error
components:
  schemas:
    BulkCaptureRequest:
      type: object
      required:
        - start_date_time
        - end_date_time
      properties:
        start_date_time:
          type: string
          format: date-time
          description: Start date and time for the bulk capture operation.
          example: '2024-12-01T00:00:00Z'
        end_date_time:
          type: string
          format: date-time
          description: End date and time for the bulk capture operation.
          example: '2024-12-01T23:59:59Z'
    BulkCaptureResponse:
      type: object
      properties:
        total_payment_to_be_captured:
          type: integer
          description: Total number of payments that will be captured.
          example: 147
        start_date_time:
          type: string
          description: Start date and time for the bulk capture operation.
          example: '2024-12-01T00:00:00Z'
        end_date_time:
          type: string
          description: End date and time for the bulk capture operation.
          example: '2024-12-01T23:59:59Z'
    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).

````