---
title: "Create Outbound Transaction (Brazil)"
method: POST
path: "/br/transactions/outbound"
tags: ["Brazil"]
---

# Create Outbound Transaction (Brazil)

`POST /br/transactions/outbound`

Create an outbound transaction (withdraw) from a Brazil (BRL) account.
Requires sufficient net balance. Transaction starts in `processing` status.

## Request body

- OutboundTransactionRequest — Request to create an outbound transaction (withdraw) for Brazil BRL accounts
  - `accountId` string, uuid, required
  - `amount` number, required
  - `name` string, required — Recipient name
  - `keyType` 'document' | 'email' | 'evp' | 'phone' | 'cnpj', required — PIX key type (document=CPF, evp=random key)
  - `keyPix` string, required — PIX key value (email, CPF, CNPJ, phone, or random key)
  - `webhookUrl` string, uri

## Response `201`

Transaction created. Returns `status: processing` when the provider accepted the withdraw (HTTP 200).
Returns `status: cancelled` when the provider rejected or failed (non-200); the transaction is stored and marked cancelled.

- OutboundTransactionResponse
  - `id` string, uuid, required — HG.Cash transaction ID
  - `status` 'processing' | 'cancelled', required — - `processing`: Provider accepted the withdraw (HTTP 200). Transaction is being processed. - `cancelled`: Provider rejected or failed (non-200). Transaction was marked cancelled.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden — account is not operative (`Bloqueada` or `Cerrada`) or caller lacks access
- `404` — Account not found
- `409` — Insufficient balance

---

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