---
title: "Initiate CNY Payout"
method: POST
path: "/disbursements/payouts"
---

# Initiate CNY Payout

`POST /disbursements/payouts`

## Request

- Base URL: `https://sandboxapi.fincra.com`
- URL: `https://sandboxapi.fincra.com/disbursements/payouts`
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/fincra/apis/awesome-new-api/docs/disbursements/payouts/post.ts> (a function with typed inputs; its response is checked against the schema)

This API lets you make payouts to China using CNY or CNH currencies.

## Request body

- object
  - `sourceCurrency` 'USDT' | 'GHS' | 'KES' | 'UGX' | 'TZS' | 'USD' | 'EUR' | 'GBP' | 'ZMW' | 'ZAR' | 'USDC' | 'CNGN' | 'NGN' | 'XAF' | 'XOF', required: The currency which is used to fund the payout
  - `destinationCurrency` 'CNY' | 'CNH', required: The currency in which the recipient will be receiving funds
  - `amount` number, required: The value that is to be transferred from the source currency wallet.
  - `business` string, required: Your unique business ID
  - `description` string: The description of the payout
  - `customerReference` string, required: The transaction's unique identifier on your system. Customer references prevent duplicate transactions.
  - `paymentDestination` 'bank_account', required: Payment destination type
  - `paymentScheme` 'cnaps' | 'swift', required: The payment scheme relevant to the destination currency payment network. "cnaps" supports only CNY, while "swift" supports CNY and CNH.
  - `quoteReference` string: This is the reference generated for FX quote. Required for cross-currency payouts (e.g. NGN→CNY); optional only when source and destination currency match.
  - `beneficiary` object, required: The recipient of the payout.
    - `firstName` string, required: The recipient's first name.
    - `lastName` string: The recipient's last name.
    - `accountHolderName` string, required: The name on the recipient's bank account. (must be in Chinese)
    - `type` 'individual' | 'corporate', required: Whether the recipient is an individual or a corporate entity.
    - `accountNumber` string, required: The recipient's bank account number.
    - `bankSwiftCode` string: The recipient bank's code. Required for `bank_account` payouts.
    - `phone` string: The recipient's phone number.
    - `incorporationCountry` string: Country where the business is incorporated
    - `bankAddress` object, required: Full address object of the recipient's bank
      - `country` string, required
      - `state` string, required
      - `zip` string, required
      - `city` string, required
      - `street` string, required
    - `address` object, required: Recipient's address
      - `country` string, required
      - `state` string, required
      - `zip` string, required
      - `city` string, required
      - `street` string, required
  - `feeBearer` 'business'
  - `purposeOfFund` 'goods_trade' | 'services_trade' | 'payment_for_services' | 'professional_services' | 'information_services' | 'transportation_services' | 'software_purchase' | 'construction_services' | 'employee_payroll', required: Reason for payment
  - `files` string[], required: Supporting document URLs for the payment.
  - `relationshipWithBeneficiary` 'self' | 'parents' | 'child' | 'siblings' | 'other_relatives' | 'spouse' | 'ex_spouse' | 'vendor' | 'supplier' | 'employee' | 'friends' | 'business_partner' | 'customer' | 'agent' | 'creditor' | 'debtor' | 'subsidiary_company' | 'branch_office' | 'holding_company' | 'franchisee', required: Relationship type between sender and beneficiary
  - `sender` object, required: Ultimate sender/payer details
    - `type` 'corporate' | 'individual', required
    - `name` string, required: Ultimate sender name
    - `email` string, required: Ultimate sender email address
    - `phone` string, required: Ultimate sender phone number (e.g. +2341234567890)
    - `nationality` string: Country code in ISO-3166-alpha-2 (required for individual senders only)
    - `address` object, required: Full address of the ultimate sender
      - `country` string, required: Country code in ISO-3166-alpha-2
      - `state` string, required
      - `zip` string, required
      - `city` string, required
      - `street` string, required
    - `idType` 'national_id' | 'international_passport' | 'drivers_license' | 'business_registration_number', required: Type of identification
    - `idNumber` string, required: Identification number of the selected idType
    - `countryOfIncorporation` string: Country code in ISO-3166-alpha-2 (required for corporate senders only)

## Response `200`

200

- object
  - `success` boolean, required
  - `message` string
  - `data` object
    - `id` integer
    - `reference` string
    - `customerReference` string
    - `status` string
    - `documentsRequired` object[]

## Other responses

- `422`: 422

## Changes

- **2026-11-03** `526b1509a02d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fincra/apis/awesome-new-api/changes/disbursements/payouts/post.md)

---

[API](https://skmtc.dev/fincra/apis/awesome-new-api.md) - [All operations](https://skmtc.dev/fincra/apis/awesome-new-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fincra/apis/awesome-new-api/revisions/526b1509a02d?raw)