---
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`

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/payment/validate-parameters`
- Auth: API key in header `x-access-token`

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.
  - `fileIds` string[]: Supporting trade relationship documents required for compliance verification (e.g. invoices, commercial contracts, purchase orders, or bills of lading). Supports up to 5 files. Each file must not exceed 20 MB. Supported file formats: PDF, JPG, JPEG, PNG, ZIP, RAR, XLSX, and XLS. Note: - Mandatory for Non-Same-Name Payouts. - Optional for Same-Name Payouts (including payouts to verified Legal Representatives or UBOs of the sending entity).

## 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.dev/interlace/apis/business-transfer.md) - [All operations](https://skmtc.dev/interlace/apis/business-transfer/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/business-transfer/revisions/9bf171b6fb7f?raw)