> ## 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. # Find secure payment by request ID > Looks up the secure payment associated with a given request ID. Returns the payment link URL, status, and metadata. Requires a SIWE session. ## OpenAPI ````yaml /api-reference/openapi.v2.json get /v2/secure-payments 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: get: tags: - V2/Secure Payment summary: Find secure payment by request ID description: >- Looks up the secure payment associated with a given request ID. Returns the payment link URL, status, and metadata. Requires a SIWE session. operationId: SecurePaymentController_findSecurePayment_v2 parameters: - name: Authorization in: header description: >- Bearer token for session authentication (or use session_token cookie) required: true schema: type: string - name: requestId required: true in: query description: Request ID to look up the associated secure payment schema: type: string responses: '200': description: Secure payment found content: application/json: schema: type: object properties: token: type: string description: Secure payment token securePaymentUrl: type: string format: uri description: URL to the secure payment page status: type: string enum: - pending - completed - expired - invalidated - compliance_failed description: Current status of the secure payment paymentType: type: string enum: - single - batch description: 'Type of payment: single or batch' createdAt: type: string format: date-time description: When the secure payment was created nullable: true expiresAt: type: string format: date-time description: When the secure payment token expires redirectUrl: type: string description: >- Optional redirect URL configured at creation time. Null when no redirect was set. nullable: true redirectLabel: type: string description: >- Optional label describing the redirect destination. Null when no label was provided. nullable: true completedAt: type: string format: date-time description: When the secure payment was completed nullable: true payerAddress: type: string description: Detected payer address for the completed secure payment nullable: true payerKytResults: type: array items: type: object properties: walletAddress: type: string walletType: type: string enum: - eoa - smart_account parentWalletAddress: type: string nullable: true status: type: string nullable: true reasonCode: type: string nullable: true provider: type: string nullable: true providerReference: type: string nullable: true reportUrl: type: string nullable: true notes: type: string nullable: true rawStatus: type: string nullable: true evaluatedAt: anyOf: - type: string format: date-time - type: string nullable: true required: - walletAddress - walletType - parentWalletAddress - status - reasonCode - provider - providerReference - reportUrl - notes - rawStatus - evaluatedAt description: KYT result for a wallet screened for a secure payment description: KYT results for the actual detected payer wallets only payeeKytResults: type: array items: type: object properties: walletAddress: type: string walletType: type: string enum: - eoa - smart_account parentWalletAddress: type: string nullable: true status: type: string nullable: true reasonCode: type: string nullable: true provider: type: string nullable: true providerReference: type: string nullable: true reportUrl: type: string nullable: true notes: type: string nullable: true rawStatus: type: string nullable: true evaluatedAt: anyOf: - type: string format: date-time - type: string nullable: true required: - walletAddress - walletType - parentWalletAddress - status - reasonCode - provider - providerReference - reportUrl - notes - rawStatus - evaluatedAt description: KYT result for a wallet screened for a secure payment description: KYT results for outgoing payout payee wallets only destination: type: object properties: destinationId: type: string description: >- Composite destination ID: ERC-7828 payee address + token address (e.g., '0x742d...bEb0@eip155:11155111#80B12379:0x370D...623C'). Omitted when payee-address fields are masked. payeeAddress: type: string description: Payee address in ERC-7828 human-readable format tokenAddress: type: string description: ERC20 token contract address walletAddress: type: string description: Raw wallet address network: type: string description: Blockchain network name isMasked: type: boolean description: >- Whether payee-address fields in this destination are intentionally masked required: - payeeAddress - tokenAddress - walletAddress - network description: >- Resolved destination for the selected request row, when stored nullable: true claimedDestination: type: object properties: destinationId: type: string description: >- Composite destination ID: ERC-7828 payee address + token address (e.g., '0x742d...bEb0@eip155:11155111#80B12379:0x370D...623C'). Omitted when payee-address fields are masked. payeeAddress: type: string description: Payee address in ERC-7828 human-readable format tokenAddress: type: string description: ERC20 token contract address walletAddress: type: string description: Raw wallet address network: type: string description: Blockchain network name isMasked: type: boolean description: >- Whether payee-address fields in this destination are intentionally masked required: - payeeAddress - tokenAddress - walletAddress - network description: >- Recipient claimed destination snapshot captured when the payout was created. Null when the recipient had no claimed destination or the row predates this snapshot. nullable: true orchestratorId: type: string description: Orchestrator ID associated with the secure payment, if any nullable: true 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: >- Fee plan snapshot persisted at secure payment creation. Immutable, so it reflects the fees that applied to the payment whether it is still pending or already completed. Null when no snapshot was stored — e.g. non-stablecoin currency, or a batch that spans multiple currencies (not yet supported). nullable: true network: type: string description: >- Request destination network. Dashboard uses this as an advisory multicall selection hint; creation and /pay still revalidate server-side. currency: type: string description: >- Request payment currency ID, when available. Null means the row predates the hint or has malformed stored currency data. nullable: true executionKind: type: string enum: - evm_same_chain - evm_cross_chain - tron_batch description: >- Per-row execution-family hint for Dashboard selection. EVM rows can form same-chain or cross-chain multicalls depending on the selected set; Tron rows can only form Tron batches. Null means unsupported or inconsistent stored route data. nullable: true identityMode: type: string enum: - manual_dashboard - client_id description: >- Backend-derived identity bucket hint for multicall selection. Dashboard may use it to prevent mixed manual/clientId selections, but creation remains authoritative. clientId: type: string description: ClientId identity bucket when identityMode is client_id. nullable: true branding: type: object properties: whitelabelEnabled: type: boolean source: type: string enum: - client_id - request_network required: - whitelabelEnabled - source description: >- Dashboard selection hint for neutral versus clientId-backed branding. Lets Dashboard distinguish neutral rows from clientId-backed rows so it can prevent mixed-branding selections at the UI level; creation remains authoritative. childExecutable: type: boolean description: >- Whether this secure-payment child currently passes creation-time child validation. blockReason: type: string enum: - not_found - not_owned - not_outgoing - not_single_payment - invalid_child_linkage - already_paid - request_processing - secure_payment_expired - secure_payment_not_pending - compliance_failed - not_payable_child description: >- Creation-validation block reason when childExecutable is false. Null when the child is currently executable. nullable: true required: - token - securePaymentUrl - status - paymentType - createdAt - expiresAt - redirectUrl - redirectLabel - completedAt - payerAddress - payerKytResults - payeeKytResults - destination - claimedDestination - orchestratorId - feePlan - network - currency - executionKind - identityMode - clientId - branding - childExecutable - blockReason examples: found: summary: Secure payment found for request value: token: 01ABC123DEF456GHI789JKL securePaymentUrl: >- https://secure.request.network/?token=01ABC123DEF456GHI789JKL status: pending paymentType: single createdAt: '2025-01-15T10:30:00.000Z' expiresAt: '2025-01-15T10:45:00.000Z' redirectUrl: https://merchant.example.com/thank-you redirectLabel: Back to merchant '401': description: Unauthorized '404': description: No secure payment found for this request ID '429': description: Too Many Requests ````