Pular para o conteúdo principal

SDK GTEF PDV — Introdução

Versão do SDK: 4.2.2

O que é o SDK GTEF PDV​

Biblioteca para integração TEF em pontos de venda, com métodos assíncronos para conduzir fluxos no pinpad e retorno de modelos fortemente tipados.

Principais funcionalidades​

  • Pagamento (débito, crédito, voucher)
  • Pré‑autorização e confirmação
  • Cancelamento (mesmo dia/pré‑autorização)
  • Exibição de mensagens no pinpad
  • Consulta de recibos e transações

Requisitos​

Ambiente Recomendado​

  • .NET 6+ (ou compatível com Task<T>), C#
  • Acesso a pinpad homologado e drivers/serviços do ambiente TEF

Dependências​

  • Conectividade com os serviços do adquirente/TEF
  • Configuração do pinpad/serviço local
    • Caso ainda não tenha o serviço TEF configurado, entre em contato com o nosso suporte para receber os arquivos e o passo a passo para instalação

Outros ambientes​

Também é possível realizar as chamadas por outros ambientes (por exemplo via CLI), para isso, entre em contato com o nosso suporte explicando o seu caso, que recomendaremos a melhor opção.

Como instalar e configurar​

  1. Adicione a referência do pacote/biblioteca do SDK no seu projeto .NET.
  2. Configure o ambiente do pinpad/serviço TEF conforme o fornecedor.
  3. Garanta conectividade de rede e permissões necessárias.

Exemplo mínimo de uso (C#)​

using ADIQ.GTEF.PDV;
using ADIQ.GTEF.PDV.Modelos;

// Pagamento simples
var pagamento = await AdiqGtefApi.CapturarPagamento(
    valor: 100_00,
    modo: ADIQ.GTEF.PDV.Modelos.ModoVenda.DEBITO,
    parcelas: 1,
    notificador: n => Console.WriteLine($"[{n.Tipo}] {n.Mensagem}")
);

Console.WriteLine($"NSU: {pagamento.NsuTransacao} - Status: {pagamento.Status}");