PayHub — Backoffice (Beta)

PRECISA DE ATENÇÃO

🛡 Alertas de monitoria (mês)

—

clique para tratar

✓ Conciliação pendente (ontem)

—

clique para conciliar

↩ Chargebacks pendentes

—

clique para tratar

🔎 Saúde dos dados

—

auditoria diária + EDI + BF

MÊS

TPV do mês

—

clique para ver as transações

Transações no mês

—

capturas + vendas TEF

Ticket médio do mês

—

TPV ÷ transações

ECs ativos no mês

—

transacionando no período

HOJE

TPV hoje

—

clique para ver as transações

Transações hoje

—

capturas + TEF (TEF entra via EDI D+1)

Ticket médio hoje

—

TPV ÷ transações

ECs ativos hoje

—

transacionando hoje

TPV — últimos 7 dias —

Mix por produto (mês)

CANAIS DE CAPTURA — MÊS (captura Phoebus + EDI)

🏪 Físico — POS (BW)

—

🌐 Digital / e-commerce (BC)

—

🔌 TEF (BT)

—

💠 Pix

—

Bandeiras (mês) — TPV e quantidade, capturas + TEF

Data/hora	NSU	Autorização	EC	Parceiro	Adquirência	Bandeira	Produto	Parcela	Bruto	Status

— 1

Código	Nome	Documento	Parceiro	TPV 30d	Transações 30d	Status

TPV mês

—

Ticket médio mês

—

TPV ÷ transações

TPV hoje

—

TPV total (histórico)

—

Monitoria de risco

—

mês corrente

Dias sem transacionar

—

desde a última venda

Recebimento no próximo dia útil

—

Recebimento futuro total

—

Atividade

—

TPV — últimos 14 dias

Mix por produto

Mix por bandeira

Cadastro

Domicílio bancário

Plano de taxas —

Histórico — últimos 12 meses

Análise KYC / Credenciamento —

—

Dados cadastrais

MCC e CNAE —

Bureau proScore — filtros de risco —

—

Apontamentos de risco (monitoria) —

Chargebacks —

Últimos 12 meses — TPV × quantidade de transações

Representantes

—

ECs vinculados

—

TPV do mês — vinculados

—

Ticket médio do mês

—

produção dos vinculados

Parceiros comerciais

Estabelecimentos ativos

—

no cadastro

Com acesso

—

convite aceito

Convite pendente

—

Sem e-mail no cadastro

—

não dá para convidar

Pedidos de antecipação —

Antecipação pontual pedida pelo lojista no portal. A pré-contratada do plano não passa por aqui.

Pedidos de alteração cadastral —

O lojista PEDE pelo portal; quem aplica é a Neo. Só e-mail, telefone e endereço — domicílio bancário e documento não são pedidos por lá, porque decidem para onde o dinheiro vai e quem é o titular do recebível. Endereço é aplicado à mão no cadastro do EC (são sete campos e o lojista escreveu uma linha); o botão só marca como resolvido.

ECs vinculados

—

TPV do mês

—

Ticket médio

—

no mês corrente

Maior EC do mês

—

Vincular estabelecimento

Estabelecimentos vinculados

Custo médio geral

—

Interchange médio

—

parte da bandeira/emissor

Taxa administrativa média

—

parte da adquirente

Custo total interchange

—

Custo total administrativo

—

🏪 Físico (BW)

—

🌐 Digital (BC)

—

🔌 TEF (BT)

—

Resumo por MCC × canal

Propostas

—

no histórico

Em aberto

—

rascunho + enviada

Aceitas

—

fechadas

Histórico de propostas

Competência Base da NF: spread (margem real, não negativa)

TPV da competência

—

Spread MDR (receita − custo adq.)

—

Spread antecipação (receita − funding)

—

💰 Valor a emitir em NF

—

Como o hub calcula (mesmas colunas da planilha de apuração): SPREAD MDR = receita de serviços cobrada do EC (MDR do plano + tarifas) − custo de adquirência (desconto ADIQ do EDI). SPREAD ANTECIPAÇÃO = receita de antecipação cobrada (nesta competência: —) − custo de funding (taxa vigente na data da venda, pro-rata dia). MARGEM REAL = spread MDR + spread antecipação. NF base spread = MAX(0; margem real) — definição adotada em 22/07. Excluídos: pré-hub, chargebacks, Pix sem liquidação medida e lançamentos de EC sem plano de taxas — quando houver, saem detalhados na faixa amarela acima. A apuração usa o extrato EDI da ADIQ, que chega em D+1: o dia corrente só entra no dia seguinte.

