> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Glossário

> Glossário de referência do plugin Bank Transfer: BACEN, SPB, STR, ISPB, PSTI, códigos de conta ISO 20022 e tipos de mensagem do JD SPB como o STR0008.

Referência rápida dos termos e siglas usados na documentação do plugin Bank Transfer.

## Termos regulatórios e de infraestrutura

***

| Termo | Definição |
| - | - |
| **BACEN** | Banco Central do Brasil. Regula o sistema financeiro e opera o SPB. |
| **SPB** | Sistema de Pagamentos Brasileiro, a infraestrutura de todas as liquidações interbancárias. |
| **STR** | Sistema de Transferência de Reservas, o componente de liquidação em tempo real do SPB. |
| **RSFN** | Rede do Sistema Financeiro Nacional, a rede financeira nacional segura que conecta o BACEN às instituições financeiras. |
| **PSTI** | Provedor de Serviço de Tecnologia da Informação, um provedor autorizado pelo BACEN a operar a infraestrutura de conectividade da RSFN. A JD Consultores é um PSTI. |
| **ISPB** | Identificador de Sistema de Pagamentos Brasileiro, o código de 8 dígitos que identifica de forma única cada instituição financeira no SPB. |
| **STR0008** | O formato de mensagem do BACEN para iniciar uma transferência TED. Enviado da instituição de origem para o SPB. |
| **STR0008R1** | O resultado da liquidação de um STR0008 que o plugin enviou. |
| **STR0008R2** | Um TED recebido. O plugin credita um TED IN a partir dele. Outras sete mensagens STR trazem [créditos ao cliente](https://docs.lerian.studio/pt/interfaces/ted-jd/ted-in.md#customer-credits), cada um com o próprio tipo de transferência. |
| **STR0010 / STR0010R2** | O STR0010 devolve um TED recebido ao banco de origem, automaticamente ou a seu [pedido](https://docs.lerian.studio/pt/interfaces/ted-jd/ted-in.md#return-a-received-transfer). O STR0010R2 é um retorno que o plugin recebe: para um TED OUT, é uma devolução; para um TED IN, é um chargeback. |
| **Devolução / `devolutionCode`** | Devolução de um TED. Quando um TED OUT já enviado é devolvido (STR0010R2), o plugin registra um novo reembolso TED IN que carrega o código de motivo do BACEN (`devolutionCode`) e um `originalTransferId` que aponta de volta para o TED OUT original. |
| **JD / JD SPB** | JD Consultores, o PSTI que a Lerian usa para rotear mensagens de TED até o SPB. |
| **Falha de parsing da JD** | Mensagem recebida da JD que o plugin não conseguiu interpretar (XML malformado ou schema divergente). O plugin a guarda para triagem do operador. Diferente das transferências não entregáveis e da DLQ de webhooks. |
| **NumCabSeq** | Identificador sequencial de mensagem atribuído pelo JD SPB a cada envio de STR0008. Usado para acompanhar e consultar o status da transferência. |
| **NumCtrlSTR** | Número de controle de compensação do BACEN atribuído pelo STR (Sistema de Transferência de Reservas) quando uma mensagem é aceita no fluxo de compensação do SPB. Diferente de `NumCabSeq`, que é a sequência de mensagem atribuída pela JD no envio. |

## Códigos de tipo de conta (ISO 20022)

***

| Código | Tipo de conta |
| - | - |
| **CACC** | Conta corrente, o tipo mais comum |
| **CPAY** | Conta de pagamento |
| **SLRY** | Conta salário |
| **SVGS** | Conta poupança |

## Tipos de transferência

***

| Termo | Definição |
| - | - |
| **TED OUT** | Transferência de saída. O seu cliente envia fundos para uma conta em outro banco. |
| **TED IN** | Transferência de entrada. A sua instituição recebe fundos de outro banco, detectados e creditados automaticamente. |
| **P2P** | Transferência interna entre duas contas da mesma instituição (mesmo ISPB), na mesma organização e no mesmo ledger do Midaz. O [P2P entre dois ledgers](https://docs.lerian.studio/pt/interfaces/ted-jd/ted-p2p.md#transfers-between-ledgers) vem desligado por padrão. |
| **TED entre cores** | Transferência entre duas contas do mesmo ISPB que dois cores da sua instituição detêm. Ela passa pelo relay do JD Courier, não pelo STR. Veja [Transferências entre cores](https://docs.lerian.studio/pt/interfaces/ted-jd/ted-cross-core.md). |
| **D+0** | Liquidação no mesmo dia. O plugin aceita TED OUT apenas dentro da janela de operação, das 06:30 às 17:00, horário de Brasília, por padrão. |

## Termos específicos do plugin

***

| Termo | Definição |
| - | - |
| **PaymentInitiation** | A entidade criada por `POST /v1/transfers/initiate`. Guarda o cálculo da tarifa. Expira depois de 24 horas ou, no TED OUT, no fechamento da janela de operação daquele dia. |
| **initiationId** | UUID retornado pelo endpoint de iniciação. Obrigatório para confirmar uma transferência por `POST /v1/transfers/process`. |
| **X-Idempotency** | Header obrigatório nas escritas de transferência. O plugin guarda uma resposta de sucesso sob a chave e a repete por 7 dias. O plugin rejeita uma requisição repetida que reutiliza a chave com um corpo diferente (`422 BTF-0017`). |
| **Tarifa de cashin** | Tarifa sobre um TED IN recebido. Configurada por organização pelo Fees Engine. Veja [Tarifa de recebimento](https://docs.lerian.studio/pt/interfaces/ted-jd/ted-in.md#receiving-fee-cashin). |
| **Tarifa de cashout** | Tarifa somada ao valor de um TED OUT. A conta do remetente é debitada pelo valor + a tarifa. |
| **Conciliação** | Processo para casar transferências em estado desconhecido (PROCESSING sem confirmação) com os registros do JD SPB. |
| **DLQ** | Fila de dead-letter de webhooks. As notificações de webhook de saída que não podem ser entregues depois de todas as novas tentativas vêm para cá, para revisão manual. |
| **Artefato de assinatura** | Payload canônico do TED OUT congelado durante o `POST /v1/transfers/signing/prepare`. Consumido por integrações externas de HSM ou de assinador para produzir uma assinatura destacada sem que o plugin guarde a chave privada. |
| **Systemplane** | Plano administrativo de configuração em tempo de execução, exposto por `/system/:namespace` e `/system/:namespace/:key`. Guarda configurações com hot reload que passam a valer sem um novo deploy. Diferente das variáveis de ambiente de bootstrap, lidas apenas na inicialização. |
| **Transferência não entregável** | TED de entrada que o plugin interpretou, mas não conseguiu creditar. O plugin o devolve ao banco de origem. Quando o destinatário não é encontrado e as devoluções automáticas estão desligadas, o plugin o retém para um operador. Diferente de uma falha de parsing da JD e da DLQ de webhooks. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.