Getnet DocsGetnet Docs

Inicio rápido: tu primer pago con TPV Integrado

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Esta guía te muestra cómo establecer una conexión con un TPV Integrado y realizar una transacción de pago única usando solo los datos obligatorios. Al final, tendrás una conexión funcional, un terminal validado y un pago ejecutado con éxito de forma programática.

Antes de comenzar

Antes de empezar, asegúrate de que:

  • El terminal TPV está encendido y configurado en Modo TPV Integrado
  • La Connector App está instalada y activa en el terminal
  • Tienes acceso a la biblioteca de integración del TPV Integrado
  • El sistema de automatización y el TPV pueden comunicarse mediante un modelo de conexión compatible

Paso 1: Crea el Connector

Establece un canal de comunicación con el terminal TPV. Elige un modelo de conexión; el más común es HTTP a través de la red. Para controlar un terminal remoto mediante la nube de Getnet, usa CreateCloud — consulta la guía Conexión Cloud2Cloud.

ParámetroTipoDescripción
hostnamestringEl nombre de host, IPv4 o IPv6 del dispositivo TPV (por ejemplo, "192.168.0.10").
portintEl puerto del dispositivo TPV. Este parámetro es opcional y su valor por defecto es 8080.

Este es un ejemplo de cómo crear un connector:

Connector connector = Connector.CreateHttp("192.168.0.10", 8080);

Paso 2: Valida la conectividad del terminal TPV

Antes de ejecutar cualquier operación de pago, confirma que el terminal está disponible y listo. Llama a la función Polling:

var pollingResult = connector.PollingAsync();

Una respuesta exitosa (Code = 0) indica que el TPV está conectado y el terminal está listo para recibir comandos.

Si la validación falla, no continúes con las operaciones de pago.

Paso 3: Ejecuta una venta simple

Realiza una transacción de pago. Para este inicio rápido, envía Amount y SaleType para que el terminal omita las pantallas de importe y de tipo de pago. Si omites cualquiera de los dos, el TPV muestra la pantalla correspondiente para que el operador ingrese el dato.

ParámetroTipoObligatorioDescripción
AmountLongNoValor en moneda local para realizar la transacción (por ejemplo, 10000 = 100,00). Cuando se envía, se omite la pantalla de importe.
SaleTypeEnumNoTipo de pago: Card o QrCode. Cuando se establece en Card, se usa el flujo de tarjeta. Cuando se envía, se omite la pantalla de tipo de pago.

Este es un ejemplo de cómo ejecutar una venta:

var saleRequest = new SaleRequest
{
    Amount = 10000,        // Local currency in minor units
    SaleType = SaleType.Card
};

var saleResult = connector.SaleAsync(saleRequest);

En el terminal TPV se omite la pantalla de entrada del importe y el cliente inserta, desliza o acerca la tarjeta. El terminal gestiona cualquier interacción necesaria (PIN, confirmación, firma).

Paso 4: Gestiona la respuesta

Una vez completada la transacción, el TPV devuelve una respuesta estructurada. Los campos de abajo son los que se usan en este inicio rápido.

CampoTipoDescripción
CodeIntCódigo de respuesta. 0 indica éxito.
MessagestringMensaje de texto que representa el resultado de la operación (por ejemplo, "APPROVED").
CommerceCodestringCódigo de sucursal único aprobado por Getnet para procesar la transacción.
TerminalIdstringCódigo del terminal TPV.
AuthorizationCodestringCódigo de autorización de la transacción.
AmountLongImporte de la transacción en moneda local.
AccountingDatestringFecha y hora de la transacción en GMT.
RealDatestringFecha y hora de la transacción en hora local.
SaleTypestringTipo de venta (por ejemplo, "Card").
OperationModestringModo de operación seleccionado. Puede ser CalculatedGetnet o CalculatedISV.
OriginalAmountLongImporte original de la transacción en moneda local.

Ejemplo — Respuesta aprobada:

{
  "Code": 0,
  "Message": "APPROVED",
  "CommerceCode": "0000081561",
  "TerminalId": "AR001P0B",
  "AuthorizationCode": "551437",
  "Amount": 10000,
  "AccountingDate": "2025-08-25T16:11:23.0000000+00:00",
  "RealDate": "2025-08-25T13:11:50.8570000-03:00",
  "SaleType": "Card",
  "OperationMode": "CalculatedGetnet",
  "OriginalAmount": 10000
}

Verifica siempre el código de respuesta antes de continuar con el flujo de negocio.

Paso 5: Cierra la conexión

Después de completar la operación, libera todos los recursos asignados:

connector.Close();

Una vez cerrada, la instancia de Connector no se puede reutilizar.

Siguientes pasos

Ahora que has completado tu primer pago con TPV Integrado, explora estos temas para construir tus integraciones: