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.

GET /v2/secure-payments

Find secure payment by request ID

cURL

curl --request GET \
  --url https://api.request.network/v2/secure-payments \
  --header 'Authorization: <authorization>'

200

{
  "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"
}

Headers

Authorization · string · required

Bearer token for session authentication (or use session_token cookie)

Query Parameters

requestId · string · required

Request ID to look up the associated secure payment

Response

200

application/json

Secure payment found

token · string · required

Secure payment token

securePaymentUrl · string<uri> · required

URL to the secure payment page

status · enum<string> · required

Current status of the secure payment

Available options: pending, completed, expired, invalidated, compliance_failed

paymentType · enum<string> · required

Type of payment: single or batch

Available options: single, batch

createdAt · string<date-time> | null · required

When the secure payment was created

expiresAt · string<date-time> · required

When the secure payment token expires

redirectUrl · string | null · required

Optional redirect URL configured at creation time. Null when no redirect was set.

redirectLabel · string | null · required

Optional label describing the redirect destination. Null when no label was provided.

completedAt · string<date-time> | null · required

When the secure payment was completed

payerAddress · string | null · required

Detected payer address for the completed secure payment

payerKytResults · object[] · required

KYT results for the actual detected payer wallets only

Show child attributes

payeeKytResults · object[] · required

KYT results for outgoing payout payee wallets only

Show child attributes

destination · object | null · required

Resolved destination for the selected request row, when stored

Show child attributes

claimedDestination · object | null · required

Recipient claimed destination snapshot captured when the payout was created. Null when the recipient had no claimed destination or the row predates this snapshot.

Show child attributes

orchestratorId · string | null · required

Orchestrator ID associated with the secure payment, if any

feePlan · object | null · required

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

Show child attributes

network · string · required

Request destination network. Dashboard uses this as an advisory multicall selection hint; creation and /pay still revalidate server-side.

currency · string | null · required

Request payment currency ID, when available. Null means the row predates the hint or has malformed stored currency data.

executionKind · enum<string> | null · required

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.

Available options: evm_same_chain, evm_cross_chain, tron_batch

identityMode · enum<string> · required

Backend-derived identity bucket hint for multicall selection. Dashboard may use it to prevent mixed manual/clientId selections, but creation remains authoritative.

Available options: manual_dashboard, client_id

clientId · string | null · required

ClientId identity bucket when identityMode is client_id.

branding · object · required

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.

Show child attributes

childExecutable · boolean · required

Whether this secure-payment child currently passes creation-time child validation.

blockReason · enum<string> | null · required

Creation-validation block reason when childExecutable is false. Null when the child is currently executable.

Available options: 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