---
title: "Crear un nuevo retiro - Brasil Pix"
method: POST
path: "/withdrawal/pix/new"
---

# Crear un nuevo retiro - Brasil Pix

`POST /withdrawal/pix/new`

## Request body

- object
  - `amount` integer, required — Monto de la transacción
  - `document_id` string, required — Documento de identidad del beneficiario
  - `beneficiaryName` string, required — Primer nombre del beneficiario
  - `beneficiaryLastName` string, required — Apellido del beneficiario
  - `beneficiaryEmail` string, required — Correo electrónico del beneficiario
  - `beneficiaryPhone` string, required — Número de teléfono del beneficiario.
  - `accountType` string, required — Tipo de cuenta bancaria. <br> Puede ser: <b>`C`, `SL`, `S`, `P`<b>.
  - `bankCode` string, required — Código bancario. Descarga el **[listado completo de códigos bancarios](https://docs.prontopaga.com/update/docs/brazil-payout-bank-codes)** para retiros en Brasil. Al crear una solicitud de PayOut, el valor que envíes en el campo **`bankCode`** debe corresponder al valor **`code`** de la lista de códigos.
  - `data` string, required — Identificador del Retiro a asociar. Debe ser único e irrepetible
  - `confirmationURL` string, required — Webhook. Conoce más información en <a href="https://docs.prontopaga.com/docs/webhooks">este artículo</a>.
  - `currency` string, required — Código ISO de la moneda: <b>BRL.
  - `country` string, required — Código del país: <b>BR</b>.
  - `sign` string, required — La firma de los parámetros es única para cada transacción. Conoce cómo firmar en <a href="https://docs.prontopaga.com/docs/sign-transactions">este artículo</a>.
  - `pagamentoType` integer, required — Este es el campo diferenciador al solicitar un retiro PIX. <br> <ul> <li>El valor `C` corresponde a un retiro con una cuenta corriente.</li> <li>El valor `SL` corresponde a un retiro con una cuenta sueldo.</li><li>El valor `S` corresponde a un retiro con una cuenta de ahorros.</li> <li>El valor `P` es un retiro con una cuenta de pagos.</li> </ul>
  - `type` string, required — Este campo diferencia qué tipo de Pix se utilizará al generar el retiro y se debe distinguir por: `document_id` (CPF), `beneficiaryEmail` o `beneficiaryPhone`.
  - `accountNumber` string, required — Número de cuenta bancaria.
  - `agency` string — Sucursal bancaria brasileña donde se realizará el retiro para el tipo de pago `SL`, retiro a cuenta bancaria.
  - `ispb` string — La ispb participante de la institución financiera asociada al contacto.

## Response `200`

200

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/prontopaga/apis/prontopaga-api.md) · [All operations](https://skmtc.net/prontopaga/apis/prontopaga-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prontopaga/prontopaga-api/revisions/edcc7c3087f0/schema)