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

# Record secure payment intent

> Records source-side execution metadata after the payer broadcasts a transaction. Single crosschain payments create or reuse a LiFi tracking intent. Multicall parent tokens create or reuse an audit-only execution receipt keyed by parent token and UserOperation hash; receipt rows are not consulted for settlement state.



## OpenAPI

````yaml /api-reference/openapi.v2.json post /v2/secure-payments/{token}/intent
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/{token}/intent:
    post:
      tags:
        - V2/Secure Payment
      summary: Record secure payment intent
      description: >-
        Records source-side execution metadata after the payer broadcasts a
        transaction. Single crosschain payments create or reuse a LiFi tracking
        intent. Multicall parent tokens create or reuse an audit-only execution
        receipt keyed by parent token and UserOperation hash; receipt rows are
        not consulted for settlement state.
      operationId: SecurePaymentController_recordIntent_v2
      parameters:
        - name: token
          required: true
          in: path
          schema:
            type: string
        - name: x-client-id
          in: header
          description: Client ID for frontend authentication
          required: true
          schema:
            type: string
        - name: Origin
          in: header
          description: Origin header (automatically set by browser)
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              anyOf:
                - type: object
                  properties:
                    txHash:
                      type: string
                      minLength: 66
                      maxLength: 66
                      pattern: ^0x[a-fA-F0-9]{64}$
                    safeTxHash:
                      type: string
                      minLength: 66
                      maxLength: 66
                      pattern: ^0x[a-fA-F0-9]{64}$
                    chain:
                      enum:
                        - BASE
                        - OPTIMISM
                        - ARBITRUM
                        - ETHEREUM
                        - POLYGON
                        - BNB
                      type: string
                    token:
                      enum:
                        - USDC
                        - USDT
                        - EURC
                        - USDT0
                      type: string
                    executionKind:
                      type: string
                      enum:
                        - evm_same_chain
                        - evm_cross_chain
                    safePaymentDeadline:
                      type: integer
                      exclusiveMinimum: true
                      description: >-
                        Unix seconds — hard on-chain execution deadline for the
                        Safe + LiFi route. Only valid alongside safeTxHash; used
                        to stop monitoring once crossed.
                      minimum: 0
                    payerAddress:
                      type: string
                    payerEoaAddress:
                      type: string
                    sourceNetwork:
                      type: string
                      enum:
                        - mainnet
                        - optimism
                        - bsc
                        - xdai
                        - fuse
                        - matic
                        - fantom
                        - zksynceratestnet
                        - zksyncera
                        - core
                        - moonbeam
                        - mantle
                        - mantle-testnet
                        - tombchain
                        - base
                        - arbitrum-one
                        - avalanche
                        - base-sepolia
                        - sepolia
                        - tron
                        - nile
                    sourceToken:
                      type: string
                    sourceAmount:
                      type: string
                    routeKind:
                      type: string
                      enum:
                        - same_chain
                        - same_chain_conversion
                        - crosschain
                    bridgeTool:
                      type: string
                      enum:
                        - across
                        - stargate
                      nullable: true
                  required:
                    - chain
                    - token
                - type: object
                  properties:
                    txHash:
                      type: string
                      minLength: 66
                      maxLength: 66
                      pattern: ^0x[a-fA-F0-9]{64}$
                      description: >-
                        Bundler or source-chain transaction hash produced by the
                        submitted UserOperation
                    safeTxHash:
                      type: string
                      minLength: 66
                      maxLength: 66
                      pattern: ^0x[a-fA-F0-9]{64}$
                      description: >-
                        Safe transaction hash when execution is still pending
                        on-chain
                    safePaymentDeadline:
                      type: integer
                      exclusiveMinimum: true
                      description: >-
                        Unix seconds — hard on-chain execution deadline for the
                        Safe + multicall route. Only valid alongside safeTxHash.
                      minimum: 0
                    chain:
                      type: string
                      enum:
                        - BASE
                        - OPTIMISM
                        - ARBITRUM
                        - ETHEREUM
                        - POLYGON
                        - BNB
                      description: >-
                        Source chain where the multicall UserOperation was
                        submitted
                    smartAccountAddress:
                      type: string
                      description: Smart account that submitted the multicall UserOperation
                    payerEoaAddress:
                      type: string
                      description: Connected EOA behind the submitted smart account
                    userOpHash:
                      type: string
                      minLength: 66
                      maxLength: 66
                      pattern: ^0x[a-fA-F0-9]{64}$
                      description: UserOperation hash returned by the bundler
                    transactionIndices:
                      type: array
                      items:
                        type: object
                        properties:
                          childPosition:
                            type: integer
                            minimum: 0
                            description: Zero-based child position in the multicall parent
                          transactionIndex:
                            type: integer
                            minimum: 0
                            description: >-
                              Zero-based local transaction index in the
                              submitted batch
                          routeTool:
                            type: string
                            description: >-
                              Per-child route tool from the multicall pay
                              payload. Across bridge legs require LiFi status
                              tracking; direct legs use normal payment
                              detection.
                            nullable: true
                          sourceToken:
                            type: string
                          sourceAmount:
                            type: string
                          routeKind:
                            type: string
                            enum:
                              - same_chain
                              - same_chain_conversion
                              - crosschain
                          bridgeTool:
                            type: string
                            enum:
                              - across
                              - stargate
                            nullable: true
                        required:
                          - childPosition
                          - transactionIndex
                      minItems: 1
                      maxItems: 250
                  required:
                    - chain
                    - smartAccountAddress
                    - userOpHash
                    - transactionIndices
            examples:
              safePendingIntent:
                summary: Safe transaction pending on-chain execution
                value:
                  safeTxHash: >-
                    0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
                  chain: POLYGON
                  token: USDC
                  executionKind: evm_cross_chain
                  safePaymentDeadline: 1749760800
                  payerAddress: '0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7'
      responses:
        '200':
          description: Intent recorded successfully
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      intentId:
                        type: string
                        description: Tracking intent ID created or reused
                      paymentReference:
                        type: string
                        description: Payment reference associated with the tracked request
                      txHash:
                        type: string
                        description: Recorded source-chain transaction hash
                      safeTxHash:
                        type: string
                        description: >-
                          Recorded Safe transaction hash pending on-chain
                          execution
                      safePaymentDeadline:
                        type: integer
                        exclusiveMinimum: true
                        description: >-
                          Recorded Unix-seconds execution deadline for the Safe
                          + LiFi route, when provided
                        minimum: 0
                      isListening:
                        type: boolean
                        description: >-
                          Whether the tracking intent is being monitored for
                          status
                      payerAddress:
                        type: string
                    required:
                      - intentId
                      - paymentReference
                      - isListening
                  - type: object
                    properties:
                      receiptId:
                        type: string
                        description: Audit receipt ID created or reused
                      multicallId:
                        type: string
                        description: Multicall parent row ID
                      parentToken:
                        type: string
                        description: Multicall parent token
                      txHash:
                        type: string
                        description: Recorded source-chain transaction hash
                      safeTxHash:
                        type: string
                        description: >-
                          Recorded Safe transaction hash pending on-chain
                          execution
                      safePaymentDeadline:
                        type: integer
                        exclusiveMinimum: true
                        description: >-
                          Recorded Unix-seconds execution deadline for the Safe
                          + multicall route, when provided
                        minimum: 0
                      sourceChain:
                        enum:
                          - BASE
                          - OPTIMISM
                          - ARBITRUM
                          - ETHEREUM
                          - POLYGON
                          - BNB
                        type: string
                      smartAccountAddress:
                        type: string
                        description: Submitting smart account
                      userOpHash:
                        type: string
                        description: Recorded UserOperation hash
                      transactionIndices:
                        type: array
                        items:
                          type: object
                          properties:
                            childPosition:
                              type: integer
                              minimum: 0
                            transactionIndex:
                              type: integer
                              minimum: 0
                          required:
                            - childPosition
                            - transactionIndex
                      isListening:
                        type: boolean
                        enum:
                          - false
                        description: >-
                          Multicall execution receipts are audit-only and not
                          polled
                    required:
                      - receiptId
                      - multicallId
                      - parentToken
                      - sourceChain
                      - smartAccountAddress
                      - userOpHash
                      - transactionIndices
                      - isListening
        '400':
          description: Invalid or unsupported crosschain execution payload
        '401':
          description: Unauthorized
        '403':
          description: Secure payment token expired or invalid status
        '404':
          description: Secure payment not found
        '409':
          description: Secure payment has already been completed
        '429':
          description: Too Many Requests

````