transfer.internal.in

{
  "id": "evt_int_in_001",
  "type": "transfer.internal.in",
  "occurredAt": "2026-04-23T14:21:05.000Z",
  "schemaVersion": "1.0",
  "environment": "production",
  "tenantId": "tenant-acme",
  "data": {
    "transactionId": "internal-9d4a5b7c-1234-4abc-9876-abc123456789",
    "amount": 500,
    "status": "SUCCESS",
    "completedAt": "2026-04-23T14:21:05.000Z",
    "payerDescription": "Pagamento salário",
    "source": {
      "providerAccountId": "a1b2c3d4-...",
      "tenantId": "tenant-acme",
      "accountId": "e5f6g7h8-...",
      "name": "EMPRESA ORIGEM LTDA",
      "taxId": "12345678000199"
    },
    "destination": {
      "providerAccountId": "b2c3d4e5-...",
      "tenantId": "tenant-acme",
      "accountId": "773107de-139e-48d1-9462-f4e88f251891",
      "name": "MARIA SILVA",
      "taxId": "12345678900"
    }
  },
  "accountId": "773107de-139e-48d1-9462-f4e88f251891"
}

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.

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.

Payload

The payload of this webhook request is an object.

idstringRequired

Deterministic event id. Same id means the same event, possibly redelivered — deduplicate on it.

typeenumRequired

Event type. Full list at GET /v1/webhooks/events.

Allowed values:

occurredAtdatetimeRequired

RFC 3339, UTC with Z.

schemaVersionstringRequired

1.0 today; bumped only on breaking payload changes.

environmentenumRequired

Environment that emitted the event.

Allowed values:

tenantIdstringRequired

Tenant the event belongs to.

dataobjectRequired

Event-specific payload. See each webhook.

accountIdstringOptional

CorpX account where the event happened. Empty on cross-account events.

Response

2XX

Acknowledged. Any 2xx within 10 seconds stops retries; anything else is retried with backoff (see the Webhooks guide).

Transferência interna creditada na conta

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.

transfer.internal.in

Headers

Payload

Response

Headers

Payload

Response