---
title: "Perform cash-out"
method: POST
path: "/v1/transfers/cashout"
tags: ["Transfer"]
---

# Perform cash-out

`POST /v1/transfers/cashout`

Perform an external transfer, using a provider to process the outgoing account resources.
This endpoint generates the following events:
* [Transfer-out created](https://developers.pismo.io/events/docs/integrated-payments-transfer-out-created-1) - Cash-out event.
* [Financial transaction status updated](https://developers.pismo.io/events/docs/integrated-payments-transaction-status-change-1) - Cash out status change. Status becomes `SETTLED` after clearing and accounts have been credited and debited.
* [Integrated payments financial reconciliation](https://developers.pismo.io/events/docs/integrated-payments-financial-reconciliation-1)- This event is generated after the transaction has been cleared and accounts debited or credited.

## Headers

- `Authorization` string, required
- `Idempotency-key` string, required
- `x-skip-reconciliation` boolean
- `X-Signature` string

## Request body

- TransfersTransfersCashOutRequest
  - `account_id` integer, required — Pismo Platform client ID.
  - `amount` number, required — Dot-separated transfer amount in decimals.
  - `currency_code` string — ISO 4217 currency code. Can be either numeric or alphabetic.
  - `processing_code` string, required — Transfer processing code. Used to identify the type of transfer.
  - `creditor` TransfersClient
    - `account` TransfersAccount
      - `bank` TransfersBank
        - `branch` string, required — Bank branch.
        - `code` string, required — Alternative bank identifier, for example, in brazil is COMPE.
        - `identification` string, required — Bank identification. The main bank identifier, for example, in brazil is ISPB.
      - `identification` string, required — Account identification. Unique account identifier, for example a bank account number.
      - `type` string, required — Account type.
    - `identification` string, required — Identification. Document number or another unique identifier.
    - `name` string, required — Full name.
    - `type` string, required — Type required by provider; for example: F = Legal person.

## Response `202`

Response Body

- TransfersTransfersCashOutResponse
  - `correlation_id` string — Correlation ID.
  - `external_id` string — External ID of the provider.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `409` — Conflict
- `500` — Internal Server Error
- `502` — Bad Gateway
- `504` — Gateway Timeout

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)