> ## 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 multicall payout link

> Creates a multicall Secure Payment Page link from selected outgoing payout secure-payment tokens. This is distinct from legacy secure-payment batch links and persists only the parent token plus ordered child references.



## OpenAPI

````yaml /api-reference/openapi.v2.json post /v2/secure-payments/multicall-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/multicall-payouts:
    post:
      tags:
        - V2/Secure Payment
      summary: Create a multicall payout link
      description: >-
        Creates a multicall Secure Payment Page link from selected outgoing
        payout secure-payment tokens. This is distinct from legacy
        secure-payment batch links and persists only the parent token plus
        ordered child references.
      operationId: SecurePaymentMulticallController_createMulticallPayout_v2
      parameters:
        - name: x-api-key
          in: header
          description: >-
            API key for authentication (optional if using Client ID, session, or
            orchestrator key)
          required: false
          schema:
            type: string
        - name: x-client-id
          in: header
          description: >-
            Client ID for frontend authentication (required when paired with
            orchestrator key)
          required: false
          schema:
            type: string
        - name: x-orchestrator-key
          in: header
          description: Orchestrator key for authentication (must be paired with Client ID)
          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 / orchestrator auth,
            automatically set by browser)
          required: false
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                childTokens:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 2
                  maxItems: 1000
                  description: >-
                    Ordered child secure-payment tokens selected for multicall
                    payout
                requestedExecutionKind:
                  type: string
                  enum:
                    - evm_same_chain
                    - evm_cross_chain
                    - tron_batch
                  description: >-
                    Execution kind chosen at creation time. When omitted, stored
                    as null — the SPP derives evm_same_chain or evm_cross_chain
                    from the payer's source selection at payment time.
              required:
                - childTokens
              additionalProperties: false
            examples:
              payouts:
                summary: Create a multicall payout link
                value:
                  childTokens:
                    - 01JZ4PC7EXAMPLECHILD000001
                    - 01JZ4PC7EXAMPLECHILD000002
      responses:
        '201':
          description: Multicall payout link created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - multicall
                  token:
                    type: string
                    description: Multicall payout token
                  securePaymentUrl:
                    type: string
                    format: uri
                    description: Secure Payment Page multicall URL returned on creation
                  status:
                    type: string
                    enum:
                      - pending
                      - expired
                  expiresAt:
                    type: string
                    format: date-time
                  createdAt:
                    type: string
                    format: date-time
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        securePaymentToken:
                          type: string
                          description: Child secure-payment token
                        requestId:
                          type: string
                          description: Request Network request ID for the child payout
                        position:
                          type: integer
                          minimum: 0
                          description: 0-indexed child order
                        eligibility:
                          type: string
                          enum:
                            - eligible
                            - stale
                        staleReason:
                          type: string
                          enum:
                            - secure_payment_expired
                            - secure_payment_not_pending
                            - already_paid
                            - request_processing
                            - not_payable_child
                      required:
                        - securePaymentToken
                        - requestId
                        - position
                required:
                  - type
                  - token
                  - status
                  - expiresAt
                  - createdAt
                  - items
        '400':
          description: >-
            Invalid multicall payout selection, including stale or ineligible
            child payout links
        '401':
          description: Unauthorized
        '429':
          description: Too Many Requests

````