> ## Documentation Index
> Fetch the complete documentation index at: https://requestnetwork-docs-openapi-secure-payments.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a batch secure payment for multiple outgoing payouts

> Creates a single batch payout link from multiple existing pending single payout tokens. The individual tokens are invalidated and a new batch payment URL is returned. All payouts must target the same network.



## OpenAPI

````yaml /api-reference/openapi.v2.json post /v2/secure-payments/batch-payouts
openapi: 3.0.0
info:
  title: Request Network API
  description: API for easily creating and paying Requests with Request Network.
  version: 0.13.0
  contact: {}
servers:
  - url: https://api.request.network
    description: Production server
  - url: https://api.stage.request.network
    description: Staging server
  - url: http://127.0.0.1:8080
    description: Local development server
security: []
tags:
  - name: V2/Request
    description: Core payment request operations (V2)
  - name: V2/Payments
    description: Payment search and management operations (V2)
  - name: V2/Payouts
    description: Pay a request without creating one first (V2)
  - name: V2/Payer
    description: Crypto-to-fiat payer management operations (V2)
  - name: V2/Currencies
    description: Currency operations (V2)
  - name: V2/Client IDs
    description: Client ID management (V2)
  - name: V2/Secure Payment
    description: Secure payment operations with token-based access (V2)
  - name: V2/Payee Destination
    description: Payee destination management (V2)
externalDocs:
  description: Request Network Docs
  url: https://docs.request.network/request-network-api
paths:
  /v2/secure-payments/batch-payouts:
    post:
      tags:
        - V2/Secure Payment
      summary: Create a batch secure payment for multiple outgoing payouts
      description: >-
        Creates a single batch payout link from multiple existing pending single
        payout tokens. The individual tokens are invalidated and a new batch
        payment URL is returned. All payouts must target the same network.
      operationId: SecurePaymentController_createBatchPayoutSecurePayment_v2
      parameters:
        - name: x-api-key
          in: header
          description: API key for authentication (optional if using Client ID or session)
          required: false
          schema:
            type: string
        - name: x-client-id
          in: header
          description: >-
            Client ID for frontend authentication (optional if using API key or
            session)
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: >-
            Bearer token for session authentication (or use the session_token
            cookie). Only consulted when no x-orchestrator-key, x-api-key, or
            x-client-id header is present.
          required: false
          schema:
            type: string
        - name: Origin
          in: header
          description: >-
            Origin header (required for Client ID auth, automatically set by
            browser)
          required: false
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tokens:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 2
                  description: >-
                    Tokens of existing pending single payout secure payments to
                    combine into one batch payment link
                redirectUrl:
                  type: string
                  description: URL the payer is redirected to after a successful payment
                redirectLabel:
                  type: string
                  minLength: 1
                  maxLength: 255
                  pattern: ^[^<>&"'`]*$
                  description: Optional label describing the redirect destination
              required:
                - tokens
      responses:
        '201':
          description: Batch payout secure payment created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  requestIds:
                    type: array
                    items:
                      type: string
                    description: Array of request IDs created for this secure payment
                  securePaymentUrl:
                    type: string
                    format: uri
                    description: URL to the secure payment page
                  token:
                    type: string
                    description: Secure payment token
                  feePlan:
                    type: object
                    properties:
                      version:
                        type: number
                        enum:
                          - 1
                      flow:
                        type: string
                        enum:
                          - get_paid
                          - pay
                      defaultFeeBearer:
                        type: string
                        enum:
                          - payer
                          - payee
                      grossAmountUsd:
                        type: string
                      netRecipientAmountUsd:
                        type: string
                      payerTotalAmountUsd:
                        type: string
                      totalFeesUsd:
                        type: string
                      payeeBorneFeesUsd:
                        type: string
                      payerBorneFeesUsd:
                        type: string
                      fees:
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                            label:
                              type: string
                            feeBearer:
                              type: string
                              enum:
                                - payer
                                - payee
                            feeBearerSource:
                              type: string
                              enum:
                                - fee_config
                                - payment_default_override
                                - flow_default
                                - forced_fee_policy
                            percentageBps:
                              type: number
                            capUsd:
                              type: string
                              nullable: true
                            fixedAmountUsd:
                              type: string
                              nullable: true
                            calculatedAmountUsd:
                              type: string
                            destinationResolver:
                              type: string
                            destinationRef:
                              type: object
                              properties:
                                evmAddress:
                                  type: string
                                tronAddress:
                                  type: string
                            configSource:
                              type: string
                          required:
                            - type
                            - label
                            - feeBearer
                            - feeBearerSource
                            - percentageBps
                            - capUsd
                            - calculatedAmountUsd
                            - destinationResolver
                            - destinationRef
                            - configSource
                    required:
                      - version
                      - flow
                      - defaultFeeBearer
                      - grossAmountUsd
                      - netRecipientAmountUsd
                      - payerTotalAmountUsd
                      - totalFeesUsd
                      - payeeBorneFeesUsd
                      - payerBorneFeesUsd
                      - fees
                    description: >-
                      Resolved fee plan snapshot. Null when fees don't apply —
                      e.g. non-stablecoin currency, or a batch that spans
                      multiple currencies (not yet supported).
                    nullable: true
                required:
                  - requestIds
                  - securePaymentUrl
                  - token
                  - feePlan
        '400':
          description: >-
            Invalid request (e.g., tokens on different networks, non-pending
            tokens, less than 2 tokens)
        '401':
          description: Unauthorized
        '403':
          description: Platform is not allowed to create payouts
        '429':
          description: Too Many Requests

````