Skip to main content
POST
Record secure payment intent

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

Body

application/json
chain
enum<string>
required
Available options:
BASE,
OPTIMISM,
ARBITRUM,
ETHEREUM,
POLYGON,
BNB
token
enum<string>
required
Available options:
USDC,
USDT,
EURC,
USDT0
txHash
string
Required string length: 66
Pattern: ^0x[a-fA-F0-9]{64}$
safeTxHash
string
Required string length: 66
Pattern: ^0x[a-fA-F0-9]{64}$
executionKind
enum<string>
Available options:
evm_same_chain,
evm_cross_chain
safePaymentDeadline
integer

Unix seconds — hard on-chain execution deadline for the Safe + LiFi route. Only valid alongside safeTxHash; used to stop monitoring once crossed.

Required range: x > 0
payerAddress
string
payerEoaAddress
string
sourceNetwork
enum<string>
Available options:
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
string
sourceAmount
string
routeKind
enum<string>
Available options:
same_chain,
same_chain_conversion,
crosschain
bridgeTool
enum<string> | null
Available options:
across,
stargate

Response

Intent recorded successfully

intentId
string
required

Tracking intent ID created or reused

paymentReference
string
required

Payment reference associated with the tracked request

isListening
boolean
required

Whether the tracking intent is being monitored for status

txHash
string

Recorded source-chain transaction hash

safeTxHash
string

Recorded Safe transaction hash pending on-chain execution

safePaymentDeadline
integer

Recorded Unix-seconds execution deadline for the Safe + LiFi route, when provided

Required range: x > 0
payerAddress
string