🚀 Integração Flutter com o MSitef (TEF da Fiserv) utilizando o plugin msitef_payment_tech

Se você já trabalhou com soluções de pagamento no varejo, sabe que a integração com sistemas de TEF (Transferência Eletrônica de Fundos) pode ser um grande desafio. Pensando nisso, desenvolvi e publiquei no pub.dev um plugin Flutter não oficial que facilita a comunicação com o MSitef da Fiserv, permitindo que seu app realize transações de pagamento diretamente com o TEF já instalado na máquina.

⚠️ Importante: este plugin não funciona com proxy e requer que o aplicativo MSitef esteja previamente instalado e configurado no dispositivo. Para obter o instalador, é necessário entrar em contato com sua distribuidora TEF.

⚠️ Importante: este é um plugin não oficial, desenvolvido de forma independente para ajudar a comunidade Flutter.

🎯 O que é o MSitef?

O MSitef é uma solução TEF (Transferência Eletrônica de Fundos) fornecida pela Fiserv, utilizada em milhares de estabelecimentos para processar pagamentos com segurança. Ele atua como intermediador entre sua aplicação e as operadoras de cartões, oferecendo suporte a diferentes meios de pagamento.

✨ O que o plugin oferece?

Com o plugin, é possível realizar as seguintes operações:

• 💳 Cartão de Crédito
• 💳 Cartão de Débito
• 💸 PIX
• 🔄 Cancelamento de transações
• 🖨️ Reimpressão de comprovantes

Isso significa que você pode transformar seu aplicativo Flutter em uma solução de PDV (Ponto de Venda) totalmente integrada ao TEF, sem precisar lidar diretamente com toda a complexidade de comunicação do MSitef.

✅ Requisitos

Para que tudo funcione corretamente, você precisa:

1. Ter o aplicativo MSitef instalado no dispositivo.
2. Configurar corretamente os parâmetros de comunicação com o TEF (IP, StoreId, TerminalId etc).
3. Usar o plugin em um projeto Flutter.

🏁 Como começar

O uso é simples. Basta importar o plugin e chamar o método responsável pela transação, passando os parâmetros necessários.

Exemplo — Débito

MSitefPaymentTech.I.payment.mSitefTransaction(
  transactionParams: TransactionParams(
    modalidade: MSitefType.debit,
    value: '10',
    couponNumber: DateTime.now().toIso8601String(),
    dateFiscal: '2021-09-01',
    hourFiscal: '12:00:00',
    operador: 'teste',
    ipSitef: '192.168.0.105',
    storeId: '00000000',
    terminalId: '00000001',
    companyDocument: '00000000000000',
    automationDocument: '00000000000000',
  ),
);

Exemplo — Crédito

MSitefPaymentTech.I.payment.mSitefTransaction(
  transactionParams: TransactionParams(
    modalidade: MSitefType.credit,
    value: '10',
    couponNumber: DateTime.now().toIso8601String(),
    dateFiscal: '2021-09-01',
    hourFiscal: '12:00:00',
    operador: 'teste',
    ipSitef: '192.168.0.105',
    storeId: '00000000',
    terminalId: '00000001',
    companyDocument: '00000000000000',
    automationDocument: '00000000000000',
  ),
);

Exemplo — PIX

MSitefPaymentTech.I.payment.mSitefTransaction(
  transactionParams: TransactionParams(
    modalidade: MSitefType.pix,
    value: '10',
    couponNumber: DateTime.now().toIso8601String(),
    dateFiscal: '2021-09-01',
    hourFiscal: '12:00:00',
    operador: 'teste',
    ipSitef: '192.168.0.105',
    storeId: '00000000',
    terminalId: '00000001',
    companyDocument: '00000000000000',
    automationDocument: '00000000000000',
  ),
);

📦 O que você recebe de retorno?

Todas as transações realizadas retornam um objeto da classe:

TefTransactionResponseMSitef

Esse objeto contém os detalhes do pagamento processado, permitindo que você valide, registre e trate os resultados da operação de forma programática.

🔗 Conclusão

Com esse plugin, desenvolvedores Flutter podem integrar rapidamente o MSitef em seus aplicativos, criando soluções de pagamento robustas para estabelecimentos comerciais. Isso elimina boa parte da complexidade de integração direta com o TEF, reduz tempo de desenvolvimento e aumenta a confiabilidade da sua aplicação.

Se você está desenvolvendo um sistema de PDV, autoatendimento ou aplicativo de gestão de vendas, essa integração pode ser o que falta para levar seu projeto para o próximo nível.

📌 O plugin já está disponível no pub.dev, pronto para uso.