---
title: "Crear una solicitud de PayOut"
method: POST
path: "/payouts"
tags: ["Payout"]
---

# Crear una solicitud de PayOut

`POST /payouts`

## Request

- Base URL: `https://sandbox-virtual-accounts.prontopaga.com/api`
- URL: `https://sandbox-virtual-accounts.prontopaga.com/api/payouts`
- Auth: API key in header `Authorization`

## Request body

- CreatePayoutRequestBody
  - `accountNumber` string, required: Número de cuenta interna Prontopaga, la cuenta determina la Moneda del payout
  - `amount` number, required: Monto solicitado para el payout
  - `beneficiary` union, required: Datos del beneficiario del payout
    - object
      - `bankAccount` PayOutBankAccount, required: Apellido del beneficiario. Requerido si el type es individual
        - `accountNumber` string, required: Número de la cuenta bancaria de destino. Ten en cuenta que en Perú, si el banco de destino es AlfinBanco, envía el número de cuenta. Si el banco de destino es cualquier otro banco, envía el CCI (número de cuenta interbancaria).
        - `accountType` 'savings' | 'current': Tipo de cuenta
        - `bankName` string: Nombre de la entidad bancaria de destino
        - `currency` 'CLP' | 'PEN' | 'USD', required: Moneda de la cuenta destino
      - `document` BeneficiaryDocument, required: Documento del beneficiario/representante legal
        - `id` string, required: Número de documento de identidad
        - `type` 'ruc' | 'rut' | 'run' | 'dni' | 'ce' | 'passport' | 'other', required: El tipo de documento de identidad, como un número de identificación nacional, número de seguro social o licencia de conducir, dependiendo del país de emisión
      - `lastName` string: Apellido del beneficiario. Requerido si el type es individual
      - `name` string, required: Nombre del beneficiario/representante legal
      - `type` 'individual', required: Tipo de beneficiario
    - object
      - `bankAccount` PayOutBankAccount, required: Apellido del beneficiario. Requerido si el type es individual
        - `accountNumber` string, required: Número de la cuenta bancaria de destino. Ten en cuenta que en Perú, si el banco de destino es AlfinBanco, envía el número de cuenta. Si el banco de destino es cualquier otro banco, envía el CCI (número de cuenta interbancaria).
        - `accountType` 'savings' | 'current': Tipo de cuenta
        - `bankName` string: Nombre de la entidad bancaria de destino
        - `currency` 'CLP' | 'PEN' | 'USD', required: Moneda de la cuenta destino
      - `document` BeneficiaryDocument, required: Documento del beneficiario/representante legal
        - `id` string, required: Número de documento de identidad
        - `type` 'ruc' | 'rut' | 'run' | 'dni' | 'ce' | 'passport' | 'other', required: El tipo de documento de identidad, como un número de identificación nacional, número de seguro social o licencia de conducir, dependiendo del país de emisión
      - `lastName` string: Apellido del beneficiario. Requerido si el type es individual
      - `name` string, required: Nombre del beneficiario/representante legal
      - `type` 'company', required: Tipo de beneficiario
  - `comment` string: Información adicional o referencia del payout
  - `referenceId` string: Identificador único que debe proporcionar el cliente para etiquetar y rastrear payout dentro de su sistema

## Response `201`

201 response

- CreatePayoutResponse
  - `accountNumber` string, required: Número de cuenta interna Prontopaga, la cuenta determina la Moneda del payout
  - `amount` number, required: Monto solicitado para el payout
  - `createdAt` string, required: Fecha y hora de creación de la solicitud
  - `currency` string, required: Moneda del payout
  - `payoutId` string, required: Identificador interno del payout generado por ProntoPaga
  - `referenceId` string: Identificador único que debe proporcionar el cliente para etiquetar y rastrear payout dentro de su sistema
  - `status` string, required: Estado inicial del payout

## Other responses

- `400`: 400 response
- `401`: 401 response
- `500`: 500 response

---

[API](https://skmtc.dev/prontopaga/apis/merchant-api.md) - [All operations](https://skmtc.dev/prontopaga/apis/merchant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prontopaga/apis/merchant-api/revisions/2df4b92312d1?raw)
