Primeiros Passos
Nesta página
A Multiplus Card oferece diversas soluções de pagamento, como TEF, Pix (QRMultiplus), Gateway de Pagamento (Link Pago), App PinPDV Lite, entre outras. Cada uma dessas soluções pode ser integrada de diferentes maneiras. Por exemplo, no caso do TEF, há quatro opções distintas de integração: DLL TefClientMC Modo Interativo, DLL TefClientMC Modo Client, Troca de Arquivos e Webservice. Por isso, antes de iniciar o processo de integração, recomendamos que você consulte nossos times de Integração e Comercial para identificar a solução que melhor atende às necessidades de sua automação.
Atenção
A documentação é atualizada continuamente. Recomendamos consultá-la regularmente para se manter informado sobre novos recursos, alterações de funcionalidades e eventuais descontinuações. Em caso de breaking changes, você será notificado caso sua aplicação esteja integrada às soluções da Multiplus Card.
APIs
Os produtos integrados via APIs podem utilizar diferentes métodos de autenticação. Alguns utilizam um token fornecido pela Multiplus Card, enquanto outros utilizam JWT (JSON Web Token). Portanto, é normal encontrar variações nesse aspecto entre os produtos.
Em relação às URLs, em alguns casos você poderá se deparar com o domínio webapi.relatoriotef.com.br. Isso ocorre devido à característica white label dos produtos. No entanto, o domínio webapi.multipluscard.com.br pode ser utilizado da mesma forma, sem prejuízo ao funcionamento da integração.
Atenção
A sempre é atualizada com a finalidade de adicionar novos recursos ou aprimorar os existentes, em casos pontuais novos campos podem ser adicionados ao JSON retornado pelos endpoins.
Boas Práticas
Para garantir que sua aplicação continue funcionando corretamente mesmo com a adição de novos campos nos retornos JSON, evite validações rígidas da estrutura dos objetos recebidos.
Ignore campos desconhecidos ou adicionais que não são utilizados pelo seu sistema.
Certifique-se de que o parser JSON esteja configurado para aceitar campos extras sem gerar erros.
Essa abordagem torna sua aplicação mais flexível e preparada para evoluções futuras na estrutura dos dados.
✅ Benefícios
Maior resiliência da aplicação frente a mudanças evolutivas.
Redução de falhas em ambientes de produção.
Compatibilidade futura sem necessidade de ajustes imediatos.
Ambiente de Homologação
Existe um ponto importante que merece atenção, para realizar testes com nossas soluções para TEF, SmartPOS (App PinPDV) devem ser utilizados Pinpads e SmartPOS de Produção, pois é um requisito do ambiente de homologação (TEF) e o App para SmartPOS deve ser baixado através da loja da Adquirente.
Obs.: Ao utilizar um pinpad Gertec não utilize os modelos exclusivos para Caixa Aqui, Sicoob e Zoop. Em caso de dúvidas entre em contato conosco antes de adquirir um modelo.
Para realizar testes com nossas soluções de TEF e SmartPOS (App PinPDV), é importante utilizar Pinpads e SmartPOS de Produção. Essa exigência faz parte das regras do ambiente de homologação (TEF). Além disso, o aplicativo para SmartPOS deve ser baixado diretamente na loja da Adquirente.
Observação: Ao utilizar um pinpad Gertec, não use os modelos exclusivos para Caixa Aqui, Sicoob ou Zoop. Caso tenha dúvidas sobre qual modelo adquirir, entre em contato conosco antes da compra.
Realização dos Testes
Para garantir o sucesso dos testes no processo de integração, é essencial informar corretamente os valores das transações. Cada forma de pagamento possui um valor mínimo específico. Por exemplo:
Transações à vista: valores acima de R$ 0,10
Transações Parceladas: mínimo de R$ 15,00 (as operadoras podem definir valores minímos por parcela)
As transações realizadas via Pix, SmartPOS e TEF via Webservice ocorrem em ambiente de Produção, ou seja, tratam-se de transações reais. No entanto, todas podem ser canceladas posteriormente sem qualquer problema.
Links Úteis
Dúvidas?
Se tiver qualquer dúvida ou precisar de suporte no processo de integração, estamos à disposição pelo e-mail: homologacao@multipluscard.com.br.