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

# Create Inbound Transaction (Brazil)

`POST /br/transactions/inbound`

Create an inbound transaction to receive a payment. Returns a QR code for the payer to scan.
Account must be a Brazil (BRL) account. Transaction starts in `pending` status until payment is confirmed.

## Request body

- InboundTransactionRequest — Request to create an inbound transaction (receive payment) for Brazil BRL accounts
  - `accountId` string, uuid, required — ID of the account to receive funds into
  - `amount` number, required — Amount to receive (positive)
  - `email` string, email, required — Payer email for the charge
  - `document` string, required — Payer CPF or CNPJ (digits only, or formatted with punctuation)
  - `webhookUrl` string, uri — Optional URL to receive status updates

## Response `201`

Transaction created

- InboundTransactionResponse
  - `id` string, uuid, required — HG.Cash transaction ID
  - `qrCode` string — QR code string for the payer to scan (base64 or PIX string)
  - `pixCopiaECola` string — PIX copy-paste string (alternative to QR code)
  - `status` 'pending', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden — account is not operative (`Bloqueada` or `Cerrada`) or caller lacks access
- `404` — Account not found
- `502` — Payment provider error or invalid provider response

---

[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)