# Initiates a payout to a payee.

The payout is processed asynchronously. Use GET /v1/payouts/{id} to check its status.

Required fields: PayeeId, Amount, Currency.

Optional field: Description.

MerchantId is automatically obtained from the authenticated user.

Endpoint: POST /v1/payouts
Security: Bearer

## Request fields (application/json):

  - `payeeId` (integer, required)

  - `payeeAccountId` (integer, required)

  - `destinationCurrency` (string, required)

  - `amount` (integer, required)

  - `note` (string,null)

## Response 201 fields (text/plain):

  - `payoutUniqueReference` (string,null)

  - `payoutId` (string,null)

  - `payoutAccountId` (string,null)

  - `payeeId` (string)

  - `amount` (number)

  - `currencyCode` (string,null)

  - `state` (string,null)

  - `description` (string,null)

  - `merchantId` (string,null)

  - `paymentDate` (string,null)

  - `payeeDetails` (object)

  - `payeeDetails.id` (integer)
    Example: 174

  - `payeeDetails.payeeType` (string,null)
    Example: "INDIVIDUAL|BUSINESS|BRAID"

  - `payeeDetails.name` (string,null)

  - `payeeDetails.email` (string,null)

  - `payeeDetails.phoneNumber` (string,null)

  - `payeeDetails.taxId` (string,null)

  - `payeeDetails.businessName` (string,null)
    Example: "ABC Private ltd"

  - `payeeDetails.businessType` (string,null)

  - `payeeDetails.nationality` (string,null)
    Example: "USA"

  - `payeeDetails.idType` (string,null)
    Example: "SSN"

  - `payeeDetails.currency` (string,null)
    Example: "USD"

  - `payeeDetails.address` (object)

  - `payeeDetails.address.addressLine` (string,null)

  - `payeeDetails.address.city` (string,null)

  - `payeeDetails.address.country` (string,null)

  - `payeeDetails.address.postalCode` (string,null)

  - `payeeDetails.dateOfBirth` (string,null)

  - `payeeDetails.isActive` (boolean)

  - `payoutAccountDetails` (object)

  - `payoutAccountDetails.accountNumber` (string,null)

  - `payoutAccountDetails.bankName` (string,null)

## Response 400 fields (text/plain):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

## Response 404 fields (text/plain):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)