---
title: "Initiate a payment"
method: POST
path: "/v2/payouts"
tags: ["Pay", "V2/Payouts"]
---

# Initiate a payment

`POST /v2/payouts`

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.

## Headers

- `x-api-key` string
- `x-client-id` string
- `Origin` string

## Request body

- object
  - `payee` string, required — The wallet address of the payee (Ethereum 0x... or TRON T...)
  - `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](https://docs.request.network/general/request-network-token-list) e.g: USD
  - `paymentCurrency` string, required — Payment currency ID, from the [Request Network Token List](https://docs.request.network/general/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 (Ethereum 0x... or TRON T...)
  - `recurrence` object — Configuration details for recurring payments
    - `startDate` string, required — The start date of the payment, cannot be in the past
    - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', required — The frequency of the payment
    - `totalPayments` number, required — The total number of times the payment will be executed (max 256).
    - `payer` string, required — The wallet address of the payer. Cannot be the same as the payee address.
  - `payerWallet` string — The wallet address of the payer, use to check if payer approval exists
  - `payerAddress` string — The wallet address of the payer (alias for payerWallet)
  - `customerInfo` object — Optional customer information for merchant receipt tracking
    - `firstName` string — Customer's first name
    - `lastName` string — Customer's last name
    - `email` string, email — Customer's email address
    - `address` object — Customer's address
      - `street` string — Street address
      - `city` string — City
      - `state` string — State or province
      - `postalCode` string — Postal or ZIP code
      - `country` string — Country code (ISO 3166-1 alpha-2)
  - `reference` string — Merchant reference for receipt tracking and identification

## Response `201`

Request created and payment initiated successfully

- object
  - `requestId` string, required

## Other responses

- `404` — Wallet not found
- `429` — Too Many Requests

---

[API](https://skmtc.dev/request/apis/request-network-api.md) · [All operations](https://skmtc.dev/request/apis/request-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/request/request-network-api/revisions/042a895ac0c6/schema)