---
title: "Create bank payout"
method: POST
path: "/money/payouts"
tags: ["money", "payouts"]
---

# Create bank payout

`POST /money/payouts`

Initiates a bank payout for an existing quote. Gated on PermKYBLocked + PermFundsWithdraw.

## Headers

- `Idempotency-Key` string, required — Required client idempotency key; a duplicate submission with the same key is rejected with 409.

## Request body

- PayoutsCreatePayoutInput
  - `purpose` 'supplier' | 'payroll' | 'physical_goods' | 'digital_goods' | 'other_services' | 'property_rental' | 'logistics' | 'taxes' | 'insurance' | 'remittances' | 'investment' | 'charity_donation' | 'tuition_costs' | 'medical_care' | 'family_maintenance' | 'pension' | 'utility_provider' | 'public_services' | 'property_purchase' | 'travel' | 'tourism_expense' | 'entertainment' | 'affiliation_programs' | 'rewards' | 'savings_retirement' | 'investment_interest' | 'shares' | 'availability' | 'capital_contribution', required
  - `quote_id` string

## Response `200`

OK

- PayoutsCreatePayoutOutput
  - `complete` boolean
  - `created_ts` string, date-time
  - `money_movement_id` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `501` — Not Implemented
- `default` — Error response.

## Changes

- **2026-09-01** `f2d9f80610d9` — 6 info
  - added the optional property `error/api_client_id` to the response with the `400` status
  - added the optional property `error/api_client_id` to the response with the `401` status
  - added the optional property `error/api_client_id` to the response with the `403` status
  - added the optional property `error/api_client_id` to the response with the `404` status
  - …2 more
- **2026-08-06** `fe2041c5ba86` — 1 breaking
  - added the pattern `^qt_[0-7][0-9a-hjkmnp-tv-z]{25}$` to the request property `quote_id`

[Change history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/money/payouts/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) · [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stablesea/stable-sea-backend/revisions/0a6aeb726c1f/schema)