# Get Cash-Out

Returns the current status and details of a Cash-Out transaction, including settlement proof from BACEN/SPI when available.

The {id} parameter accepts:
- internalCode (ConnectPSP's code, e.g. IVKPRMOCDY)
- transactionId (UUID)
- endToEndId (E2E ID from BACEN/SPI)

Endpoint: GET /cash-out/{id}
Version: 2.0.0
Security: bearerAuth

## Path parameters:

  - `id` (string, required)
    Transaction identifier.
    Example: "IVKPRMOCDY"

## Response 200 fields (application/json):

  - `transactionId` (string)
    Example: "dd30446e-6cc5-4664-bf3f-6b7f5e55a1a9"

  - `internalCode` (string)
    Example: "IVKPRMOCDY"

  - `externalReference` (string)
    Example: "withdraw_xyz789"

  - `endToEndId` (string)
    BACEN/SPI settlement proof.
- COMPLETED: starts with E
- REFUNDED: starts with D
- FAILED: null (never settled)
    Example: "E00416968202603101827cemeFscF6AG"

  - `originalEndToEndId` (string)
    Original E2E ID when endToEndId represents an async refund.

  - `status` (string)
    Enum: "PROCESSING", "COMPLETED", "FAILED", "REFUNDED", "CANCELLED"

  - `amount` (number)
    Example: 500

  - `failure` (object)
    Present only when status is FAILED.

  - `failure.code` (string)
    Machine-readable failure code.
    Example: "PIX_KEY_NOT_FOUND"

  - `failure.message` (string)
    Human-readable failure reason.
    Example: "The provided PIX key did not resolve to a valid account."

  - `payee` (object)

  - `payee.name` (string, required)
    Full name of the payee.
    Example: "Maria Silva"

  - `payee.document` (string, required)
    CPF or CNPJ of the payee (numbers only).
    Example: "12345678909"

  - `payee.destination` (object, required)

  - `payee.destination.type` (string, required)
    - PIX — payment via PIX key. Provide pixKeyType and pixKey.
- BANK_ACCOUNT — payment via bank account data. Provide bankAccount.
    Enum: "PIX", "BANK_ACCOUNT"

  - `payee.destination.pixKeyType` (string)
    Type of PIX key. Required when type is PIX.
    Enum: "CPF", "CNPJ", "EMAIL", "PHONE", "EVP"

  - `payee.destination.pixKey` (string)
    The PIX key value. Required when type is PIX.
    Example: "12345678909"

  - `payee.destination.bankAccount` (object)
    Bank account details. Required when destination.type is BANK_ACCOUNT.

  - `payee.destination.bankAccount.ispb` (string, required)
    Bank ISPB code (8 digits).
    Example: "18236120"

  - `payee.destination.bankAccount.branch` (string, required)
    Branch number (without check digit).
    Example: "0001"

  - `payee.destination.bankAccount.account` (string, required)
    Account number with check digit.
    Example: "947710840"

  - `payee.destination.bankAccount.accountType` (string)
    Account type. Defaults to CACC (checking).
    Enum: "CACC", "SVGS", "PAYMENT"

  - `payee.bankData` (object)
    Banking details returned after settlement. May be null before settlement.

  - `payee.bankData.bank` (string)
    Bank name.
    Example: "Banco do Brasil S.A."

  - `payee.bankData.branch` (string)
    Branch number.
    Example: "0001"

  - `payee.bankData.account` (string)
    Account number.
    Example: "123456"

  - `requestedAt` (string)
    Example: "2026-03-10T14:00:00-03:00"

  - `paidAt` (string)
    Example: "2026-03-10T14:02:30-03:00"

  - `failedAt` (string)

  - `refundedAt` (string)

  - `canceledAt` (string)

## Response 401 fields (application/problem+json):

  - `type` (string)
    URI identifying the error type.
    Example: "https://connect-psp.redocly.app/errors/insufficient-funds"

  - `title` (string)
    Short, human-readable summary.
    Example: "Insufficient Funds"

  - `status` (integer)
    HTTP status code.
    Example: 422

  - `code` (string)
    Machine-readable error code for programmatic handling.
    Example: "INSUFFICIENT_FUNDS"

  - `detail` (string)
    Human-readable explanation of this specific occurrence.
    Example: "The requested amount of R$ 500.00 exceeds available balance of R$ 100.00."

## Response 404 fields (application/problem+json):

  - `type` (string)
    URI identifying the error type.
    Example: "https://connect-psp.redocly.app/errors/insufficient-funds"

  - `title` (string)
    Short, human-readable summary.
    Example: "Insufficient Funds"

  - `status` (integer)
    HTTP status code.
    Example: 422

  - `code` (string)
    Machine-readable error code for programmatic handling.
    Example: "INSUFFICIENT_FUNDS"

  - `detail` (string)
    Human-readable explanation of this specific occurrence.
    Example: "The requested amount of R$ 500.00 exceeds available balance of R$ 100.00."