Apuração por estabelecimento —

URs aceitas

—

confirmadas pela CERC

Aguardando confirmação

—

207 é recebimento, não registro

Valor registrado

—

soma das URs aceitas

Taxa de recusa

—

teto do manual: 0,1%

Agenda registrada por data de liquidação —

só a versão vigente de cada (EC × arranjo × dia) — retificação não conta duas vezes

Lotes enviados

Cadastro de EC (AP001)

Webhook

Conciliar com a CERC obrigação diária

consulta a agenda do EC direto na CERC (AP005) e mostra lado a lado com o que o hub tem. Leitura pura — não muda nada aqui, e fica registrada no audit_log com hora e autor.

Ações

a ordem importa: AP001 antes de UR — UR de EC sem cadastro aceito volta 102010. Envio de UR só entra na grade da CERC entre 00:00 e 05:59.

limite limite vazio = tudo · o primeiro clique só mostra a prévia

fora da grade (homologação) baixa do dia

Links gerados

—

total no histórico

Ativos

—

aguardando pagamento

Pagos

—

quantidade

Total recebido

—

soma dos pagos

Novo link de cobrança token: —

1 Estabelecimento que está cobrando

Buscar EC por nome ou CNPJ/CPF * o link fica registrado no nome deste EC

nenhum estabelecimento selecionado

escolha o EC acima para liberar a criação do link

2 O que está sendo cobrado

Produto ou serviço * aparece para o cliente na página de pagamento Valor * em reais Parcelas sem juros valor por parcela

3 Complementos opcional

Descrição extra ex.: referência do pedido, competência Válido até em branco = sem prazo

Resumo: preencha os campos acima

Histórico de links —

vendas de até taxa % a.m. taxa ADIQ vigente: 1,51% a.m.

Vigências da taxa de antecipação —

O hub calcula cada venda com a taxa vigente na DATA DA VENDA — registrar uma taxa nova aqui NÃO recalcula o passado. Registre quando a ADIQ renegociar.

Nova taxa (% a.m.)
Vigente a partir de

Valor antecipado

—

Prazo médio antecipado

—

dias corridos (ponderado)

Custo de antecipação

—

Custo efetivo

—

sobre o valor antecipado

Por estabelecimento

Por mês da venda

Usuários cadastrados

O perfil de telas vale para o papel operador (admin sempre vê tudo). Mudanças de telas/desativação valem imediatamente — o sistema confere a cada requisição.

TPV do mês × anterior

—

Projeção do mês

—

ECs ativos no mês

—

Credenciamentos × inativações

—

Índice de chargeback

—

Representantes — evolução no mês

Canais de captura — mês × anterior

📈 Maiores crescimentos (ECs)

📉 Maiores quedas / ofensores (ECs)

Mapa — cadastros e produção por UF · clique na UF para abrir os estabelecimentos da região

Ativas

—

— por mês

Em retentativa

—

2ª a 4ª tentativa do mês

Precisam de atenção

—

suspensas ou em conferência

Aguardando adesão

—

link enviado, ainda não pago

Conector csv_file: deposite arquivos .csv em data/inbox/<pasta>/ — são processados automaticamente. Conector api_polling: consulta a API do parceiro no intervalo configurado, com cursor incremental. Novos parceiros: POST /api/partners com o mapping de campos.

Execuções recentes

Quando	Parceiro	Origem	Linhas	Inseridas	Duplicadas	Erros

⬆ Upload de arquivo EDI

Selecione um ou mais arquivos .TXT do extrato EDI ADIQ. Processados imediatamente (previsões + débito D+1, trailer conferido).

⬆ Upload de CSV Pix

Selecione o arquivo .CSV de pagamentos Pix. Entra pelo conector de arquivos e soma no card Pix informativo da conciliação.

⬆ Upload da Agenda BF — Pagamento Detalhado

Envie o CSV exportado da BF exatamente como ele vem — não renomeie e não converta para UTF-8. O nome vira agenda_bf_AAAAMMDD.csv aqui no servidor e o arquivo é importado na hora, com conferência de soma. Alimenta o estoque pré-hub e os selos “paga ✓” da agenda.

📄 EDI ADIQ — extrato de liquidação

Lançamentos ingeridos

—

Última ingestão

—

arquivos em data/inbox/adiq/

