# Fluxo de Pagamento Instantâneo e Totem de Autoatendimento

<section class="capitulo" id="bkmrk-fluxo-de-pagamento-i">O cliente pode pagar a fatura pelo Pagamento Instantâneo usando o Código de Resposta Rápida — seja no balcão com o operador ou sozinho no totem de autoatendimento.

<section class="para-todos">## Em linguagem simples

### No balcão (com operador)

1. O operador consulta o Cadastro de Pessoa Física e escolhe pagar com **Pagamento Instantâneo**.
2. Aparece um **Código de Resposta Rápida** na tela.
3. O cliente escaneia com o aplicativo do banco e paga.
4. O sistema fica **verificando** se o pagamento chegou (a cada poucos segundos).
5. Quando confirmado, aparece a mensagem de sucesso.

### No totem (autoatendimento)

1. O cliente toca na tela do totem na loja.
2. O totem abre a página de pagamento instantâneo (`/v1/credsystem-pix`).
3. O cliente digita o Cadastro de Pessoa Física, vê o Código de Resposta Rápida e paga pelo celular.
4. No final, pode dar uma **nota de 1 a 5** sobre o atendimento.

**Importante:** pagamento por Pagamento Instantâneo *não pode ser desfeito* pelo operador depois (diferente do dinheiro/cartão).

</section>![Fluxo de Pagamento Instantâneo e Totem](https://kb.illimitar.pro/uploads/images/gallery/2026-06/embedded-image-gi8czpkb.png)

*Figura 7 — Totem redireciona para `/v1/credsystem-pix`; fluxo Pagamento Instantâneo usa Código de Resposta Rápida, verificação periódica de status e avaliação opcional.*

<section class="para-ti">## Detalhes para Tecnologia da Informação

### Totem — entrada

- `autenticacaoTotem()` em `88e14c87/controle.php`
- Protocolo de Transferência de Hipertexto código 302 → `/v1/credsystem-pix` (Interface do Usuário fora de `bibliotecas/`)

### Endpoints de Pagamento Instantâneo

<table><thead><tr><th>Método 88e14c87</th><th>Interface de Programação de Aplicações 981bfb94</th><th>Endpoint Credsystem</th></tr></thead><tbody><tr><td>`preAutorizacaoPix`</td><td>`preAutorizacaoPix()`</td><td>`POST pre-autorizacao/pix`</td></tr><tr><td>`consultarStatusPixPagamento`</td><td>`consultarStatusPreAutorizacaoPix()`</td><td>`GET pre-autorizacao/sonda/status-pix`</td></tr><tr><td>`confirmarRecebimentoPix`</td><td>—</td><td>Salva em `cred_pagamento` (tipo Pagamento Instantâneo); sem `registrarReceita`</td></tr></tbody></table>

### Consulta repetida de Pagamento Instantâneo

- Protocolo de Transferência de Hipertexto **202** = pagamento ainda pendente; front deve continuar consultando.
- Protocolo de Transferência de Hipertexto **200** com sucesso = Pagamento Instantâneo confirmado.
- Auditoria: `credsystem-pix-pre-autorizacao`, `credsystem-recebimento-pix`

### Satisfação do totem

- `registrarSatisfacaoTotem()` → INSERT em `cred_satisfacao`
- Campos: `cpf_cliente`, `nota` (1–5)

### Imagem de fundo

- Config global: `credsystem_pix_fundo_totem_atracao`
- Criar, Ler, Atualizar e Excluir via `obter/salvar/limpar/exibirFundoTotemAtracao`

</section></section>