curl --request POST \
  --url https://api.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
  }
}

Pay

Initiate a payment

Initiate a payment without having to create a request first. Supports both one-time and recurring payments. For recurring payments, specify the recurrence object with start date, frequency, total executions, and payer address. The system will create a recurring payment schedule and return the necessary transactions for allowance approval and signature submission. Optionally includes customer information (firstName, lastName, email, address) and a merchant reference field for checkout widget implementations and receipt tracking.

POST

payouts

curl --request POST \
  --url https://api.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

Show child attributes

payerWallet

string

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

customerInfo

object

Optional customer information for merchant receipt tracking

Show child attributes

reference

string

Merchant reference for receipt tracking and identification

Required string length: 1 - 255

Response

Request created and payment initiated successfully

requestId

string

required

Initiate a payment

Pay multiple requests in one transaction

⌘I

🔑 API Setup

⚙️ API Features

📚 API Reference

Initiate a payment

Headers

Body

Response