---
title: "Submit payout"
method: POST
path: "/api/fma/v1/submit-payout"
tags: ["Managed Custody Mode"]
---

# Submit payout

`POST /api/fma/v1/submit-payout`

Send tokenized fiat from the user's UR account to an external bank account via SEPA or SWIFT. Requires a Live UR account; fees are deducted from the amount, and the payout counts against the rolling 30-day CHF-denominated fiat limit. The response returns only a txHash; the transaction webhook with data.type FIAT_WITHDRAW reports final settlement.

## Headers

- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string, required
- `X-Ur-Id` string
- `X-External-User-Id` string

## Request body

- McSubmitPayoutRequest
  - `reqId` string, required — Partner-supplied idempotency key. Keep it stable across retries of the same logical operation.
  - `amount` string, required — Payout amount as a string. Minimum is currency-specific; see minimalPayoutAmount from the payout fees endpoint. Network and payout fees are deducted from this amount.
  - `contactId` string, required — Contact ID from the BR profile contacts or from verify-contact.
  - `currency` string, required — Payout fiat currency symbol.
  - `purposeId` string — Payment purpose ID as a decimal string. Provide together with refId, or omit both.
  - `refId` string — Reference ID from verify-reference or verify-contact. Provide together with purposeId, or omit both.
  - `metadata` McPayoutMetadata, required — Additional bank details. Name, address, and reference values must use Latin characters.
    - `bankAccountHolder` string — Recipient account holder name.
    - `bankName` string — Recipient bank name.
    - `bankAccount` string — Recipient account number or IBAN.
    - `bankReference` string — Bank reference.

## Response `200`

Standard envelope. Business errors return HTTP 200 with a non-zero code.

- McTxHashResponse — Standard UR OpenAPI response envelope. code 0 means success; a non-zero code is a business error described by message.
  - `code` integer, required — 0 on success; non-zero business error code.
  - `message` string, required — Human-readable explanation. May be empty on success.
  - `data` McTxHashData
    - `txHash` string — On-chain transaction hash of the submitted operation. Submission only; final settlement arrives via the transaction webhook.

---

[API](https://skmtc.net/ur/apis/ur-api.md) · [All operations](https://skmtc.net/ur/apis/ur-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ur/ur-api/revisions/087dcf516ce2/schema)