O caixa cobra
Seu sistema manda o valor e a forma de pagamento para o NuvemTEF, por HTTP.
Gateway TEF para software houses
Troque a URL.
Troque a URL.
O resto do seu código fica como está.
O NuvemTEF fala o mesmo protocolo que a sua integração TEF já usa hoje. Mesmos endpoints, mesmo corpo de requisição, mesmo formato de resposta — então migrar não é reescrever, é apontar para outro endereço.
config do TEF · uma linha
−url: "https://api.supertef.com.br/api"
+url: "https://postef.nuvempdv.com.br/api"
É essa a mudança. O token e a chave do cliente saem do seu painel NuvemTEF; o resto da integração continua intocado.
Cadastro na hora, sem falar com vendedor. Você começa pelo simulador.
MERCADO SÃO JORGE
CNPJ 12.345.678/0001-90
- Data
- 12/09/2026 14:37
- Terminal
- CAIXA001
- Adquirente
- Cielo LIO
- Modalidade
- Crédito à vista
- Bandeira
- Mastercard
- NSU
- 004182937
- Autorização
- 739154
Valor
R$ 184,90
TRANSAÇÃO APROVADA
Via do estabelecimento
Processada via NuvemTEF
Comprovante de exemplo — dados ilustrativos.
Compatibilidade
Os mesmos endpoints que você já chama
O NuvemTEF nasceu como substituto direto: cada rota responde no mesmo caminho, com os mesmos campos e os mesmos códigos de status. Se o seu sistema já vende por TEF integrado, ele já sabe conversar com a gente.
| O que você faz | Endpoint | Compatível |
|---|---|---|
| Enviar uma cobrança para a maquininha | POST /api/pagamentos |
✓ idêntico |
| Perguntar em que pé está a venda | GET /api/pagamentos/by-uniqueid/{id} |
✓ idêntico |
| Cancelar antes de a POS processar | POST /api/pagamentos/cancelar/{id} |
✓ idêntico |
| Listar as maquininhas do cliente | GET /api/pos |
✓ idêntico |
| Reimprimir a segunda via | POST /api/v1/transacoes/{uuid}/reimprimir |
+ nosso |
Anatomia de uma venda
Do enter no caixa ao comprovante
Quatro etapas, nessa ordem — cada uma depende de a anterior ter terminado.
A maquininha acorda
Nosso app na POS recebe a ordem em segundos e abre a tela de pagamento da adquirente.
O cliente paga
Cartão, aproximação ou PIX. Quem autoriza é a adquirente — nós só carregamos a resposta.
O caixa recebe de volta
NSU, autorização e bandeira voltam para o seu sistema, prontos para entrar no cupom fiscal.
Seu painel
Você enxerga o parque inteiro
Cada software house tem o seu ambiente, com os seus clientes e as suas maquininhas isolados. O que é seu, só você vê.
Clientes e maquininhas
Cadastre o lojista, ative a POS com um código de seis dígitos e pronto. Sem chave de adquirente por cliente.
Transações ao vivo
Toda venda com valor, bandeira, NSU e autorização. Filtro por cliente, terminal, período e situação.
Diário da POS
O que cada maquininha recebeu, quando disparou e o que respondeu. Quando o lojista liga reclamando, a resposta está aqui.
Segunda via na bobina
Reimprima o comprovante de qualquer venda direto na maquininha, sem refazer a transação.
Auditoria
Quem mexeu, no quê e quando. Cada estorno, cada troca de aparelho e cada baixa de fatura fica registrada.
Cobrança automática
A fatura do mês vira boleto e PIX sozinha, e baixa sozinha quando o pagamento cai.
Maquininhas
Uma integração, várias maquininhas
A regra de negócio de cada adquirente mora no servidor, não no seu código. Quando entra uma nova, você não muda nada.
Cielo LIO
Venda, estorno e impressão pela família LIO, com o app publicado na maquininha.
integração prontaStone
Mesmo contrato de API, mesmo painel. Muda só qual maquininha está no balcão.
em desenvolvimentoSimulador
Aprova, nega e estorna como uma maquininha de verdade — para você testar antes de ter uma.
disponível agora
Preço
Você paga pela maquininha que vendeu
Sem mensalidade de plataforma, sem taxa por transação e sem cobrança por maquininha parada.
R$20
por maquininha que vendeu no mês
O que está incluso
- Maquininha cadastrada e sem venda no mês não entra na fatura. Terminal de teste também não.
- Clientes, terminais e transações sem limite de quantidade.
- Fatura fechada no dia 1º, referente ao uso do mês anterior, com boleto e PIX.
- Simulador liberado para desenvolver e homologar à vontade.
Perguntas
O que costumam perguntar antes
Eu preciso reescrever a minha integração?
Não. Os endpoints, os campos e os códigos de resposta são os mesmos que a sua integração TEF já usa. Na prática você troca a URL base, o token e a chave do cliente — e testa.
Preciso de uma chave da adquirente para cada lojista?
Não. Você cadastra o cliente, ativa a maquininha e começa a vender. A credencial da adquirente fica na plataforma; se um cliente específico tiver a dele, dá para usar a dele — mas é exceção, não regra.
Dá para testar sem ter uma maquininha física?
Dá. O Simulador aprova, nega e estorna como uma maquininha de verdade, e devolve as mesmas respostas. Você desenvolve e homologa inteiro antes de pedir a primeira POS.
Como é a cobrança?
R$ 20 por maquininha que registrou venda no mês. No dia 1º a fatura do mês anterior é fechada e vira boleto e PIX; quando o pagamento cai, ela baixa sozinha. Maquininha cadastrada e parada não é cobrada.
Quem vê os dados dos meus clientes?
Só você. Cada software house tem o seu ambiente isolado — clientes, maquininhas e transações de uma não aparecem para a outra em nenhuma tela, filtro ou relatório.
Comece pelo simulador, hoje
Cadastre a sua software house, ative um terminal simulado e rode a sua primeira venda pelo NuvemTEF antes de mexer numa linha do seu código.