---
title: "Create individual payout"
method: POST
path: "/payout/transfer"
tags: ["payout"]
---

# Create individual payout

`POST /payout/transfer`

## Query parameters

- `preview` boolean

## Request body

- CreatePayoutTransferRequest
  - `description` string
  - `external_id` string — Id used to track the payout
  - `origin` string, uuid — The origin account Id
  - `amount` number, double — String encoded decimal number
  - `customer` union
    - InputCustomer
      - `name` string — The customer name
      - `tax_id_type` 'rfc' | 'cnpj' | 'cpf' | 'ruc' | 'curp' | 'le' | 'dni' | 'lm' | 'pas' | 'ce' | 'nit' | 'cc' | 'pa' | 'ti' | 'nuip' | 'ppt' | 'pep' | 'cuil' | 'cuit' | 'other' — The type of tax identification of the customer
      - `tax_id` string — The customer's tax identification number
      - `external_id` string, required — An external ID to identify a user. It can be the merchant's user ID or other tracking ID.
      - `withdrawal_account` CustomerAccountDetails
        - `account_number` string, required
        - `branch` string
        - `account_format` 'iban' | 'clabe' | 'cci' | 'pix' | 'bre_b' | 'alias' | 'cbu' | 'cvu' — The type of customer's account
        - `bicfi` string — The bank BICFI code
    - string, uuid — customer Id

## Response `201`

Payout created

- PayoutTransferInput
  - `id` string, uuid — Id of the payout intent
  - `origin` string, uuid — The origin account Id
  - `description` string
  - `external_id` string — Id used to track the payout
  - `fee` number, double — String encoded decimal number
  - `amount` number, double — String encoded decimal number
  - `reference` string — Id of the payout generated by the financial provider
  - `customer` InputCustomer
    - `name` string — The customer name
    - `tax_id_type` 'rfc' | 'cnpj' | 'cpf' | 'ruc' | 'curp' | 'le' | 'dni' | 'lm' | 'pas' | 'ce' | 'nit' | 'cc' | 'pa' | 'ti' | 'nuip' | 'ppt' | 'pep' | 'cuil' | 'cuit' | 'other' — The type of tax identification of the customer
    - `tax_id` string — The customer's tax identification number
    - `external_id` string, required — An external ID to identify a user. It can be the merchant's user ID or other tracking ID.
    - `withdrawal_account` CustomerAccountDetails
      - `account_number` string, required
      - `branch` string
      - `account_format` 'iban' | 'clabe' | 'cci' | 'pix' | 'bre_b' | 'alias' | 'cbu' | 'cvu' — The type of customer's account
      - `bicfi` string — The bank BICFI code

## Other responses

- `400` — Bad Request - Invalid input or malformed data
- `401` — Unauthorized access due to missing or invalid API key
- `403` — Permission denied for the requested action.
- `404` — The requested resource does not exist.
- `405` — The HTTP method used is not allowed for this endpoint.
- `406` — The Accept header cannot be satisfied.
- `415` — The request's content type is not supported.
- `429` — Too many requests, the request has been throttled.
- `500` — A generic internal API error occurred.

---

[API](https://skmtc.net/prometeoapi/apis/account-validation-v2.md) · [All operations](https://skmtc.net/prometeoapi/apis/account-validation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prometeoapi/account-validation-v2/revisions/9c278fe91cbd/schema)