Deposite os arquivos .TXT do EDI (layout Extrato V4.2) na pasta data/inbox/adiq/. O trailer L9 é conferido automaticamente contra a soma dos registros CV.

🔄 Busca automática — FTP/SFTP da ADIQ

O PayHub conecta na pasta da ADIQ, baixa apenas os arquivos novos e processa em seguida (travas de duplicado e de afiliação mantidas). A senha fica somente no seu banco local e nunca é reexibida.

⚡ CAPTURA Phoebus / PayStore — API transacional

Capturas ingeridas

—

Última janela consultada

—

Endpoint: GET /api/api/v3/payments com cursor incremental e sobreposição de 90 min (dedup por uuid).

Visão por fonte (pré-conciliação)

Fonte	Conector	Ativo	Transações	TPV	Última ingestão

Próxima etapa: cruzar CAPTURA (Phoebus) × LIQUIDAÇÃO (EDI ADIQ) por NSU/autorização/valor para apontar capturas sem liquidação e liquidações sem captura.

📄 Sequência de arquivos EDI

Quando	Arquivo	Linhas	Inseridas	Dup.	Erros

⚡ Histórico de capturas (API Phoebus)

Quando	Janela consultada	Linhas	Inseridas	Dup.	Erros

proScore — bureau consultivo —

Usuário
Senha
Ambiente (URL)
Rede
Loja
Contrato
Consulta PJ
Consulta PF

Consultas são cobradas pelo bureau: o hub consulta apenas sob demanda (botão no detalhe do EC) e reaproveita resultados por 30 dias. Senha write-only.

Capturas no período

—

Vendas no EDI

—

Conciliadas ✓

—

Pendente de análise

—

Captura sem liquidação

—

Aguardando EDI ⏳

—

EDI sem captura

—

Pix capturado — informativo

—

fora da conciliação

TEF (terminais BT) — informativo

—

soma do EDI, fora da conciliação

Resumo por data (data da transação, horário de Brasília)

CAPTURA SEM LIQUIDAÇÃO DO EDI

Transações capturadas na Phoebus que não apareceram no extrato da ADIQ no período. Normal para capturas recentes (EDI é D+1); investigar se persistir.

EDI SEM CAPTURA CORRESPONDENTE

Lançamentos no extrato ADIQ sem captura Phoebus no período — inclui vendas capturadas antes do início da coleta da API.

Conciliadas 0

Data da transação: Data de pagamento:

Pagamento no próximo dia útil

—

Pagamentos futuros (em aberto)

—

Próximos meses — a pagar aos ECs (previsões em aberto, dia útil)

Resumo por data de pagamento

Lançamentos

Dia do pagamento

Total do dia

—

Estabelecimentos

—

Situação

—

Ação

congela o lote com trilha de auditoria

Lote por estabelecimento —

Remessa SLC — Núclea via RTM Hub Fase 2

gera crédito (tipo 1), débito (tipo 3) e antecipação (tipo 5) no layout RTM v3.0 — o dia precisa estar confirmado

Transporte SFTP (RTM Hub)

as pastas são compartilhadas com a Mobbuy — nada aqui apaga, move ou sobrescreve arquivo

Retorno do SLC

ErroRTM, ERR, PRO, RET ou Retorno — o tipo é reconhecido pelo conteúdo do arquivo

Lotes confirmados (últimos 60 dias)

Alertas abertos — ALTA

—

tratativa imediata

Alertas abertos — MÉDIA

—

analisar no dia

Alertas abertos — BAIXA

—

acompanhamento

Valor sob alerta

—

soma dos alertas abertos

ECs por risco

—

ECs monitorados no período

Alertas

Regras — clique numa regra para ajustar os parâmetros

Status de risco

—

Alertas abertos

—

TPV no período

—

Status cadastral

—

Cadastro

Contato e domicílio bancário

Apontamentos da monitoria

carregando…

Obrigatório por mandate das bandeiras. Enquanto um EC não estiver cadastrado aqui, ele não existe como subseller na Fiserv. A API é síncrona: não há webhook, o resultado vem na mesma chamada.

Estabelecimentos

Estabelecimento	Documento	Situação	Pendências

O que resolve mais ECs

Motivos agrupados, do que destrava mais para o que destrava menos. É por aqui que o cadastro começa.

Credenciais

Os segredos são cifrados pelo secretbox e nunca voltam pela API — nem mascarados. A tela mostra só se existem.

