---
title: "POST /api/affiliate/payouts"
method: POST
path: "/api/affiliate/payouts"
tags: ["Affiliate"]
---

# POST /api/affiliate/payouts

`POST /api/affiliate/payouts`

## Request

- Base URL: `https://nowyourlink.com`
- URL: `https://nowyourlink.com/api/affiliate/payouts`
- Auth: API key in cookie `nyl_sess`

Reserves available commissions, or retries the selected owned returned bank payout, and starts an idempotent payout Workflow. Pending/transferred does not mean paid to a bank.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `payoutId` string, uuid: Retry this owned returned bank payout using its original Stripe transfer.

## Response `202`

Own partner data. Amounts are EUR cents. Cache-Control: no-store.

- object
  - `id` string, required
  - `amount_cents` integer, required
  - `currency` 'eur', required
  - `status` 'pending' | 'transferred' | 'paid' | 'failed', required
  - `bank_retry_allowed` boolean
  - `failure_code` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: Invalid query, body or idempotency key.
- `401`: Session or delegated OAuth token required.
- `403`: Missing scope, inactive partner, unverified account or invalid Origin.
- `404`: Partner account is not activated.
- `409`: Payout threshold or Stripe verification requirements not met.
- `502`: Stripe unavailable. Retry the same request key after reconciliation.
- `503`: Integration not configured.

---

[API](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api.md) · [All operations](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/revisions/cd8408529b48?raw)