Skip to main content
POST
/
v2
/
payouts
curl --request POST \
  --url https://api.stage.request.network/v2/payouts \
  --header 'Content-Type: application/json' \
  --data '{
  "payee": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
  "amount": "10",
  "invoiceCurrency": "USD",
  "paymentCurrency": "ETH-sepolia-sepolia",
  "feePercentage": "0.02",
  "feeAddress": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7"
}'
{
  "requestId": "01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb",
  "paymentReference": "0xb3581f0b0f74cc61",
  "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)

Body

application/json
​
payee
string
required

The wallet address of the payee

​
amount
string
required

The payable amount of the invoice, in human readable format

​
invoiceCurrency
string
required

Invoice Currency ID, from the Request Network Token List e.g: USD

​
paymentCurrency
string
required

Payment currency ID, from the Request Network Token List e.g: ETH-sepolia-sepolia

​
feePercentage
string

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

​
feeAddress
string

Address to receive the fee

​
recurrence
object

Configuration details for recurring payments

​
payerWallet
string

The wallet address of the payer, use to check if payer approval exists

​
customerInfo
object

Optional customer information for merchant receipt tracking

​
reference
string

Merchant reference for receipt tracking and identification

Required string length: 1 - 255

Response

Request created and payment initiated successfully

​
requestId
string
required
⌘I