carregando…

Ajustes no período

—

Chargebacks (CBHK)

—

contestações de portador

Débitos ao EC

—

valor debitado

Créditos ao EC

—

valor creditado

Lançamentos de ajuste

Consulta avulsa de CNPJ ou CPF — CNPJ: Receita Federal + bureau (proScore) + MCC ABECS · CPF: bureau (proScore) — sem precisar cadastrar o EC

CNPJ ou CPF

Pendentes de análise

—

aguardando decisão

Em análise

—

com o time de credenciamento

Aprovados

—

aptos a transacionar

Recusados

—

credenciamento negado

Alto risco

—

definido ou sugerido

Matriz de risco por segmento (MCC) — alterar o nível reclassifica o score dos ECs do segmento

Consultar CNPJ

CNPJ

Planos cadastrados —

Consultas feitas

O que o assistente buscou para responder a última pergunta.

Nenhuma ainda.

Regras do assistente

Somente leitura: não altera cadastro, taxa, agenda nem pagamento.
Não responde valor que não veio de uma consulta.
Respeita o seu perfil de telas.
Pergunta qual EC quando o nome é ambíguo.
Tema fora do hub recebe resposta fixa de recusa.
NSU ou CNPJ sem pedido de explicação: resposta direta, sem IA.
Toda pergunta fica registrada com o seu usuário.

Tela em construção. Ainda não há banco parceiro conectado: saldos e lançamentos abaixo são ilustrativos e nenhum card executa operação.

Saldo disponível—

A liberar D+1—

Bloqueado / garantia—

Banco parceiro: a definirag — · c/c —
—

Ações da conta 6 cards · perfil Operador Neo

Fase 2 desenhados, fora do primeiro corte

FavorecidosConsultar limitesDepositar Autorização de lançamentoImportação de arquivos Informe de rendimentosOperadores da conta Acesso do EC

Últimos lançamentos exemplo

Data	Lançamento	Contraparte	Comprovante	Valor

Dashboard

TPV — últimos 7 dias —

Mix por produto (mês)

Bandeiras (mês) — TPV e quantidade, capturas + TEF

Transações

Estabelecimentos

Novo estabelecimento

Receita Federal — situação cadastral, CNAE e quadro societário

—

TPV — últimos 14 dias

Mix por produto

Mix por bandeira

Cadastro

Domicílio bancário

Plano de taxas —

↩ Chargebacks deste EC

Histórico — últimos 12 meses

—

Análise KYC / Credenciamento —

Dados cadastrais

MCC e CNAE —

Bureau proScore — filtros de risco — Consultar bureau

Apontamentos de risco (monitoria) —

Chargebacks —

Últimos 12 meses — TPV × quantidade de transações

Representantes

Novo representante

Parceiros comerciais

Acessos do lojista

Pedidos de antecipação —

Pedidos de alteração cadastral —

—

Vincular estabelecimento

Estabelecimentos vinculados

Custo de adquirência

Resumo por MCC × canal

Propostas Comerciais

Nova proposta

Histórico de propostas

Relatório Fiscal — Notas a Emitir

Apuração por estabelecimento —

CERC — registro de recebíveis

Agenda registrada por data de liquidação —

Lotes enviados

Cadastro de EC (AP001)

Webhook

Recusas por código

Conciliar com a CERC obrigação diária

Ações

Link de pagamento

Configuração do token

Novo link de cobrança token: —

Histórico de links —

Custo de antecipação

Vigências da taxa de antecipação —

Por estabelecimento

Por mês da venda

Usuários

Novo usuário

Usuários cadastrados

Analítico

Representantes — evolução no mês

Canais de captura — mês × anterior

📈 Maiores crescimentos (ECs)

📉 Maiores quedas / ofensores (ECs)

Mapa — cadastros e produção por UF · clique na UF para abrir os estabelecimentos da região

Assinaturas

Nova assinatura

Conectores

Execuções recentes

Importações

⬆ Upload de arquivo EDI

⬆ Upload de CSV Pix

⬆ Upload da Agenda BF — Pagamento Detalhado

📄 EDI ADIQ — extrato de liquidação

🔄 Busca automática — FTP/SFTP da ADIQ

⚡ CAPTURA Phoebus / PayStore — API transacional

Visão por fonte (pré-conciliação)

📄 Sequência de arquivos EDI

⚡ Histórico de capturas (API Phoebus)

Bureau proScore — filtros de risco —

Transação