---
title: "POST /payout/create"
method: POST
path: "/payout/create"
tags: ["Payout"]
---

# POST /payout/create

`POST /payout/create`

## Create a payOut

 Create a single payout given a  payout object

## Query parameters

- `authorization` string, required
- `signPayOut` boolean

## Request body

- CreaateSelfPayOut — (tsType: CreateSelfPayOutInput, schemaOptions: { title: 'CreaateSelfPayOut' })
  - `Amount` number, required
  - `bankAccount` string, required
  - `bankAccountType` string, required
  - `bankBaseId` number, required
  - `beneficiaryName` string, required
  - `companyId` number, required
  - `companyProductId` number, required
  - `currencyId` number
  - `documentNumber` unknown, required
  - `documentTypeId` number, required
  - `externalIdentifier` string
  - `metaData` object
  - `expiresAt` string, date-time
  - `email` string
  - `phone` string

## Response `200`

## Create a payOut with bank transfer 

Create one payout given a company id, company product id

- PayOut
  - `id` number
  - `active` boolean
  - `Amount` number, required
  - `AmountUsd` number
  - `bankAccount` string, required
  - `bankAccountType` string, required
  - `bankBaseId` number, required
  - `beneficiaryName` string, required
  - `companyId` number
  - `companyProductId` number, required
  - `currencyId` number, required
  - `deleted` boolean
  - `documentNumber` unknown, required
  - `documentTypeId` number, required
  - `externalIdentifier` string, required
  - `metaData` object
  - `reversedAt` string, date-time
  - `startedProcessAt` string, date-time
  - `state` string
  - `trasnferedAt` string, date-time
  - `userId` number, required
  - `validatedAt` string, date-time
  - `uid` string

## Other responses

- `202` — ## Create single cashOut payOut Creates a single payout to be withdrawn in cash at a physical point To consult the available physical points in your region, please consult the endpoint /physical-point/{country}. expiresAt [optional: The payout will expire at the indicated date, if the payout is not withdrawn before the expiration date, the payout will be rejected and the money will be returned to the company balance. * expriresAt must be in the format YYYY-MM-DD * expiresAt must be 2 h greater than the current date and less than 24 hr from the current date * expiresAt is optional and only applies to bankAccountType: @cash * if expiresAt is not set, the payout will expire in 2 hours ### Example input: To indicate that a dispersion will be withdrawn through a physical point, the bankbaseId must correspond to the ID of the Cash EC bank that belongs to the country where the dispersion will be made (consult the /banks endpoint, see id key). in the following example the input "bankBaseId": 48 corresponds to the id of the ecuador bank cashOut ec to be able to make withdrawals in physical point. Alert: The bankBaseId must be the id of the cash ec bank of the country where the dispersion will be made. Values in the example are for demonstration purposes only and may be diferent for your country in production. (consult the /banks endpoint in production) The response is an object will contain the id of the payout and the externalIdentifier of the payout, which is unique for each payout. The payout will have a state that will indicate the status of the payout, the state can be one of the following: * RECEIVED: The payout has been received, this state is the initial state of the payout. Indicates that the payout has been received by the system. * SCHEDULED: The payout has been scheduled this state is set when the payout is scheduled to be delivered. Make sure to put the user's full name and surname in the benefciaryName parameters, as well as set the appropriate document type documentTypeId ( endpoint documentTypes see id key) The ```bankAccount``` should be set as ```@cash``` and ```"bankAccountType": "ahorros"```. See the following input example: ~~~{ "Amount": 200, "bankBaseId": 48, "bankAccountType": "ahorros", "bankAccount": "@cash", "beneficiaryName": "John Doe", "companyId": 13, "companyProductId": 20, "currencyId": 2, "documentTypeId": 4, "documentNumber": 123456789, "externalIdentifier": "physical-ABC1", "expiresAt": "2025-10-30T18:00:00.000Z", "metaData": {}

---

[API](https://skmtc.dev/loopay/apis/loopay-api.md) · [All operations](https://skmtc.dev/loopay/apis/loopay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loopay/loopay-api/revisions/2f7c6537d598/schema)