> ## 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. # Get secure payment calldata by token > Retrieves executable payment calldata for a secure payment token. When chain and token are provided, the backend prepares a crosschain payment for the selected source asset; otherwise it returns the existing same-chain or batch payment calldata. ## OpenAPI ````yaml /api-reference/openapi.v2.json get /v2/secure-payments/{token}/pay 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}/pay: get: tags: - V2/Secure Payment summary: Get secure payment calldata by token description: >- Retrieves executable payment calldata for a secure payment token. When chain and token are provided, the backend prepares a crosschain payment for the selected source asset; otherwise it returns the existing same-chain or batch payment calldata. operationId: SecurePaymentController_getSecurePaymentCalldataByToken_v2 parameters: - name: token in: path description: >- Secure payment token (ULID) returned by POST /v2/secure-payments, POST /v2/secure-payments/payouts, or POST /v2/secure-payments/multicall-payouts. Distinct from the `token` query parameter, which selects the crosschain source currency. required: true schema: type: string - name: token required: false in: query description: >- The source token of the crosschain payment. Pair with `chain`; both must be sent together. Not the secure payment token — that is the `{token}` path parameter. schema: enum: - USDC - USDT - EURC - USDT0 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 - name: wallet required: false in: query description: >- The wallet address of the payer (optional, used to check existing approvals) schema: example: '0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7' type: string - name: chain required: false in: query description: The source chain of the crosschain payment schema: enum: - BASE - OPTIMISM - ARBITRUM - ETHEREUM - POLYGON - BNB type: string - name: eoaWallet required: false in: query description: >- The EOA wallet address that holds the funds. When provided, balance checks and LiFi quotes use this address while the wallet param is used for calldata building (smart account flow). schema: type: string - name: isSafe required: false in: query description: >- When true, prepares calldata for a Gnosis Safe multisig payer (wallet must be the Safe address). Mutually exclusive with eoaWallet. schema: type: string enum: - 'true' - 'false' responses: '200': description: Secure payment calldata retrieved successfully content: application/json: schema: anyOf: - type: object properties: paymentType: type: string enum: - single transactions: type: array items: {} description: >- Flat ordered list of calls the smart account must execute atomically. Main-payment transactions come first; fee-payment transactions follow. eoaApprovalTransactions: type: array items: {} feeBundle: type: object properties: bundleId: type: string description: >- ID of the secure_payment_bundle row. Null when fees are described by the plan snapshot but no on-chain bundle was created (e.g. no payer wallet supplied yet). nullable: true defaultFeeBearer: type: string enum: - payer - payee nullable: true amountSummary: type: object properties: grossAmount: type: string netRecipientAmount: type: string totalFees: type: string payeeBorneFees: type: string payerBorneFees: type: string payerTotal: type: string required: - grossAmount - netRecipientAmount - totalFees - payeeBorneFees - payerBorneFees - payerTotal nullable: true fees: type: array items: type: object properties: requestId: type: string feeComponentId: type: string nullable: true feeType: type: string nullable: true feeLabel: type: string nullable: true feeBearer: type: string enum: - payer - payee nullable: true amount: type: string paymentCurrencyId: type: string network: type: string chainId: type: string recipient: type: string required: - requestId - feeComponentId - feeType - feeLabel - feeBearer - amount - paymentCurrencyId - network - chainId - recipient description: >- One entry per fee leg appended to transactions[]. Order matches the order of fee transactions inside transactions[]. required: - bundleId - defaultFeeBearer - amountSummary - fees description: >- Fee bundle summary for this payment. Null when no fee plan applies. nullable: true metadata: type: object properties: stepsRequired: type: number needsApproval: type: boolean transactionSponsorshipFeeUsd: type: string nullable: true approvalTransactionIndex: type: number approvalTransactionsCount: type: number paymentTransactionIndex: type: number hasEnoughBalance: type: boolean hasEnoughGas: type: boolean hasEnoughAllowance: type: boolean platformFee: type: object properties: percentage: type: string address: type: string required: - percentage - address protocolFee: type: object properties: percentage: type: string address: type: string required: - percentage - address eoaApprovalRequired: type: boolean eoaApproval: type: object properties: owner: type: string spender: type: string tokenAddress: type: string currency: type: string amount: type: string approvalType: type: string enum: - unlimited required: - owner - spender - tokenAddress - currency - amount - approvalType balance: type: string allowance: type: string requiredAmount: type: string nativeBalance: type: string estimatedNetworkFee: type: string estimatedNetworkFeeUsd: type: string estimatedApprovalNetworkFee: type: string estimatedApprovalNetworkFeeUsd: type: string estimatedPaymentNetworkFee: type: string estimatedPaymentNetworkFeeUsd: type: string approvalFeeLimit: type: string paymentFeeLimit: type: string sourceAmount: type: string routeType: type: string enum: - crosschain - samechain quoteFetchedAt: type: string format: date-time quoteExpiresAt: anyOf: - type: number - type: string format: date-time description: >- Route quote expiry. Legacy single-payment routes may return a Unix timestamp; multicall cross-chain routes return an ISO date-time string. executionDeadline: type: integer exclusiveMinimum: true description: >- Unix seconds — hard on-chain execution window for Safe + LiFi routes (min of bridge and swap deadlines). Advisory only. minimum: 0 executionDeadlineBreakdown: type: object properties: bridge: type: object properties: deadline: type: integer exclusiveMinimum: true minimum: 0 source: type: string enum: - decoded - fallback required: - deadline - source swap: type: object properties: deadline: type: integer exclusiveMinimum: true minimum: 0 tool: type: string source: type: string enum: - decoded - fallback required: - deadline - source description: >- Per-leg deadline breakdown for Safe + LiFi execution window computation. safePaymentDeadline: type: integer exclusiveMinimum: true description: >- Unix seconds — hard on-chain Safe execution window for the selected route. minimum: 0 rawStep: type: object additionalProperties: {} costBreakdown: type: object properties: approvalFee: type: object properties: required: type: boolean currency: type: string amountNative: type: string amountUsd: type: string hasEnoughBalance: type: boolean required: - required - currency - amountNative - hasEnoughBalance paymentGasFee: type: object properties: required: type: boolean currency: type: string amountNative: type: string amountUsd: type: string hasEnoughBalance: type: boolean required: - required - currency - amountNative - hasEnoughBalance totalGasFee: type: object properties: required: type: boolean currency: type: string amountNative: type: string amountUsd: type: string hasEnoughBalance: type: boolean required: - required - currency - amountNative - hasEnoughBalance bridgeFee: type: object properties: required: type: boolean currency: type: string amount: type: string amountUsd: type: string hasEnoughBalance: type: boolean required: - required - currency - amount - hasEnoughBalance fundingStatus: type: object properties: hasEnoughPaymentToken: type: boolean hasEnoughApprovalGas: type: boolean hasEnoughOverall: type: boolean required: - hasEnoughPaymentToken - hasEnoughApprovalGas - hasEnoughOverall totals: type: object properties: paymentAmount: type: string paymentCurrency: type: string sourceAmount: type: string required: - paymentAmount - paymentCurrency - sourceAmount required: - fundingStatus required: - stepsRequired - needsApproval - paymentTransactionIndex required: - paymentType - transactions - feeBundle - metadata - type: object properties: ERC20ApprovalTransactions: type: array items: {} batchPaymentTransaction: {} metadata: type: object properties: hasEnoughBalance: type: boolean hasEnoughGas: type: boolean nullable: true canMakePayment: type: boolean nullable: true insufficientTokens: type: array items: type: object properties: tokenAddress: type: string tokenSymbol: type: string paymentCurrencyId: type: string required: type: string available: type: string required: - tokenAddress - required - available required: - hasEnoughBalance required: - ERC20ApprovalTransactions - type: object properties: paymentType: type: string enum: - multicall transactions: type: array items: {} description: >- Flat ordered list of calls the smart account must execute atomically. Main-payment transactions come first; fee-payment transactions follow. eoaApprovalTransactions: type: array items: {} feeBundle: type: object properties: bundleId: type: string description: >- ID of the secure_payment_bundle row. Null when fees are described by the plan snapshot but no on-chain bundle was created (e.g. no payer wallet supplied yet). nullable: true defaultFeeBearer: type: string enum: - payer - payee nullable: true amountSummary: type: object properties: grossAmount: type: string netRecipientAmount: type: string totalFees: type: string payeeBorneFees: type: string payerBorneFees: type: string payerTotal: type: string required: - grossAmount - netRecipientAmount - totalFees - payeeBorneFees - payerBorneFees - payerTotal nullable: true fees: type: array items: type: object properties: requestId: type: string feeComponentId: type: string nullable: true feeType: type: string nullable: true feeLabel: type: string nullable: true feeBearer: type: string enum: - payer - payee nullable: true amount: type: string paymentCurrencyId: type: string network: type: string chainId: type: string recipient: type: string required: - requestId - feeComponentId - feeType - feeLabel - feeBearer - amount - paymentCurrencyId - network - chainId - recipient description: >- One entry per fee leg appended to transactions[]. Order matches the order of fee transactions inside transactions[]. required: - bundleId - defaultFeeBearer - amountSummary - fees description: >- Fee bundle summary for this payment. Null when no fee plan applies. nullable: true executionKind: type: string enum: - evm_same_chain - evm_cross_chain token: type: string description: Multicall parent secure-payment token network: type: string description: Same-chain destination network chainId: type: integer childTokens: type: array items: type: string requestIds: type: array items: type: string children: type: array items: type: object properties: position: type: integer minimum: 0 securePaymentToken: type: string requestId: type: string payee: type: string amount: type: string paymentCurrency: type: string paymentReference: type: string nullable: true paymentCurrencyAddress: type: string nullable: true sourceTokenAddress: type: string nullable: true tokenAddress: type: string nullable: true network: type: string destinationCall: type: object properties: network: type: string description: Destination Request Network chain name chain: type: string description: >- Destination LI.FI chain identifier from the proven quote chainId: type: integer target: type: string description: >- Alias of contractAddress for SPP destination-call validation contractAddress: type: string description: >- Request Network ERC20 payment proxy on the destination chain calldata: type: string description: >- RN proxy calldata proven against the LI.FI contract-call quote required: - network - chain - target - contractAddress - calldata description: >- Cross-chain only. Decoded destination-chain RN proxy call that SPP validates before enabling Pay. required: - position - securePaymentToken - requestId - payee - amount - paymentCurrency - paymentReference - paymentCurrencyAddress - sourceTokenAddress - tokenAddress - network payees: type: array items: type: string amounts: type: array items: type: string references: type: array items: type: string nullable: true ERC20ApprovalTransactions: type: array items: {} batchPaymentTransaction: {} destinationCalls: type: array items: type: object properties: network: type: string description: Destination Request Network chain name chain: type: string description: >- Destination LI.FI chain identifier from the proven quote chainId: type: integer target: type: string description: >- Alias of contractAddress for SPP destination-call validation contractAddress: type: string description: >- Request Network ERC20 payment proxy on the destination chain calldata: type: string description: >- RN proxy calldata proven against the LI.FI contract-call quote required: - network - chain - target - contractAddress - calldata description: >- Cross-chain only. Top-level mirror of children[].destinationCall for validation diagnostics. metadata: type: object properties: stepsRequired: type: number needsApproval: type: boolean transactionSponsorshipFeeUsd: type: string nullable: true approvalTransactionIndex: type: number approvalTransactionsCount: type: number paymentTransactionIndex: type: number hasEnoughBalance: type: boolean hasEnoughGas: type: boolean hasEnoughAllowance: type: boolean platformFee: type: object properties: percentage: type: string address: type: string required: - percentage - address protocolFee: type: object properties: percentage: type: string address: type: string required: - percentage - address eoaApprovalRequired: type: boolean eoaApproval: type: object properties: owner: type: string spender: type: string tokenAddress: type: string currency: type: string amount: type: string approvalType: type: string enum: - unlimited required: - owner - spender - tokenAddress - currency - amount - approvalType balance: type: string allowance: type: string requiredAmount: type: string nativeBalance: type: string estimatedNetworkFee: type: string estimatedNetworkFeeUsd: type: string estimatedApprovalNetworkFee: type: string estimatedApprovalNetworkFeeUsd: type: string estimatedPaymentNetworkFee: type: string estimatedPaymentNetworkFeeUsd: type: string approvalFeeLimit: type: string paymentFeeLimit: type: string sourceAmount: type: string routeType: type: string enum: - crosschain - samechain quoteFetchedAt: type: string format: date-time quoteExpiresAt: anyOf: - type: number - type: string format: date-time description: >- Route quote expiry. Legacy single-payment routes may return a Unix timestamp; multicall cross-chain routes return an ISO date-time string. executionDeadline: type: integer exclusiveMinimum: true description: >- Unix seconds — hard on-chain execution window for Safe + LiFi routes (min of bridge and swap deadlines). Advisory only. minimum: 0 executionDeadlineBreakdown: type: object properties: bridge: type: object properties: deadline: type: integer exclusiveMinimum: true minimum: 0 source: type: string enum: - decoded - fallback required: - deadline - source swap: type: object properties: deadline: type: integer exclusiveMinimum: true minimum: 0 tool: type: string source: type: string enum: - decoded - fallback required: - deadline - source description: >- Per-leg deadline breakdown for Safe + LiFi execution window computation. safePaymentDeadline: type: integer exclusiveMinimum: true description: >- Unix seconds — hard on-chain Safe execution window for the selected route. minimum: 0 rawStep: type: object additionalProperties: {} costBreakdown: type: object properties: approvalFee: type: object properties: required: type: boolean currency: type: string amountNative: type: string amountUsd: type: string hasEnoughBalance: type: boolean required: - required - currency - amountNative - hasEnoughBalance paymentGasFee: type: object properties: required: type: boolean currency: type: string amountNative: type: string amountUsd: type: string hasEnoughBalance: type: boolean required: - required - currency - amountNative - hasEnoughBalance totalGasFee: type: object properties: required: type: boolean currency: type: string amountNative: type: string amountUsd: type: string hasEnoughBalance: type: boolean required: - required - currency - amountNative - hasEnoughBalance bridgeFee: type: object properties: required: type: boolean currency: type: string amount: type: string amountUsd: type: string hasEnoughBalance: type: boolean required: - required - currency - amount - hasEnoughBalance fundingStatus: type: object properties: hasEnoughPaymentToken: type: boolean hasEnoughApprovalGas: type: boolean hasEnoughOverall: type: boolean required: - hasEnoughPaymentToken - hasEnoughApprovalGas - hasEnoughOverall totals: type: object properties: paymentAmount: type: string paymentCurrency: type: string sourceAmount: type: string required: - paymentAmount - paymentCurrency - sourceAmount required: - fundingStatus approvalTransactionIndices: type: array items: type: integer minimum: 0 batchPaymentTransactionIndex: type: integer minimum: 0 feeTransactionIndices: type: array items: type: integer minimum: 0 bridgeTxIndices: type: array items: type: integer minimum: 0 childCount: type: integer minimum: 0 executableLegCount: type: integer minimum: 0 aggregateAllowance: type: string paymentCurrencyId: type: string network: type: string bridgeSourceAmount: type: string sourceSideAmount: type: string bridgeFeeAmount: type: string sourceToken: type: string sourceTokenAddress: type: string sourceNetwork: type: string bridge: {} feePlanCarried: type: boolean required: - stepsRequired - needsApproval - paymentTransactionIndex - childCount - executableLegCount required: - paymentType - transactions - feeBundle - executionKind - token - childTokens - requestIds - children - payees - amounts - references - metadata '400': description: Invalid secure payment calldata request '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 '423': description: Secure payment is in progress '429': description: Too Many Requests ````