Get secure payment data by token

curl --request GET \
  --url https://api.request.network/v2/secure-payments/{token} \
  --header 'Origin: <origin>' \
  --header 'x-client-id: <x-client-id>'

import requests

url = "https://api.request.network/v2/secure-payments/{token}"

headers = {
    "x-client-id": "<x-client-id>",
    "Origin": "<origin>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-client-id': '<x-client-id>', Origin: '<origin>'}};

fetch('https://api.request.network/v2/secure-payments/{token}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.request.network/v2/secure-payments/{token}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Origin: <origin>",
    "x-client-id: <x-client-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.request.network/v2/secure-payments/{token}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-client-id", "<x-client-id>")
	req.Header.Add("Origin", "<origin>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.request.network/v2/secure-payments/{token}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-client-id"] = '<x-client-id>'
request["Origin"] = '<origin>'

response = http.request(request)
puts response.read_body

{
  "paymentType": "single",
  "payee": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
  "network": "sepolia",
  "amount": "10000000000000000000",
  "paymentCurrency": "FAU-sepolia",
  "status": "pending",
  "destination": {
    "destinationId": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7@eip155:11155111#A1B2C3D4:0x370DE27fdb7D1Ff1e1BaA7D11c5820a324Cf623C",
    "payeeAddress": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7@eip155:11155111#A1B2C3D4",
    "tokenAddress": "0x370DE27fdb7D1Ff1e1BaA7D11c5820a324Cf623C",
    "walletAddress": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
    "network": "sepolia"
  },
  "reference": "INV-2025-001"
}

GET

secure-payments

{token}

Get secure payment data by token

curl --request GET \
  --url https://api.request.network/v2/secure-payments/{token} \
  --header 'Origin: <origin>' \
  --header 'x-client-id: <x-client-id>'

import requests

url = "https://api.request.network/v2/secure-payments/{token}"

headers = {
    "x-client-id": "<x-client-id>",
    "Origin": "<origin>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-client-id': '<x-client-id>', Origin: '<origin>'}};

fetch('https://api.request.network/v2/secure-payments/{token}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.request.network/v2/secure-payments/{token}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Origin: <origin>",
    "x-client-id: <x-client-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.request.network/v2/secure-payments/{token}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-client-id", "<x-client-id>")
	req.Header.Add("Origin", "<origin>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.request.network/v2/secure-payments/{token}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-client-id"] = '<x-client-id>'
request["Origin"] = '<origin>'

response = http.request(request)
puts response.read_body

{
  "paymentType": "single",
  "payee": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
  "network": "sepolia",
  "amount": "10000000000000000000",
  "paymentCurrency": "FAU-sepolia",
  "status": "pending",
  "destination": {
    "destinationId": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7@eip155:11155111#A1B2C3D4:0x370DE27fdb7D1Ff1e1BaA7D11c5820a324Cf623C",
    "payeeAddress": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7@eip155:11155111#A1B2C3D4",
    "tokenAddress": "0x370DE27fdb7D1Ff1e1BaA7D11c5820a324Cf623C",
    "walletAddress": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
    "network": "sepolia"
  },
  "reference": "INV-2025-001"
}

Headers

x-client-id

string

required

Client ID for frontend authentication

Origin

string

required

Origin header (automatically set by browser)

Path Parameters

token

string

required

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.

Query Parameters

token

enum<string>

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.

Available options:

USDC,

USDT,

EURC,

USDT0

wallet

string

The wallet address of the payer (optional, used to check existing approvals)

chain

enum<string>

The source chain of the crosschain payment

Available options:

BASE,

OPTIMISM,

ARBITRUM,

ETHEREUM,

POLYGON,

BNB

eoaWallet

string

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

isSafe

enum<string>

When true, prepares calldata for a Gnosis Safe multisig payer (wallet must be the Safe address). Mutually exclusive with eoaWallet.

Available options:

true,

false

Response

Secure payment data retrieved successfully

Option 1
Option 2
Option 3
Option 4

paymentType

enum<string>

required

Type of payment: single or batch

Available options:

single

status

enum<string>

required

Available options:

pending,

completed,

expired,

invalidated,

compliance_failed

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.

branding

object | null

required

Show child attributes

requestIds

string[]

required

Request Network request IDs represented by this payment

payee

string

required

Payee wallet address

network

string

required

Blockchain network

amount

string

required

Payment amount

paymentCurrency

string

required

Payment currency ID

isNativeCurrency

boolean

required

Whether the payment currency is the native currency (e.g., ETH)

destination

object | null

required

Resolved destination for this payment, or null when the payment is not linked to a stored destination (e.g., payouts created from raw recipient details).

Show child attributes

reference

string | null

required

Merchant reference for the payment

feePlan

object | null

required

Fee plan snapshot captured at creation time. Null when fees don't apply (non-stablecoin currency, payment created before fee plan rollout, etc.).

Show child attributes

orchestratorId

string | null

Orchestrator ID associated with the secure payment, if any

paymentOptions

object

Show child attributes

analytics

object

Vendor-neutral analytics metadata that SPP maps into Mixpanel shared properties. Amount values are decimal USD strings to avoid frontend precision loss.

Show child attributes

isPayeeAddressMasked

boolean

Whether payee-address fields are intentionally masked until access is approved

accessDecision

object

Show child attributes

Create a batch secure payment for multiple outgoing payouts

Get secure payment calldata by token

⌘I

🔑 API Setup

⚙️ API Features

📚 API Reference

Get secure payment data by token

Headers

Path Parameters

Query Parameters

Response