> This page is for BaaS.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# transfer.internal.in

POST 

Transferência interna creditada na conta

Enviado à conta que **recebe** uma transferência interna entre contas do mesmo ecossistema bancário. Transferências internas são instantâneas e liquidadas no mesmo banco — não trafegam pelo SPI do PIX, portanto não possuem `endToEndId`.

**Estrutura do `data`:**

* `transactionId`: ID da transação no nosso sistema (formato `internal-{uuid}`). Use no `GET /v1/accounts/{accountId}/statement`.
* `amount`: Valor recebido.
* `status`: Sempre `SUCCESS` (transferências internas são atômicas).
* `completedAt`: Data/hora da liquidação.
* `identifier`: Identificador fornecido pelo pagador no `POST /transfers/internal*` (se informado). O mesmo valor chega nas duas pernas (`transfer.internal.out` e `transfer.internal.in`).
* `payerDescription` / `description`: Descrição informada pelo pagador.
* `source`: Dados do pagador — `name`, `taxId`, `providerAccountId` e, quando a conta é gerenciada por nós, `accountId` e `tenantId`.
* `destination`: Dados do recebedor, nos mesmos campos.
* `payer` / `receiver`: as mesmas duas pontas, com `document` no lugar de `taxId`. Só aparecem quando a transferência foi iniciada **fora da API** (app ou console do liquidante). Mantidos por compatibilidade — prefira `source`/`destination`, que chegam nas duas origens.

Reference: https://docs.api.corpx.com/baas/referencia/webhook-events/webhook-transfer-internal-in

## Request

### Headers

- `X-Signature` (string, optional) — Present when the subscription uses `authType: HMAC`: `base64(HMAC_SHA256(secret, raw_request_body))` (standard Base64, with padding). Compare in constant time against your own computation over the raw body.

### Payload

- `id` (string, required) — Deterministic event id. Same `id` means the same event, possibly redelivered — deduplicate on it.
- `type` (enum, required) — Event type. Full list at `GET /v1/webhooks/events`.
  - Allowed values: `transfer.internal.in`
- `occurredAt` (datetime, required) — RFC 3339, UTC with `Z`.
- `schemaVersion` (string, required) — `1.0` today; bumped only on breaking payload changes.
- `environment` (enum, required) — Environment that emitted the event.
  - Allowed values: `production`, `sandbox`
- `tenantId` (string, required) — Tenant the event belongs to.
- `data` (WebhooksWebhookTransferInternalInPayloadContentApplicationJsonSchemaData, required) — Event-specific payload. See each webhook.
- `accountId` (string, optional) — CorpX account where the event happened. Empty on cross-account events.

## Types

### WebhooksWebhookTransferInternalInPayloadContentApplicationJsonSchemaData

Event-specific payload. See each webhook.

- `transactionId` (string, optional)
- `amount` (double, optional)
- `status` (string, optional)
- `completedAt` (datetime, optional)
- `payerDescription` (string, optional)
- `source` (WebhooksWebhookTransferInternalInPayloadContentApplicationJsonSchemaDataSource, optional)
- `destination` (WebhooksWebhookTransferInternalInPayloadContentApplicationJsonSchemaDataDestination, optional)

### WebhooksWebhookTransferInternalInPayloadContentApplicationJsonSchemaDataSource

- `providerAccountId` (string, optional)
- `tenantId` (string, optional)
- `accountId` (string, optional)
- `name` (string, optional)
- `taxId` (string, optional)

### WebhooksWebhookTransferInternalInPayloadContentApplicationJsonSchemaDataDestination

- `providerAccountId` (string, optional)
- `tenantId` (string, optional)
- `accountId` (string, optional)
- `name` (string, optional)
- `taxId` (string, optional)