![Multiplus Card [Docs]](https://docs.multipluscard.com.br/images/logo.png){kind=logo}
Title here
Summary here
Introdução
O PINPDV transforma qualquer Smart POS — maquininha com sistema operacional Android — em um terminal de pagamento integrado ao seu sistema, sem Pinpad externo e sem hardware adicional.
A integração é feita via API REST (retorno em JSON) com poucos endpoints. Você escolhe os módulos que fazem sentido para o seu negócio e já pode estar transacionando em produção em questão de horas.
Solução white label
O PINPDV é white label: o representante integra o produto com a sua própria marca. A configuração de identidade (nome, logo e dados do representante) é feita no Portal do Representante PINPDV.
Por que integrar o PINPDV?
- Pagamento no Smart POS direto do seu sistema, sem depender de outro equipamento
- Modular — integre só o que você precisa; cada módulo funciona de forma independente
- Simples — os módulos principais funcionam com dois endpoints: solicitar e consultar
- Robusto — homologado nas principais adquirentes do mercado
O PINPDV oferece módulos adicionais além dos descritos nesta documentação, que permitem integrações mais avançadas. Entre em contato com a Multiplus Card para conhecer todas as possibilidades.
Dados para vinculação fiscal (NFC-e)
As transações retornam nsu, autorizacao, bandeira e adquirente, além de valor e dataHora — os dados que fazem a vinculação do meio de pagamento exigida pela NFC-e nos estados com pagamento integrado obrigatório. Isso vale tanto para cartão quanto para PIX: no PIX, o EndToEnd (E2E) é retornado no campo autorizacao. Com esses dados você compõe o grupo de pagamento do XML sem nenhuma consulta adicional.
Módulos disponíveis
O PINPDV é organizado em módulos independentes. Integre o que faz sentido para o seu cenário:
| Módulo | O que faz | Recomendado |
|---|---|---|
| TEF Mobile | Pagamento simples: seu sistema envia uma cobrança por vez, o Smart POS processa | ✅ Sim |
| Pré-venda | Seu sistema acumula múltiplas vendas simultâneas; cada operador finaliza a sua no Smart POS | ✅ Sim |
| Venda Expressa | Venda iniciada no Smart POS, seu sistema consulta depois | Opcional |
| Cadastro de Produtos | Cadastra produtos no Smart POS para venda direta no app | Opcional |
Recomendação: comece pelo TEF Mobile e Pré-venda. São os módulos mais utilizados e cobrem a maioria dos cenários de integração com PDV.
TEF Mobile vs Pré-venda — qual escolher?
| TEF Mobile | Pré-venda | |
|---|---|---|
| Fluxo | Um pagamento por vez — seu sistema aguarda a conclusão antes de criar outro | Múltiplas vendas abertas ao mesmo tempo — cada operador resolve a sua |
| Caso de uso típico | Caixa único, checkout, balcão | Delivery, posto de combustível, mesas de restaurante, campo |
| Dados de produto | Apenas valor e descrição | Suporta lista de produtos com código, quantidade e descrição |
| Operador | Confirma no Smart POS e insere/aproxima o cartão | Seleciona a pré-venda na lista e finaliza o pagamento |
Como funciona na prática
1. Multiplus Card libera seu acesso ao Portal PINPDV
2. Você gera o token por cliente
3. Integração: dois endpoints por módulo (solicitar + consultar)Antes de escrever código, você pode validar o fluxo completo direto no Portal do Cliente PINPDV — crie uma Pré-venda ou inicie um TEF Mobile pelo portal e veja a transação chegando no Smart POS em tempo real.
Por onde começar
Primeiros Passos
Gere o token e faça a primeira chamada à API.
TEF Mobile
Um pagamento por vez — o módulo mais usado.
Pré-venda
Múltiplas vendas simultâneas, cada operador finaliza a sua.
Também precisa de TEF tradicional? A Multiplus Card tem.
O PINPDV é o módulo Smart POS de um portfólio maior. Se o seu cenário exige TEF tradicional com Pinpad em PC, a Multiplus Card também atende — escolha o modo de integração:
Anterior
Primeiros PassosPróximo
Primeiros Passos