---
title: "Check a payout"
method: POST
path: "/open-api/v3/payment/validate-parameters"
tags: ["Payouts"]
---

# Check a payout

`POST /open-api/v3/payment/validate-parameters`

Verifies the details of a payout request, including the amount, currency, beneficiary, rate, source of funds, and fee handling method, before execution.

## Request body

- CheckPayoutParamReqDTO
  - `accountId` string, required — The UUID of the account.
  - `clientTransactionId` string, uuid, required — Universally unique identifier (UUID v4) client transaction id. This key is utilized to ensure exactly-once execution of mutating requests.
  - `rateId` string, required — Rate id
  - `payeeId` string, required — Beneficiary ID
  - `balanceId` string, required — A source of funds.
  - `memo` string — Transfer remarks and remarks
  - `reason` string — Reason and purpose, Deprecated
  - `purposeId` string — ID of the payout purpose, obtained from the /purposes endpoint.
  - `amount` string, required — Amount.
  - `amountType` 'PAY' | 'COLLECT', required — With the amount and currency, either the payment amount or the received amount can be used to verify the payout.
  - `feeMode` 'OUR' | 'SHA', required — Handling fee bearing method: - OUR: The payer bears all fees, and the beneficiary receives the full amount. - SHA: The payer and the beneficiary share the fees. The beneficiary will receive the amount minus the beneficiary bank's charges. Note: This field is mandatory for SWIFT transfers.

## Response `200`

OK

- CheckPayoutRespDTO
  - `code` string — Error code
  - `message` string — Error message
  - `data` CheckPayoutParamRespDTO, required — data
    - `clientTransactionId` string, uuid, required — Universally unique identifier (UUID v4) client transaction id. This key is utilized to ensure exactly-once execution of mutating requests.
    - `id` string — Pre check record ID
    - `pass` boolean — Check if it passes
    - `detailMessage` string — DetailMessage

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/interlace/apis/core-resource.md) · [All operations](https://skmtc.net/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)