Glossário - Lerian

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, 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. 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 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.
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.
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.