Skip to main content
GET
/
v2
/
request
/
{requestId}
/
pay
Get payment calldata
curl --request GET \
  --url https://api.stage.request.network/v2/request/{requestId}/pay
{
  "transactions": [
    {
      "data": "0xb868980b...00",
      "to": "0x11BF2fDA23bF0A98365e1A4e04A87C9339e8687",
      "value": {
        "type": "BigNumber",
        "hex": "0x038d7ea4c68000"
      }
    }
  ],
  "metadata": {
    "stepsRequired": 1,
    "needsApproval": false,
    "approvalTransactionIndex": null,
    "hasEnoughBalance": true,
    "hasEnoughGas": true
  }
}

Headers

​
x-api-key
string

API key for authentication (optional if using Client ID)

​
x-client-id
string

Client ID for frontend authentication (optional if using API key)

​
Origin
string

Origin header (required for Client ID auth, automatically set by browser)

Path Parameters

​
requestId
string
required

The requestId of the request

Example:

"01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb"

Query Parameters

​
wallet
string

The wallet address of the payer.

Example:

"0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7"

​
chain
enum<string>

The source chain of the crosschain payment

Available options:
BASE,
OPTIMISM,
ARBITRUM,
ETHEREUM
​
token
enum<string>

The source token of the crosschain payment

Available options:
USDC,
USDT,
DAI
​
amount
string

The amount to pay, in human readable format

​
clientUserId
string

Optional client user ID for off-ramp payments

Example:

"user-123"

​
paymentDetailsId
string

Optional payment details ID for off-ramp payments

Example:

"fa898aec-519c-46be-9b4c-e76ef4ff99d9"

​
feePercentage
string

Fee percentage to apply at payment time (e.g., '2.5' for 2.5%)

Example:

"0.02"

​
feeAddress
string

Address to receive the fee

Example:

"0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7"

Response

Payment calldata retrieved successfully

  • Same-chain Payment Response
  • Crosschain Payment Response

Response for same-chain payments with transaction calldata

​
transactions
object[]
required

Array of transactions to execute for the payment

​
metadata
object
required

Metadata about the payment requirements

⌘I