Parámetros de la petición

Esta referencia enumera las funciones públicas y los parámetros que expone la biblioteca Slim Pack, con sus nombres y firmas exactas.

Esta guía se aplica a Slim Pack.

Las siguientes tablas reflejan el modelo de invocación real utilizado por la biblioteca. Los parámetros se enumeran exactamente como deben aparecer en el código, sin alias, traducciones ni campos inferidos.

Funciones de inicialización y ciclo de vida

Estas son las funciones que se utilizan para inicializar y gestionar el ciclo de vida del TPVPC.

fnDllIniTpvpcLatente

Inicializa el TPVPC y abre la comunicación con el PIN pad. Esta función debe llamarse una vez cuando se inicia la aplicación.

Firma de la función (C#):

int fnDllIniTpvpcLatente(string cComercio, string cTerminal, string cClaveFirma, string cConfPuerto, string cVersion);

Valor de retorno: 0 si la inicialización es exitosa. Cualquier otro valor indica un error a nivel de biblioteca.

fnDllParaTpvpcLatente

Detiene la comunicación y libera todos los recursos internos.

Firma de la función:

int fnDllParaTpvpcLatente();

Esta función no tiene parámetros de entrada.

Operaciones de pago y financieras

Todas las operaciones financieras se ejecutan a través de funciones exportadas que reciben parámetros tipados y devuelven un buffer de respuesta XML. Un valor de retorno de 0 solo indica que la operación fue procesada; la autorización siempre debe validarse a partir del XML.

fnDllOperPinPad

Ejecuta un PAGO o PREAUTORIZACION utilizando un PIN pad físico.

Firma de la función:

int fnDllOperPinPad(string cImporte, string cFactura, string cTipoOper, StringBuilder cXMLResp, int iTamMaxResp);

fnDllOperManualExt

Ejecuta un PAGO o PREAUTORIZACION mediante la introducción manual de los datos de la tarjeta.

Firma de la función:

int fnDllOperManualExt(string cTarjeta, string cCaducidad, string cCVC2, string cImporte, string cFactura, string cTipoOper, StringBuilder cXMLResp, int iTamMaxResp);

Operaciones de confirmación y devolución

Una confirmación captura una preautorización autorizada previamente; una devolución devuelve fondos. Las dos pasan por la misma familia de funciones, y la que debes llamar depende de dónde vengan la tarjeta y la referencia original.

cTipoOper solo aparece en las dos funciones ComContable que sirven a las dos operaciones, y toma DEVOLUCION o CONFIRMACION. Las demás llevan la operación en su propio nombre.

Pagos recurrentes

El modo recurrente es un interruptor de sesión, no un parámetro. Dos funciones lo activan y lo desactivan, y ninguna recibe argumentos:

fnDllIniTpvpcLatente desactiva el modo recurrente, así que hay que activarlo de nuevo después de cada inicialización.

El token llega en el elemento <token> de la respuesta XML del pago.

Validación de autorización

Todas las operaciones financieras se consideran AUTORIZADAS solo si la respuesta XML contiene:

<estado>F</estado>
<resultado>Autorizada</resultado>

Cualquier otra combinación debe tratarse como DENEGADA, independientemente de los códigos numéricos o los valores de retorno de la biblioteca.