Skip to main content

GTEF PDV SDK — Introduction

SDK version: 4.2.2

What is the GTEF PDV SDK​

A library to integrate TEF in point-of-sale (POS) systems, with asynchronous methods to drive pinpad flows and strongly-typed return models.

Key features​

  • Payments (debit, credit, voucher)
  • Pre-authorization and confirmation
  • Cancellation (same-day / pre-authorization)
  • Display messages on the pinpad
  • Retrieve receipts and transactions

Requirements​

  • .NET 6+ (or compatible with Task<T>), C#
  • Access to a certified pinpad and TEF environment drivers/services

Dependencies​

  • Connectivity to the acquirer/TEF services
  • Local pinpad/service configuration
    • If you don’t have the TEF service configured yet, contact our support to receive the files and the step-by-step installation guide

Other environments​

It’s also possible to perform the calls from other environments (for example, via CLI). If that’s your case, contact our support explaining your scenario and we’ll recommend the best option.

How to install and configure​

  1. Add the SDK package/library reference to your .NET project.
  2. Configure the pinpad/TEF service environment according to the provider.
  3. Ensure network connectivity and required permissions.

Minimal usage example (C#)​

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

// Simple payment
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}");