Glossário

Referência transversal para toda a KB. As definições são propositalmente curtas; onde um termo tem uma página dedicada, essa página é referenciada. Este glossário é autoritativo — um conceito tem exatamente um nome canônico em toda a KB.

Nota terminológica — autorização vs. confirmação

Para evitar confundir a semântica de cartão com a semântica do PIX, a KB padroniza:

• Confirmação de pagamento — o evento em que os recursos são reconhecidos como recebidos (usado para PIX e, genericamente, para qualquer método). Substitui o termo ambíguo autorização financeira.
• Autorização operacional — a decisão do sistema de liberar a máquina. Independente de método.
• Autorização de cartão — a etapa de aprovação/recusa do emissor antes da captura e liquidação. Usado somente dentro do método cartão, nunca como conceito universal.

---

PIX — o sistema de pagamento instantâneo do Brasil, criado e regulado pelo Banco Central do Brasil.

BCB (Banco Central do Brasil) — regula o PIX e opera sua infraestrutura de liquidação.

Arranjo — o esquema de pagamento regulado que define as regras que todos os participantes do PIX devem seguir.

SPI (Sistema de Pagamentos Instantâneos) — o sistema de liquidação em tempo real, operado pelo BCB, através do qual as transferências PIX são liquidadas entre instituições.

DICT — o diretório operado pelo BCB que mapeia uma chave PIX à conta subjacente.

PSP (Payment Service Provider) — um participante do PIX que oferece serviços de pagamento a usuários finais.

PSP recebedor — o PSP onde o estabelecimento (a lavanderia) mantém a conta que recebe os pagamentos.

Adquirente — uma instituição que habilita comerciantes a aceitar pagamentos eletrônicos.

Instituição de pagamento — uma entidade autorizada pelo BCB a oferecer serviços de pagamento sem ser um banco completo.

Cobrança — uma solicitação de pagamento criada pelo lado recebedor, apresentada ao cliente e acompanhada até ser paga, expirar, ou ser cancelada. Veja Charge Lifecycle.

txid (identificador de transação) — um identificador único para uma cobrança PIX, gerado pelo usuário recebedor e usado para conciliação. Pode diferir do ID interno do pedido; registre os dois.

QR Code estático — um QR Code reutilizável, não vinculado a uma única transação. Veja PIX — Charges and QR Codes.

QR Code dinâmico — um QR Code gerado para uma cobrança específica, carregando um identificador único e metadados. Preferido para automação.

Confirmação de pagamento — confirmação de que os recursos foram transferidos e reconhecidos pelo sistema de pagamento. Veja Confirmação de Pagamento. (Preferido sobre autorização financeira.)

Autorização operacional — a decisão do sistema de permitir que a máquina seja usada, tomada somente depois que a confirmação de pagamento e outras verificações operacionais passam. Veja Autorização Operacional.

Autorização de cartão — aprovação/recusa do emissor antes da captura/liquidação; termo apenas do método cartão.

Webhook — uma notificação do provedor enviada ao backend da lavanderia na confirmação de pagamento.

Polling (consulta periódica) — consultar repetidamente o provedor sobre o status de uma cobrança até que seja confirmada.

Idempotência — processar a mesma confirmação mais de uma vez causa apenas uma liberação da máquina, nunca várias.

Camada de integração com a máquina — o componente que converte uma autorização operacional em um sinal que o equipamento entende.

Controlador de interface — um dispositivo externo que recebe um comando do backend e aciona a entrada da máquina (pulso, relé, contato, serial).

Controlador da máquina — a placa de controle interna que governa os ciclos e estados da máquina.

Pulso elétrico — um sinal elétrico breve usado para acionar uma entrada da máquina.

Contato seco — um fechamento de chave sem tensão usado para sinalizar a máquina.

Relé — uma chave acionada eletricamente usada para abrir ou fechar uma entrada da máquina sob comando.

GPIO — pinos de entrada/saída de propósito geral utilizáveis para sinais de pulso, contato, ou status.

RS-232 — um padrão serial ponto a ponto, comum em equipamentos legados.

RS-485 — um padrão serial que suporta distâncias maiores e múltiplos dispositivos em um único barramento.

CAN bus — um barramento serial robusto multi-dispositivo usado em equipamentos industriais.

Firmware — o software embarcado que roda na máquina ou no controlador.

Telemetria — estados e parâmetros da máquina reportados de volta para monitoramento.