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

# POST /payouts/create

`POST /payouts/create`

## Create payOuts

Create several payouts given a company id, company product id and a data array of payout objects

## Query parameters

- `authorization` string, required
- `signPayOuts` boolean

## Request body

- object
  - `companyId` number
  - `companyProductId` number
  - `data` object[]
    - `Amount` number
    - `bankAccount` string — Bank account number
    - `bankAccountType` string
    - `bankBaseId` number
    - `beneficiaryName` string
    - `documentTypeId` number
    - `documentNumber` integer
    - `externalIdentifier` string

## Response `200`

## Create payOuts with bank transfers 

Create several payouts given a company id, company product id and a data array of payout objects.

- object[]
  - `id` number — PayOut id
  - `externalIdentifier` string — PayOut externalIdentifier is unique field
  - `Amount` number — PayOut amount
  - `bankBaseId` number — PayOut bankBaseId
  - `bankAccountType` string — PayOut bankAccountType
  - `bankAccount` string — Bank account number
  - `beneficiaryName` string — PayOut beneficiaryName
  - `documentTypeId` number — Beneficiary documentTypeId
  - `documentNumber` integer — Beneficiary documentNumber
  - `state` string — PayOut state

## Other responses

- `202` — ## Create cashOut payOuts Creates several payouts 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}. ### 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. The response will be an array of objects where each object will contain the id of the payout and the externalIdentifier of the payout, which is unique for each payout. Each 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: ~~~{ "companyId": 13, "companyProductId": 20, "data": [ { "Amount": 1000, "bankBaseId": 48, "bankAccountType": "ahorros", "bankAccount": "@cash", "beneficiaryName": "John Doe", "documentTypeId": 4, "documentNumber": 123456789, "externalIdentifier": "physical-1" } ]

---

[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)