manual kcc40 1

Transbank S.A.Gerencia de Desarrollo y Tecnología

Manual de Integración

Kit de Conexión de Comercio KCC

Versión 4.0

INDICE

Nomenclaturas Generales..................................................................................................4

Nuevo en esta version......................................................................................................... 5

1. Introducción................................................................................................................... 6

2. ¿ Que es el KCC ?........................................................................................................... 6

3. Etapas Técnicas de Incorporación a WebPay................................................................6

3.1 Desarrollo................................................................................................................. 7

3.2 Producción................................................................................................................ 7

4. Atributos de WebPay....................................................................................................... 7

5. Apreciación global del proceso de la Transacción Electrónica.....................................7

6. Modalidades de uso soportadas por WebPay..................................................................8

6.1 Tipos De Modalidades.............................................................................................. 86.1.1 Modo de Operación de la Modalidad Normal......................................................8

6.2 Tipo de Moneda....................................................................................................... 9

6.3 Modalidad de Captura............................................................................................. 9

6.4 Formas de Pago...................................................................................................... 10

7. Arquitectura del KCC................................................................................................... 10

7.1 Definiciones Generales........................................................................................... 117.1.1 Subprogramas.................................................................................................... 117.1.2 Flujo de Información entre Servidor de Comercio y Servidor de Pago..............127.1.3 Condiciones de Excepción.................................................................................13

8. Integración del KCC con el software de la Tienda Virtual...........................................16

8.1 Instalación del KCC............................................................................................... 168.1.1 Creación de estructura de Directorios...............................................................168.1.2 Definición de Permisos......................................................................................178.1.3 Copia de Archivos............................................................................................. 17

8.2 Configuración del KCC.........................................................................................208.2.1 Configuración del archivo Tbk_config.dat.........................................................218.2.2 Configuración del archivo Tbk_trace.dat...........................................................23

8.3 Creación de Paginas de Comercio.........................................................................258.3.1 Página de Pago.................................................................................................. 258.3.2 Página de Cierre para confirmar las transacciones.............................................258.3.3 Pagina de Exito.................................................................................................. 268.3.4 Pagina de Fracaso.............................................................................................. 26

8.4 Validaciones Obligatorias en Pagina De Cierre...................................................268.4.1 Validación de Monto.........................................................................................268.4.2 Validación de MAC........................................................................................... 27

TRANSBANK S.A.2

9. Descripción de las Modalidades.................................................................................... 28

9.1 Modalidad Normal................................................................................................. 29

9.2 Modalidad Completa............................................................................................. 31

9.3 Modalidad One Click............................................................................................ 329.3.1 Pago One Click.................................................................................................. 329.3.2 Ingreso a One Click........................................................................................... 349.3.3 Modificación One Click..................................................................................... 359.3.4 Eliminación One Click......................................................................................37

9.4 Modalidad Mall Virtual........................................................................................ 38

9.5 Modalidad Mall Virtual Completo......................................................................40

9.5 Modalidad Mall Virtual One Click......................................................................41

9.6 Modalidad Consulta De Tasa...............................................................................43

10. Archivos Generados Por El KCC................................................................................44

10.1 Archivo de Log de Eventos.................................................................................44

10.2 Archivo de Log de Transacciones........................................................................45

10.3 Códigos De Respuesta.......................................................................................... 46

11. Ejemplo de Integración de KCC con el Software de Comercio..................................47

11.1 Suposiciones:........................................................................................................ 48

11.2 Creación de directorio de cgis.............................................................................48

11.3 Creación de estructura de directorios.................................................................48

11.4 Configuración de KCC........................................................................................4811.4.1 Archivo de configuración tbk_config.dat.........................................................4911.4.2 Archivo de configuración tbk_trace.dat...........................................................49

11.5 Páginas de llamada al KCC.................................................................................49

11.6 Pagina Éxito y Fracaso........................................................................................49

11.7 Pagina De Cierre.................................................................................................. 5011.7.1 Validación de MAC......................................................................................... 50

ANEXO A - Datos Ambiente de Desarrollo WebPay........................................................53

ANEXO B - Preguntas Frecuentes...................................................................................54

ANEXO C - Recomendaciones a la seguridad del KCC...................................................56

ANEXO D - Certificación Efectuada Por TRANSBANK.................................................57

ANEXO E - Calculo del Valor Cuota...............................................................................59

ANEXO F - Tipificación de Errores.................................................................................60

TRANSBANK S.A.3

NOMENCLATURAS GENERALES

La principales nomenclaturas utilizadas en este manual son :

$(PATH_DISCO_DIRCGI)Descripción Dirección física del comercio donde se instalará el KCC Genérico.Ejemplo C:\inetpub\wwwroot\comercio\cgi-bin\ (Para Windows),

/home/comercio/cgi-bin/ (Para Unix)

$(PATH_WEB_DIRCGI)Descripción Dirección lógica, asignada por el Servidor Web del comercio al directorio

de CGI´s.Ejemplo Donde la URL del cgi tbk_bp_pago.cgi es :

http://www.comercio.cl/cgi-bin/tbk_bp_pago.cgi , entonces la dirección lógica sería (PATH_WEB_DIRCGI) = /CGI-BIN

$(PREFIJO)Descripción Es el nomenclatura que se utiliza para definir cuál será el nombre del

parámetro a utilizar por la página que confirma la transacción. Ejemplo Por ejemplo, si utilizamos como prefijo lo siguiente “HTML_”, el

parámetro para confirmar una transacción normal será HTML_TR_NORMAL.

$(TRANSACCION)Descripción Es el nombre de la solución a ejecutar. Ejemplo Las alternativas de solución o transacción a utilizar son:

TR_NORMAL TR_ONECLICK TR_INGRESO_ONECLICK TR_MODIFICACION_ONECLICK TR_ELIMINACION_ONECLICK TR_COMPLETA TR_MALL TR_MALL_COMPLETA TR_MALL_ONECLICK

$(CODIGO_COMERCIO)Descripción Código asignado por Transbank al comercioEjemplo Id = 597026008034

$(SERVIDOR_COMERCIO) Descripción Nombre del Servidor Web del comercioEjemplo www.comercio.cl

$(REFERER)

TRANSBANK S.A.4

Descripción URL absoluta de la página de la tienda virtual desde donde se inicializa el proceso de pago con TRANSBANK.

Ejemplo http://www.comercio.cl/pago.asp

NUEVO EN ESTA VERSION

La nueva versión incluye lo siguiente:

Cuotas Comercio en Webpay Respuesta en línea en caso de rechazo Nuevos códigos de respuesta Mejoras de seguridad (TBK_REFEER)

TRANSBANK S.A.5

1. INTRODUCCIÓN

WebPay es un servicio de pago con Tarjeta De Crédito desarrollado por Transbank para realizar transacciones vía INTERNET. Hoy en día constituye una herramienta clave para el desarrollo de un comercio electrónico eficaz y seguro en Chile.

Este servicio se sustenta a través de un software de aplicación que se separa en dos componentes independientes que interactúan entre sí. Una de ellas esta ubicada físicamente en la tienda virtual dentro del Servidor del Comercio en donde se genera una posible compra por intermedio del browser de un cliente y la otra en el denominado Servidor de Pago de Transbank a través del cual se realiza la transacción.

2. ¿ QUE ES EL KCC ?

La aplicación ubicada en el Servidor del Comercio que permite conectar el software utilizado por la tienda para vender sus productos y/o servicios, con el Servidor de Pago es el Kit De Conexión al Comercio identificado con la sigla KCC .

Para que el KCC se conecte y logre comunicarse sin problemas con el Servidor de Pago es necesario su correcta instalación y configuración por parte del comercio afiliado al servicio WepPay de Transbank. Así la finalidad de este manual es explicar en detalle como realizar la integración entre el KCC y el software de venta de la tienda virtual.

De acuerdo al ambiente (ver punto 3) en el cual esta siendo utilizado, este consta con lo siguiente:

KCC Desarrollo:

2 cgi de ambiente de desarrollo. Manual de Integración. Datos ambiente de pruebas.

KCC Producción:

2 cgi ambiente de producción. Datos ambiente de producción.

3. ETAPAS TÉCNICAS DE INCORPORACIÓN A WEBPAY

TRANSBANK S.A.6

En el proceso de incorporación de WebPay a una tienda virtual existen dos etapas:

Desarrollo. Producción.

3.1 DESARROLLO

La etapa de desarrollo consiste de dos sub-etapas:

Integración. Certificación.

Integración: El proceso de integración corresponde a la etapa en la cual se le entrega el KCC al cliente (comercio) para que lo integre a su sitio Web y realice transacciones hacia Transbank a través de un servidor de prueba habilitado para tal efecto (ver Anexo A).

Certificación: La etapa de certificación es aquella en la cual se realizan transacciones reales desde la tienda virtual hacia Transbank y se verifica el funcionamiento global del sistema. Referirse al Anexo D para ver detalles exigidos en este proceso. 3.2 PRODUCCIÓN

Una vez aprobada la etapa de desarrollo, el comercio pasa a la ultima fase denominada de producción en donde la tienda ya esta habilitada para trabajar con WebPay sin problemas.

4. ATRIBUTOS DE WEBPAY

WebPay tiene la capacidad de realizar transacciones seguras y en línea a través de INTERNET, uno de los aspectos más importantes de resaltar es que la información de la Tarjeta de Crédito del cliente sólo es manejada por Transbank y no es de conocimiento del comercio (exepto la Modalidad Completa, ver punto 6) esto permite un alto grado de confidencialidad de la información que viaja por la Red, además se ve reforzado por medio de la utilización de servidores seguros protegidos con SSL (Secure Socket Layer), códigos de encriptación y firmas digitales.

5. APRECIACIÓN GLOBAL DEL PROCESO DE LA TRANSACCIÓN ELECTRÓNICA

La Transacción Electrónica comienza luego que un potencial cliente accede a la tienda virtual, afiliada a Transbank, desde su browser y decide adquirir alguno de sus productos y/o servicios con una tarjeta de crédito por medio del sistema de pago WepPay. En este instante un subprograma (CGI) del KCC denominado tbk_bp_pago inicia la comunicación con Transbank en donde se realiza todo el proceso de validación de la compra con la tarjeta especificada, el resultado de este proceso es comunicado al comercio a través de un segundo cgi denominado tbk_bp_resultado.

6. MODALIDADES DE USO SOPORTADAS POR WEBPAY

TRANSBANK S.A.7

Tomando en cuenta que cada comercio es en si una entidad única y con requerimientos propios, el sistema WebPay soporta seis modalidades de uso con las cuales puede brindar una solución tecnológica a una amplia gama de modelos de operación de tiendas virtuales.

6.1 TIPOS DE MODALIDADES

Modalidad Normal Modalidad Completa Modalidad One Click Modalidad Mall Virtual Modalidad Mall Completo Modalidad Mall One Click

Modalidad Normal: Permite la compra de productos y/o servicios a través de Internet. Esta modalidad opera de forma que uno o varios productos y/o servicios agrupados en una carro de compra entregan un total final de venta a pagar. Esta directamente asociado a una sola tienda virtual.

Modalidad Completa: Orientada principalmente a aquellas tiendas que requieren que se registre una mayor cantidad de información del cliente y administran ellos la información de la tarjeta de crédito.

Modalidad One Click: Permite la compra inmediata de clientes habituales de una tienda sólo eligiendo el producto y/o servicio sin tener la necesidad de volver a ingresar los datos de la tarjeta de crédito nuevamente. Esta modalidad hace una transacción más rápida y segura sólo apretando una vez el botón pagar.

Modalidad Mall Virtual: Permite que un grupo de tiendas virtuales realicen ventas en conjunto generando sólo un total de venta final.

Modalidad Mall Virtual Completo: Permite que un grupo de tiendas virtuales realicen ventas en conjunto generando sólo un total de venta final. La modalidad de pago de este tipo de transacción esta definido por la Modalidad Completa.

Modalidad Mall Virtual One Click: Permite que un grupo de tiendas virtuales realicen ventas en conjunto generando sólo un total de venta final. La modalidad de pago de este tipo de transacción esta definido por la Modalidad One Click.

6.1.1 MODO DE OPERACIÓN DE LA MODALIDAD NORMAL

La Modalidad Normal comienza cuando el potencial cliente de una tienda virtual presiona el botón pagar, en ese instante la tienda se comunica con Transbank para solicitar autorización para transar la compra, en este punto la aplicación ubicada en el Servidor de Pago toma el control de la transacción comunicándose directamente con el cliente

TRANSBANK S.A.8

solicitando los datos de su tarjeta. Una vez realizado el envío de dicha información directamente a Transbank, se verifica la disponibilidad de cursar la transacción. Luego se le envía una respuesta positiva o negativa a la tienda virtual, así esta puede cerrar la transacción ya sea en forma exitosa o no. Una vez ocurrido esto se le devuelve el control a la tienda virtual. Todo el proceso anterior sé gráfica en la Figura 1.

Figura 1. Modalidad Normal de la Transacción Electrónica con WebPay

6.2 TIPO DE MONEDA

Además de las modalidades de empleo de WebPay mencionadas anteriormente se permite elegir el tipo de moneda de la transacción, es decir, peso o dólar. Esto debido a que se pueden realizar compras con tarjetas emitidas en el extranjero con cupo en dólares y validas internacionalmente.

6.3 MODALIDAD DE CAPTURA

Se permiten dos modalidades de captura de la transacción electrónica estas son:

Captura Simultanea: Es la utilizada cuando la transacción es validada en línea por Transbank. El cargo del pago se hace simultáneamente en la tarjeta de crédito del cliente.

Captura Diferida: Es utilizada cuando el comercio por diversas razones, ejemplo verificación de stock, no puede realizar la transacción en tiempo real, aquí lo que se hace es retener el valor de la compra del saldo de la tarjeta del cliente sin validar la transacción hasta que el comercio apruebe la compra y lo comunique a Transbank. Existe un tiempo máximo estipulado para realizar esto último, de no ser así la retención de la tarjeta de crédito del cliente será reversada.

TRANSBANK S.A.9

Observación: A pesar que el KCC ha sido desarrollado para ser utilizado por cualquier tienda virtual este debe ser integrado a cada comercio en particular de acuerdo al tipo de plataforma, transacción y software de comercio utilizado.

6.4 FORMAS DE PAGO

Actualmente existen cuatro formas de pago posibles. Estas se detallan a continuación.

Venta Normal: Corresponde al pago total del precio establecido por la tienda para un producto cuestión.

Venta Cuotas: Corresponde al pago de un producto en una cantidad de cuotas establecida por el tarjetahabiente.

Tres Cuotas Sin Interés: Corresponde al pago de un producto en tres cuotas precio contado.

Cuotas Comercio: La modalidad de pago tiene como característica principal que el comerciante ofrece al Tarjetahabiente el pago por sus productos, en cuotas iguales y conocidas por él. Esto implica que la información principal en cada transacción la constituye el precio contado del producto, el valor y número de cuotas.

Observación: En la forma de pago “Cuotas Comercio”, la única condición que Transbank impone a los comercios, es que en el calculo del monto de la cuota no se transgreda el límite correspondiente a la tasa de interés máxima legal. Para velar por que tal condición se cumpla se realiza una validación de esta tasa para todas aquellas transacciones que utilicen esta forma de pago. Se deben considerar una cantidad de cuotas entre 6 y 24. (Ver Anexo E)

7. ARQUITECTURA DEL KCC

7.1 DEFINICIONES GENERALES

El KCC es una aplicación que básicamente esta compuesta por:

Subprogramas

TRANSBANK S.A.10

Librerías Archivos de configuración Archivos de seguridad Archivos de registro Páginas Web

7.1.1 SUBPROGRAMAS

Subprograma Nombre del ArchivoPago TBK_BP_PAGOResultado de la Transacción TBK_BP_RESULTADOVerificación de Firma Digital TBK_CHECKMAC

Tabla 1. Subprogramas utilizados en el KCC.

La extensión de cada subprograma puede variar de .CGI a .EXE de acuerdo a la plataforma utilizada.

TBK_BP_PAGO

Es el encargado de hacer el requerimiento al Servidor de Pagos, derivándole a Transbank el control del browser del tarjetahabiente.

Funciones que realiza:

Firma el mensaje, agregando el MAC (código de encriptación). Traspasa los datos de la transacción de acuerdo a la modalidad de pago adoptada por el

comercio. Redirecciona el tarjetahabiente a Transbank. Registra en el log de eventos:

Resultado de las operaciones. Errores ocurridos.

TBK_BP_RESULTADO

Se encarga de recibir la respuesta desde el Servidor de Pagos, transferirla al software del comercio y solicitar la entrega del control del browser del tarjetahabiente a una página definida por la tienda.Funciones que realiza:

Valida el MAC. Recibe resultado de la transacción. Confirma con el comercio el cierre de las compras pasando todos los parámetros

recibidos. Envía la confirmación o rechazo del cierre de la compra con el comercio (aceptación o

rechazo por parte del comercio).

TRANSBANK S.A.11

TBK_CHECK_MAC

Encargado de validar el MAC de encriptación utilizado en las respuestas que entrega Transbank al comercio. Es una herramienta que se utiliza para asegurar que la respuesta provenga exactamente del KCC.

Observación: Por el lado de Transbank en el Servidor de Pago existen dos subprogramas que son los encargados de comunicarse con los subprogramas del KCC, estos son:

bp_revision bp_transaccion

7.1.2 FLUJO DE INFORMACIÓN ENTRE SERVIDOR DE COMERCIO Y SERVIDOR DE PAGO

A continuación se explica el flujo de información para la Modalidad Normal entre el Servidor de Comercio y el Servidor de Pago.

El tarjetahabiente realiza una compra a través de una tarjeta de crédito en una tienda virtual a través del servicio WebPay de Transbank.

El software de la tienda ejecuta tbk_bp_pago entregándole los siguientes parámetros:

Monto de la compra. Número de Orden de Compra. URL de Éxito. URL de Fracaso.

tbk_bp_pago se comunica con bp_revision ubicado en el servidor de Transbank.

bp_revision valida los datos recibidos desde el comercio y despliega la ventana de solicitud de datos al tarjetahabiente.

El tarjetahabiente digita los datos requeridos de su tarjeta y presiona el botón “PAGAR”

La transacción es autorizada o rechazada por Transbank y su resultado es comunicado a través de bp_transaccion (Servidor de Pago) a tbk_bp_resultado en el Servidor del Comercio.

En caso de rechazo, tbk_bp_resultado registra la transacción en su archivo log y confirma el resultado a Transbank. En caso de aprobación, tbk_bp_resultado ejecuta una página (pagina de cierre) en la tienda virtual, comunicándole el número de la orden de compra y el código de autorización asignado por Transbank. La tienda virtual busca en su base de datos el número de la orden de compra, verifica que no está ya pagada y procede a cerrar la transacción registrando el código de autorización de Transbank. Una vez realizado ésto se devuelve un string de

TRANSBANK S.A.12

“ACEPTADO” que indica que la operación fue realizada con éxito.

tbk_bp_resultado recibe “ACEPTADO” y confirma la transacción hacia Transbank.

Finalmente se redirecciona la página del tarjetahabiente a la página de éxito o fracaso según corresponda.

Observación: El string “ACEPTADO” debe ser devuelto en mayúscula para que este sea reconocido por la aplicación.

El flujo de información se muestra gráficamente en la Figura 2.

7.1.3 CONDICIONES DE EXCEPCIÓN

Las condiciones de excepción son ciertas instancias del proceso que hacen que la transacción sea reversada cuando no se cumplen algunas condiciones básicas, estas son:

Timeout: El timeout se produce cuando el tiempo de espera, por parte de Transbank, de la comprobación (ACK) de que fue realizado el cierre de la compra por parte del comercio es elevado. Se asume por lo tanto que la compra nunca fue realizada.

Error en Cierre de la Compra: Este ocurre cuando el string de confirmación del cierre de la compra es distinto de “ACEPTADO”.

TRANSBANK S.A.13

Figura 2a. Flujo de Información WebPay Modalidad Normal

TRANSBANK S.A.14

Fig

ura

2b

. F

lujo

de

In

form

aci

ón

We

bP

ay

Mo

da

lida

d N

orm

al

8. INTEGRACIÓN DEL KCC CON EL SOFTWARE DE LA TIENDA VIRTUAL

En la instalación del KCC en el sitio del comercio hay aspectos que variarán entre un comercio y otro. Esto debido a que no todos los comercios tienen los mismos softwares instalados (Servidor Web y Software de Comercio Electrónico principalmente), así hay algunas decisiones en la instalación que se dejan a criterio del comercio.

Los pasos necesarios para la integración del KCC genérico con un software de comercio electrónico son los siguientes:

Instalación del KCC. Creación de estructura de directorios Definición de permisos. Copia de archivos

Configuración del KCC. Archivo de configuración tbk_config.dat. Archivo de configuración tbk_trace.dat.

Creación de páginas de comercio. Páginas de llamada al KCC. Páginas para confirmar las transacciones.

8.1 INSTALACIÓN DEL KCC

8.1.1 CREACIÓN DE ESTRUCTURA DE DIRECTORIOS

DIRECTORIO BASE

La aplicación se debe alojar en un directorio base para facilitar su ubicación y posterior configuración, así se debe crear un directorio base denominado, por ejemplo, KCC.

DIRECTORIO CGI-BIN

El segundo paso para la instalación del KCC en el sitio del comercio es crear un directorio de cgis dentro del directorio base. Para ello hay que ejecutar las siguientes acciones:

Crear un directorio vacío con el nombre $(PATH_DISCO_DIRCGI). Configurar el servidor WEB para agregar un directorio de cgis en la ubicación $

(PATH_DISCO_DIRCGI) cuya ubicación lógica sea (PATH_WEB_DIRCGI). Asignar permisos de ejecución para el usuario Web.

SUB-DIRECTORIOS

TRANSBANK S.A.16

El KCC posee una estructura de directorios determinada para alojar sus archivos, así dentro del directorio $(PATH_DISCO_DIRCGI), se deben crear los siguientes subdirectorios:

Datos Log Maestros Template

Observación:Para la definición de los parámetros ver Nomenclatura.

8.1.2 DEFINICIÓN DE PERMISOS

Sistema Operativo

Se le deben otorgar los siguientes permisos a los directorios creados.

Directorio Lectura Escritura Ejecucióncgi-bin xdatos xlog x xmaestros x xtemplate x

Tabla 2. Asignación de Permisos

Observación: En el caso de UNIX se debe agregar permiso de ejecución a todos los directorios para poder acceder a los archivos ubicados dentro de ellos.

Servidor Web

Se deben habilitar solo los siguientes permisos en el Servidor Web a los directorios virtuales:

Directorio Virtual Atributos/ cgi-bin Permitir ejecución de cgi utilizando el método POST./ cgi-bin / log Ningún permiso/ cgi – bin / datos Ningún permiso/ cgi-bin / maestros Ningún permiso

8.1.3 COPIA DE ARCHIVOS

Dentro de la estructura de directorios definida anteriormente se deben copiar los siguientes archivos.

TRANSBANK S.A.17

Libdb30.dllDescripción Librería propia del KCC, generada por efectos de compilación, solo

utilizado para versión Windows NT. Permite ejecución del KCC en el comercio.

Ubicación $(PATH_DISCO_DIRCGI)Permiso Lectura y Escritura

Lybeay32.dllDescripción Librería propia del KCC, generada por efectos de compilación, solo

utilizado para versión Windows NT. Permite ejecución del KCC en el comercio. Posee Técnicas de seguridad.

Ubicación $(PATH_DISCO_DIRCGI)Permiso Lectura y Escrituratbk_bp_pago.cgiDescripción Programa CGI, módulo ejecutable. Permite:

Traspaso de datos de la transacción y del comercio a Transbank. Firmar el mensaje, agregando el MAC. Redireccionar al Tarjetahabiente al Servidor de Pago en

Transbank.Ubicación $(PATH_DISCO_DIRCGI)Permiso Lectura y Ejecución

tbk_bp_resultado.cgiDescripción Programa CGI, módulo ejecutable. Permite:

Recibir resultado de la transacción. Validar el MAC. Confirmar con el comercio el cierre de la compra, a través de la

pagina de cierre (ver punto 8.3.2) Realizar la confirmación, ya sea exitosa o no, del cierre de la

compra, enlazándose con el CGI tbk_bp_transaccion ubicado en el Servidor de Pago de Transbank encargado de realizar el redireccionamiento del cliente a la pagina de éxito o fracaso de la transacción del comercio.

Ubicación $(PATH_DISCO_DIRCGI)Permiso Lectura y Ejecución

tbk_chek_mac.exeDescripción Programa que permite asegurar que la página de confirmación del

comercio es llamada desde el programa tbk_bp_resultado.cgi. Se utiliza para brindar una mayor seguridad a la transacción.

TRANSBANK S.A.18

Ubicación $(PATH_DISCO_DIRCGI)Permiso Lectura y Ejecución

tbk_config.datDescripción Archivo de configuración del KCC. Permite almacenar datos que

interrelacionan al comercio con el KCC y a su vez con el Servidor de Pago. Puede ser editado con un editor de texto.

Ubicación $(PATH_DISCO_DIRCGI)/datosPermiso Lectura.

tbk_trace.datDescripción Archivo de configuración del registro de eventos del KCC (Log)

Puede ser editado con un editor de texto.Ubicación $(PATH_DISCO_DIRCGI)/datosPermiso Lectura.

Tbk_bitacora_tipo_de_transaccion_fecha.datDescripción Archivo que permite almacenar el resultado de las operaciones

realizadas durante el mes de acuerdo al tipo de transacción habilitado. Se genera por fecha contable. Donde:

tipo_de_transacción: Transacción Normal: tr_normal. Transacción Completa: tr_completa. Transacción One Click: tr_oneclick. Transacción Mall Virtual: tr_mall

fecha: mm: dos dígitos de mes. dd: dos dígitos de día.

Puede ser editado con un editor de texto. Ejemplo tbk_bitacora_tr_normal_0407.logUbicación $(PATH_DISCO_DIRCGI)/logPermiso Lectura y escritura.

Tbk_evn_fecha.datDescripción Archivo que permite almacenar el resultado de las operaciones.. Se

genera por día físico. Donde:

Fecha: aaaa: cuatro dígitos de año.

TRANSBANK S.A.19

mm: dos dígitos de mes. dd: dos dígitos de día.

Puede ser editado con un editor de texto.Ejemplo tbk_evn20000410.logUbicación $(PATH_DISCO_DIRCGI)/logPermiso Lectura y escritura.

tbk_comercio.dbDescripción Archivo maestro provisto por Transbank al comercio, contiene un

código de llave del comercio que permite autentificar el comercio y asegurar los mensajes que se envían y reciben hacia y desde Transbank.

Ubicación $(PATH_DISCO_DIRCGI)/maestrosPermiso Lectura.

Reintento.htmDescripción Pagina que se despliega en caso de ocurrir un error de CGI.Ubicación $(PATH_DISCO_DIRCGI)/templatesPermiso Lectura.

Observación: Al momento de subir los archivos al servidor de comercio se debe setear en la aplicación utilizada el modo de envió como sigue:

Tipo ExtensiónASCII *.log; *.dat; *.html; *.aspBINARIO *.cgi; *.dll; *.db

8.2 CONFIGURACIÓN DEL KCC

Los archivos de configuración del KCC son:

tbk_config.dat tbk_trace.dat

y tienen la forma:

$(NOMBRE_PARAMETRO) = $(VALOR_PARAMETRO)

donde:

$(NOMBRE_PARAMETRO): Corresponde al nombre del parámetro a configurar.

$(VALOR_PARAMETRO) : Valor asignado a dicho parámetro.

TRANSBANK S.A.20

Observación: Solamente puede ir un par:

$(NOMBRE_PARAMETRO) = $(VALOR_PARAMETRO)

por línea

8.2.1 CONFIGURACIÓN DEL ARCHIVO TBK_CONFIG.DAT

Este archivo configura el comportamiento general del KCC, tiene los siguientes parámetros.

IDCOMERCIOValor $(CODIGO_COMERCIO)Descripción Código numérico de 12 dígitos asignado por Transbank al comercio de

acuerdo a la modalidad adoptada.Ejemplo IDCOMERCIO = 597026011655

URLCGICOMValor $(PATH_DIRCGI_WEB)/tbk_bp_resultado.cgiDescripción Path web donde se encuentra el cgi tbk_bp_resultado.cgi. Ejemplo URLCGICOM = /cgi-bin/tbk_bp_resultado.cgi

SERVERCOMValor $(SERVIDOR_COMERCIO)Descripción Numero IP del servidor Web del comercio donde está el cgi

tbk_bp_resultado.cgi. Largo máximo 12 dígitos.Ejemplo SERVERCOM = 198.22.250.29

PORTCOMValor $(PUERTO_COMERCIO)Descripción Puerto asignado al servidor Web del comercio donde está el CGI

tbk_bp_resultado.Ejemplo PORT = 80

HOSTValor $(SERVIDOR_CONFIRMACION_COMERCIO)Descripción IP del servidor Web del comercio donde están las páginas de

confirmación de las transacciones por parte del comercio.Ejemplo HOST = 198.22.250.29

WPORT

TRANSBANK S.A.21

Valor $(PUERTO_CONFIRMACIÓN_COMERCIO).Descripción Puerto asignado al servidor Web del comercio donde están páginas de

confirmación de las transacciones por parte del comercio.Ejemplo WPORT = 80

SERVERTRAValor $(SERVIDOR_TRANSBANK)Descripción Nombre o IP del servidor de Transbank donde se ejecutan las

transacciones de WebPay. Incluye el prefijo https. Ejemplo SERVERTRA = https://pruebas.webpay.cl

PORTTRAValor $(PUERTO_TRANSBANK)Descripción Puerto asignado al servidor Web de Transbank donde se ejecutan las

transacciones WebPay. Ejemplo PORTTRA = 5443

URLCGITRAValor /cgi-bin/bp_revision.cgiDescripción Path Web del cgi bp_revisión.cgi en Transbank. Ejemplo URLCGITRA = /cgi-bin/bp_revision.cgi

PREFIJO_CONF_TRValor $(PREFIJO)Descripción Prefijo que contiene el nombre del parámetro que indica cual es la

página que se ejecuta en el comercio para confirmar la transacción.Ejemplo PREFIJO_CONF_TR=HTML_

$(PREF)$(TRANSACCIÓN)Valor $(PAGINA_CONFIRMACIÓN)Descripción Página que se ejecutará para confirmar la transacción $

(TRANSACCIÓN).Ejemplo HTML_TR_NORMAL=http://198.22.250.29/kcc_normal/xt_compra.asp

TBK_REFERERValor $(REFERER)Descripción URL absoluta que debe indicar la dirección de la página encargada de

inicializar el proceso de pago, es decir, desde donde se ejcuta el cgi tbk_bp_pago.

Ejemplo http://www.comercio.cl/pago.asp

TRANSBANK S.A.22

8.2.2 CONFIGURACIÓN DEL ARCHIVO TBK_TRACE.DAT

Configura el nivel de logs que reporta el KCC, este tiene los siguientes parámetros.

GLEVELValor $(NIVEL_LOG)Descripción Nivel de logs que genera el KCC.

Ej.: GLEVEL = 7

Los niveles posibles de log son:

Nivel Valor DescripciónLOGINFO 1 El KCC genera logs

informativos.LOGERROR 2 El KCC genera logs de errores.LOG_FATAL

4 El KCC genera logs Fatales

También existen las combinaciones de nivel de logs. De esta manera los valores posibles del parámetro GLEVEL son:

Valor Nivel de Log0 No hay logs.1 LOGINFO2 LOGERROR3 LOGINFO+LOGERROR4 LOGFATAL5 LOGFATAL+LOGINFO6 LOGFATAL+LOGERROR7 LOGINFO+LOGERROR+LOGFATA

L

8.2.3 HABILITACIÓN DE LAS FORMAS DE PAGO EN WEBPAY

Las formas de pago que acepta cada tienda en particular son una definición comercial. Estas son habilitadas automáticamente por Transbank desde el momento en que la tienda comienza a operar con Webpay.

Las formas de pago venta normal, venta cuotas y tres cuotas sin interés se habilitan en el formulario de pago estándar de Transbank y le permiten al tarjetahabiente seleccionar la opción a utilizar. Ver Figura 3.

La forma de pago cuotas comercio se despliega en un formulario de pago especial que no le permite al tarjetahabiente cambiar su opción de pago. Ver Figura 4.

TRANSBANK S.A.23

Figura 3. Formulario de Pago Estándar

Figura 4. Formulario de Pago para Cuotas Comercio

TRANSBANK S.A.24

8.3 CREACIÓN DE PAGINAS DE COMERCIO

El último paso en la integración del KCC con el software del comercio es la creación de cuatro páginas dinámicas por parte de la tienda para conectarse con el KCC.

8.3.1 PÁGINA DE PAGO

Por cada transacción WebPay que el comercio quiera ejecutar deberá crear una página dinámica de pago, que haga la llamada al cgi tbk_bp_pago.cgi con los parámetros adecuados de acuerdo a la transacción y que se explicitan más delante. Así, esta es la página que tiene el botón pagar y llama al cgi tbk_bp_pago.cgi con los parámetros adecuados.

Ejemplo:

Default.aspUbicación Directorio basePermiso Lectura

8.3.2 PÁGINA DE CIERRE PARA CONFIRMAR LAS TRANSACCIONES

Esta página denominada pagina de cierre es ejecutada por el cgi tbk_bp_resultado y tiene la finalidad de confirmar la transacción por parte del comercio.

La página de cierre recibirá por método POST los parámetros que se indican en el punto 9, como salida. Con ellos, esta página deberá ser capaz de realizar las operaciones necesarias (validación y almacenaje de parámetros), desde el punto de vista del comercio, para confirmar la transacción.

Si el comercio aprueba la transacción, la salida estándar de esta página debe devolver el string (html) “ACEPTADO”, en tal caso el cgi tbk_bp_resultado se encarga de realizar la confirmación (ACK) a Transbank.

Por otro lado si el comercio rechaza la transacción, el string de salida deberá ser “RECHAZADO”, en tal caso la transacción es reversada. Ejemplo:

Xt_compra.aspUbicación Directorio basePermiso Lectura y Escritura

Observaciónes:

Para KCC V2.0, esta pagina, a excepción de la Modalidad Mall, solo se ejecuta si la transacción ha sido exitosa por parte de Transbank, es decir, luego que se ha verificado que la tarjeta de crédito no tiene ninguna restricción para realizar la compra.

TRANSBANK S.A.25

Dado que esta página debe ser capaz de recibir datos por método POST y además ejecutar acciones, esta en realidad no debe ser una página HTML pura, sino más bien una pagina dinámica (cgi, php, asp, etc) capaz de generar una página HTML como salida.

8.3.3 PAGINA DE EXITO

Se define como la pagina que indica al cliente del comercio que su transacción fue realizada con éxito, esta pagina debe ser programada por el comercio. Ejemplo:

Exito.aspUbicación Directorio basePermiso Lectura y Escritura

8.3.4 PAGINA DE FRACASO

Se define como la pagina que indica al cliente del comercio que su transacción no pudo ser realizada, ésta debe ser programada por el comercio. Ejemplo:

Fracaso.aspUbicación Directorio basePermiso Lectura

Observaciónes:

Para el caso de la Modalidad Mall Virtual la pagina de éxito se reemplaza por una pagina de resultado en donde se encuentra una lista con todas las transacciones aceptadas y rechazadas.

Las páginas de éxito, fracaso y resultado son invocadas mediante el método POST.

8.4 VALIDACIONES OBLIGATORIAS EN PAGINA DE CIERRE

8.4.1 VALIDACIÓN DE MONTO

TRANSBANK S.A.26

Para aumentar la seguridad de la tienda virtual, Transbank exige la realización de una validación del monto de cada transacción. Para tal efecto, se entrega a la pagina de cierre el parámetro TBK_MONTO ó TBK_MONTO_TIENDA_MXXX de acuerdo a la modalidad usada. Así la tienda virtual debe validar el monto que pide autorizar con el monto autorizado por Transbank.

8.4.2 VALIDACIÓN DE MAC

Debido a que la página de cierre es la que define finalmente la ejecución de la transacción, es importante asegurar que solo sea invocada desde el cgi tbk_bp_resultado instalado en el comercio. Para lo anterior es necesario realizar una validación de la firma digital.

El cgi tbk_bp_resultado entrega a la página de cierre un parámetro con el nombre TBK_MAC que contiene la firma digital de los datos entregados. Para la validación de dicha firma se entrega el programa tbk_check_mac el cuál se encarga de verificar esta firma retornando 0 en el caso que sea válida o un código de error en caso contrario. En el caso de error, además escribe en la salida estándar la razón del error.

Para chequear los parámetros de respuesta utilizando el programa tbk_check_mac, la página de cierre debe generar un archivo de texto con los parámetros recibidos, en el mismo formato en que llegan, y entregar al programa el nombre del archivo. Por ejemplo, en el caso de ASPs la totalidad de los parámetros se pueden obtener llamando al método “Form” del objeto “Request” sin parámetros (data = Request.Form()).Observación: Para generar el nombre del archivo se requiere usar un nombre distinto para cada transacción ejecutada. Para lo anterior se recomienda utilizar el valor que viene en el parámetro “TBK_ID_TRANSACCIÓN”.

8.4.3 Validación De Duplicidad De Orden de Compra

Si la tienda permite pagar dos ordenes de compra idénticas se conlleva a un doble cargo al tarjetahabiente de una misma compra. De acuerdo a lo anterior se debiera contemplar en la tienda un manejo de la duplicidad de ordenes, para ello se debieran contemplar los siguientes pasos:

1. Grabar Orden de Compra en la Base de datos antes de realizar el pago.2. Verificar de acuerdo a la respuesta que envía TRANSBANK a la tienda virtual que

dicha para dicha orden de compra, en la base de datos de la tienda, no exista un código de autorización asociado, si existe (significa que ya fue pagada) se envía el string RECHAZADO y si no existe se graba el código de autorización a dicha orden de compra y se envía un string ACEPTADO.

TRANSBANK S.A.27

9. DESCRIPCIÓN DE LAS MODALIDADES

Para el buen funcionamiento del sistema de pago WebPay se deben definir para cada una de las modalidades de pago, parámetros de entrada y salida. Los parámetros de entrada son los que se deben generar en las paginas de llamada al KCC por parte del comercio, básicamente a través de algún formulario que envíe dichos parámetros por cualquiera de los métodos establecidos, ya sea POST al cgi tbk_bp_pago.cgi. Los parámetros de salida son aquellos que entrega Transbank a través del CGI tbk_bk_resultado al comercio por medio de la pagina de cierre para finalizar la transacción.

Observación: Las modalidades soportadas por las tiendas están definidas implícitamente con cada código de comercio.

TRANSBANK S.A.28

9.1 MODALIDAD NORMAL

La Modalidad Normal consiste en realizar una transacción virtual llamando al cgi tbk_bp_pago con los parámetros de entrada definidos en la Tabla 3. Una vez ejecutado este cgi el control de la transacción es tomado por Transbank quien le exige al tarjetahabiente que entregue una serie de datos de su tarjeta para terminar la transacción, el resultado de ésta es comunicado al comercio por medio del cgi tbk_bp_resultado que entrega los parámetros a la pagina de cierre, estos parámetros de salida son mostrados en la Tabla 4. Una vez confirmada la transacción a Transbank por parte del comercio, se le devuelve a éste el control del browser del cliente. Esta modalidad esta orientada a una tienda en donde por cada pago el cliente debe digitar los datos de la tarjeta de crédito.

Parámetro Descripción Largo TipoTBK_TIPO_TRANSACCION Tipo de transacción (TR_NORMAL) 50 A

TBK_MONTOMonto de la transacción. Sin separadores de miles ni de decimales. Se asume los dos últimos dígitos como valores decimales.

10 N

TBK_ORDEN_COMPRA Orden de compra. 26 ATBK_ID_SESION Identificador de sesión. (opcional) 61 A

TBK_URL_ÉXITO

Página a llamar en caso de éxito en la transacción. Debe ser una dirección absoluta, para lograr el redireccionamiento del browser del cliente.

256 A

TBK_URL_FRACASO Página a llamar en caso de fracaso en la transacción. Debe ser una dirección absoluta, para lograr el redireccionamiento

256 A

TRANSBANK S.A.29

del browser del cliente.

TBK_MONTO_CUOTASolo se envía para caso de pago CI.Monto correspondiente de cada cuota.

9 N

TBK_NUMERO_CUOTASSolo se envía para caso de pago CI.Número de cuotas a pagar.

2 N

Tabla 3. Parámetros de entrada Modalidad Normal.

Parámetro Descripción Largo Tipo

TBK_TIPO_TRANSACCIONTipo de transacción (TR_NORMAL en este caso)

50 A

TBK_RESPUESTARespuesta a la solicitud de la transacción.

2 N

TBK_ORDEN_COMPRA Orden de compra. 26 A

TBK_ID_SESIONIdentificador de sesión. (si fue habilitado)

61 A

TBK_CODIGO_AUTORIZACIONCódigo de autorización de la transacción de compra.

6 N

TBK_MONTO

Monto de la transacción. Sin separadores de miles ni de decimales. Se asume los dos últimos dígitos como valores decimales.

10 N

TBK_NUMERO_FINAL_TARJETA

Cuatro últimos números de la Tarjeta de Crédito con que se realizó la compra. (Sólo para los comercios que Transbank habilite esta opción).

4 N

TBK_NUMERO_TARJETA

Numero de Tarjeta de Crédito con que se realizó la compra. (Sólo para los comercios que Transbank habilite esta opción).

19 N

TBK_FECHA_EXPIRACION

Fecha de expiración de Tarjeta de Crédito con que se realizó la compra. (Sólo para los comercios que Transbank habilite esta opción).

6 N

TBK_FECHA_CONTABLEFecha contable de la transacción. (mmdd)

4 N

TRANSBANK S.A.30

TBK_FECHA_TRANSACCIÓNFecha en que se realizó la transacción. (aaaammdd)

8 N

TBK_HORA_TRANSACCIÓNHora en la que se realizó la transacción. (hhmmss)

6 N

TBK_ID_TRANSACCIÓN Identificador de transacción 20 N

TBK_TIPO_PAGOForma de Pago escogida por el tarjetahabiente.

2 A

TBK_NUMERO_CUOTAS

En el caso de corresponder a un tipo de pago CI, tiene el mismo valor que el parámetro de entrada. Para los otros tipos de pago (VC y SI) contiene el numero de Cuotas escogida por el tarjetahabiente.

2 N

TBK_MAC Firma digital 32 A


9 N

TBK_TASA_INTERES_MAXSolo se envía para caso de pago CI.Tasa de interés máxima permitida del periodo.

4 N

Tabla 4. Parámetros de salida Modalidad Normal.9.2 MODALIDAD COMPLETA

La modalidad completa permite una transacción sólo con los datos enviados por el comercio, en este caso se envían por intermedio del cgi tbk_bp_pago los parámetros básicos de la modalidad normal junto con los datos del tarjetahabiente:

Numero de Tarjeta Fecha de Expiración CVV

La totalidad de los parámetros de entrada se muestran en la Tabla 5. Por otro lado los parámetros de salida para la transacción completa son exactamente los mismos que para una transacción normal.

Parámetro Descripción Largo TipoTBK_TIPO_TRANSACCION Tipo de transacción (TR_COMPLETA) 50 A


10 N


TBK_URL_EXITOPágina a llamar en caso de éxito en la transacción

256 A

TBK_URL_FRACASOPágina a llamar en caso de fracaso en la transacción.

256 A

TBK_NUMERO_TARJETANumero de Tarjeta de Crédito con que se realizará la compra.

19 N

TRANSBANK S.A.31

TBK_FECHA_EXPIRACIONFecha de expiración de Tarjeta de Crédito con que se realizará la compra.

6 N

TBK_CVV Código de Verificación de la Tarjeta 4 NTBK_TIPO_PAGO Forma de Pago (VN, VC, SI, CI). 2 ATBK_NUMERO_CUOTAS Numero de Cuotas. 2 N


9 N

Tabla 5. Parámetros de entrada Modalidad Completa.

9.3 MODALIDAD ONE CLICK

En la Modalidad One Click se pueden realizar cuatro operaciones.

Pago One Click: Permite pagar con esta modalidad. Ingreso a One Click: Permite registrar usuarios de este tipo de modalidad. Modificación a One Click: Permite realizar una modificación del perfil del usuario

ingresado. Eliminación a One Click: Permite eliminar usuarios de este tipo de modalidad.

9.3.1 PAGO ONE CLICK

La Operación Pago One Click permite realizar compras en una misma tienda virtual sin necesidad de ingresar los datos de la tarjeta de crédito nuevamente. El sistema funciona con el registro de usuarios habituales en una base de datos one click. El proceso que se realiza se describe en el diagrama de flujo de la Figura 5.

TRANSBANK S.A.32

Figura 5. Diagrama de Flujo de la Modalidad Pago One Click.

Los parámetros de entrada al cgi tbk_bp_pago se definen en la Tabla 6.Parámetro Descripción Largo TipoTBK_TIPO_TRANSACCION Tipo de transacción (TR_ONECLICK) 50 A


10 N



256 A


256 A

TBK_ID_USUARIO Usuario One Click 10 ATBK_TIPO_PAGO Forma de Pago (VN, VC, SI, CI). 2 ATBK_NUMERO_CUOTAS Numero de Cuotas. 2 N


9 N

Tabla 6. Parámetros de entrada Modalidad Pago One Click.

TRANSBANK S.A.33

Los parámetros de salida para la Operación Pago One Click son exactamente los mismos que para la Modalidad Normal.

9.3.2 INGRESO A ONE CLICK

La Operación Ingreso One Click permite la inclusión de nuevos usuarios a la Modalidad One Click, este servicio es activado por el tarjetahabiente. El proceso que se realiza se describe en el diagrama de flujo de la Figura 6.

Los parámetros de entrada al cgi tbk_bp_pago se definen en la Tabla 7.


TBK_TIPO_TRANSACCIONTipo de transacción (TR_INGRESO_ONECLICK)

50 A

TBK_ID_USUARIOIdentificador de usuario a inscribir en one click.

10 A


256 A


256 A

Tabla 7. Parámetros de entrada Modalidad Ingreso One Click.

Los parámetros de salida de la Operación Ingreso One Click se muestran la Tabla 8.


TBK_TIPO_TRANSACCIONTipo de transacción (TR_INGRESO_ONECLICK)

50 A

TBK_RESPUESTARespuesta a la solicitud de la transacción en el Base24. Si es cero significa que se ejecutó normalmente.

2 N

TBK_ID_USUARIOIdentificador de usuario a inscrito en one click.

10 A

TBK_FECHA_TRANSACCIÓN Fecha en que se realizó la transacción. 8 N TBK_HORA_TRANSACCIÓN Hora en la que se realizó la transacción 6 N TBK_ID_TRANSACCIÓN Identificador de transacción 20 NTBK_MAC Firma digital 32 A

Tabla 8. Parámetros de salida de una Modalidad Ingreso One Click.

TRANSBANK S.A.34

Figura 6. Diagrama de Flujo de la Modalidad Ingreso One Click.

9.3.3 MODIFICACIÓN ONE CLICK

Este proceso permite la modificación del perfil de algún usuario de la Modalidad One Click, este servicio es activado por el tarjetahabiente. El proceso que se realiza se describe en el diagrama de flujo de la Figura 7.

TRANSBANK S.A.35

Figura 7. Diagrama de Flujo de la Modalidad Modificación One Click.



TBK_TIPO_TRANSACCIONTipo de transacción (TR_MODIFICACION_ONECLICK)

50 A

TBK_ID_USUARIOIdentificador de usuario a modificar en one click.

10 A


256 A


256 A

Tabla 9. Parámetros de entrada Modalidad Modificación One Click.

Los parámetros de salida de la Operación Modificación One Click se muestran la Tabla 10.

TRANSBANK S.A.36


TBK_TIPO_TRANSACCIONTipo de transacción (TR_MODIFICACION_ONECLICK)

50 A


2 N

TBK_ID_USUARIOIdentificador de usuario a modificado en one click.

10 A


Tabla 10. Parámetros de salida Modalidad Modificación One Click.

9.3.4 ELIMINACIÓN ONE CLICK

Este proceso permite la eliminación del perfil de algún usuario de la Modalidad One Click, este servicio es activado por el comercio. El proceso que se realiza se describe en el diagrama de flujo de la Figura 8.

Figura 8. Diagrama de Flujo de la Modalidad Eliminación One Click.

Los parámetros de entrada al cgi tbk_bp_pago se definen en la Tabla 11.TRANSBANK S.A.37


TBK_TIPO_TRANSACCIONTipo de transacción (TR_ELIMINACION_ONECLICK)

50A

TBK_ID_USUARIOIdentificador de usuario a eliminar en one click.

10A


256A


256A

Tabla 11. Parámetros de entrada Modalidad Eliminación One Click.

Los parámetros de salida de la Operación Modificación One Click se muestran la Tabla 12.


TBK_TIPO_TRANSACCIONTipo de transacción (TR_ELIMINACION_ONECLICK)

50 A


2 N

TBK_ID_USUARIOIdentificador de usuario a eliminado en one click.

10 A


Tabla 12. Parámetros de salida de la Modalidad Eliminación One Click.

9.4 MODALIDAD MALL VIRTUAL

TRANSBANK S.A.38

La Modalidad Mall Virtual permite agrupar a varias tiendas virtuales a un Mall Virtual, el cual posee un código de comercio propio y único que corresponde al parámetro ID_COMERCIO que se configura en el archivo tbk_config.dat. Por otro lado cada tienda virtual asociada al Mall también posee un código de comercio (código de tienda) que la identifica como única, este código se envía como parámetro al momento de realizar la compra. Esta modalidad actúa básicamente igual que la Modalidad Normal con la salvedad que al momento de la confirmación por parte de Transbank, la derivación del browser es hacia una pagina de resultado en la cual se lleva un catastro de las transacciones por comercio aprobadas y rechazadas. En caso de existir un error en la confirmación por parte de la tienda (Mall) a Transbank en cuanto a la realización del cierre de la compra el browser del cliente será derivado a la pagina de fracaso definida por el comercio.


Parámetro Descripción Largo TipoTBK_TIPO_TRANSACCION Tipo de transacción (TR_MALL) 50 ATBK_MONTO Monto total de la transacción mall. 10 N

TBK_ORDEN_COMPRAOrden de compra de la transacción mall.

26A

TBK_ID_SESION Identificador de sesión. (opcional) 61 A

TBK_URL_RESULTADOPágina a llamar con los resultados de las transacciones.

256A

TBK_URL_FRACASOPágina a llamar en caso de fracaso en la transacción de mall.

256A

TBK_NUM_TRXNúmero de transacciones de compra.

4N

TBK_CODIGO_TIENDA_MXXXCódigo de Comercio de la tienda número XXX en la transacción mall.

12N

TBK_ORDEN_TIENDA_MXXXOrden de compra de la tienda XXX en la transacción mall.

26A

TBK_MONTO_TIENDA_MXXXMonto de compra de la tienda XXX en la transacción mall.

10N

TBK_MONTO_CUOTA_MXXX

Solo se envía para caso de pago CI.Monto correspondiente de cada cuota para tienda XXX.

9

N

TBK_NUMERO_CUOTAS_MXXX

Solo se envía para caso de pago CI.Número de cuotas a pagar para tienda XXX.

2

N

Tabla 13. Parámetros de entrada de la Modalidad Mall Virtual.

Los parámetros de salida de la Modalidad Mall Virtual se muestran la Tabla 14.


TRANSBANK S.A.39

TBK_TIPO_TRANSACCION Tipo de transacción (TR_MALL) 50 ATBK_RESPUESTA Siempre viene en 0. 2 NTBK_ORDEN_COMPRA Orden de compra mall. 26 A

TBK_ID_SESIONIdentificador de sesión. (si fue habilitado)

61 A

TBK_MONTO Monto de la transacción mall 10 N

TBK_NUMERO_FINAL_TARJETA

Cuatro últimos números de la Tarjeta de Crédito con que se realizó la compra. (Sólo para los comercios que Transbank habilite esta opción).

4 N

TBK_NUMERO_TARJETA

Numero de Tarjeta de Crédito con que se realizó la compra. (Sólo para los comercios que Transbank habilite esta opción).

19 N

TBK_FECHA_EXPIRACION

Fecha de expiración de Tarjeta de Crédito con que se realizó la compra. (Sólo para los comercios que Transbank habilite esta opción).

6 N

TBK_FECHA_CONTABLE Fecha contable de la transacción 4 N

TBK_FECHA_TRANSACCIÓNFecha en que se realizó la transacción.

8 N

TBK_HORA_TRANSACCIÓNHora en la que se realizó la transacción

6 N

TBK_ID_TRANSACCIÓN Identificador de transacción 20 N

TBK_COD_AUT_MXXXCódigo de Autorización número XXX.

6 N

TBK_TIPO_PAGO_MXXX Forma de pago número XXX. 2 A

TBK_NUMERO_CUOTAS_MXXXNúmero de cuotas de la compra en tienda número XXX.

2 N



9 N

TBK_COD_RESP_MXXXRespuesta a la transacción número XXX.

2 N

TBK_MONTO_TIENDA_MXXX Monto en la tienda número XXX. 26 A

TBK_ORDEN_TIENDA_MXXXOrden de compra para la tienda XXX.

10 N

TBK_MAC MAC 32 N

TBK_TASA_INTERES_MAXTasa de interés máxima permitida para el periodo vigente.

4 N

Tabla 14. Parámetros de salida Modalidad Mall Virtual.

Observación: XXX varía de 001 a 006.

TRANSBANK S.A.40

9.5 MODALIDAD MALL VIRTUAL COMPLETO

La Modalidad Mall Virtual Completo opera de la misma forma que la Modalidad Mall con la diferencia que los parámetros entregados al cgi tbk_bp_pago son los de una Modalidad Mall más los de una Modalidad Completa.

La totalidad de los parámetros de entrada al cgi tbk_bp_pago se muestran en la Tabla 14. Por otro lado los parámetros de salida son exactamente los mismos que para la Modalidad Mall.


TBK_TIPO_TRANSACCIONTipo de transacción (TR_MALL_COMPLETA)

50 A

TBK_MONTO Monto total de la transacción mall. 10 N


26 A

TBK_ID_SESION Identificador de sesión. 61 A


256 A


256 A

TBK_NUM_TRX Número de transacciones de compra. 4 N

TBK_CODIGO_TIENDA_MXXXCódigo de Comercio de la tienda número XX en la transacción mall.

12 N

TBK_ORDEN_TIENDA_MXXXOrden de compra número XX en la transacción mall.

26 A

TBK_MONTO_TIENDA_MXXXMonto de compra número XX en la transacción mall.

10 N

TBK_TIPO_PAGO_MXXX Forma de Pago (VN, VC, SI, CI). 2 A

TBK_NUMERO_CUOTAS_MXXXIndica el número de cuotas de la compra

2 N

TBK_MONTO_CUOTA_MXXXSolo se envía para caso de pago CI.Monto correspondiente de cada cuota para tienda XXX.

9 N

TBK_NUMERO_TARJETA Número Tarjeta De Crédito 19 N

TBK_FECHA_EXPIRACIONFecha de expiración de Tarjeta de Crédito con que se realizará la compra.

6 N

TBK_CVV Código de verificación CVV 4 NTabla 14. Parámetros de entrada de una Transacción Mall Virtual Completo.

9.5 MODALIDAD MALL VIRTUAL ONE CLICK

TRANSBANK S.A.41

La Modalidad Mall Virtual One Click opera de la misma forma que la Modalidad Mall con la diferencia que los parámetros entregados al cgi tbk_bp_pago son los de una Modalidad Mall más los de una Modalidad One Click.

La totalidad de los parámetros de entrada al cgi tbk_bp_pago se muestran en la Tabla 15. Por otro lado los parámetros de salida son exactamente los mismos que para la Modalidad Mall.


TBK_TIPO_TRANSACCIONTipo de transacción (TR_MALL_ONECLICK)

50 A

TBK_MONTO Monto total de la transacción mall. 10 N


26 A

TBK_ID_SESION Identificador de sesión. (opcional) 61 A


256 A


256 A

TBK_NUM_TRXNúmero de transacciones de compra.

4 N

TBK_CODIGO_TIENDA_MXXXCódigo de Comercio de la tienda XXX asociada mall.

12 N

TBK_ORDEN_TIENDA_MXXXOrden de compra de la tienda XXX asociada al mall.

26 A

TBK_MONTO_TIENDA_MXXXMonto de la compra en la tienda XXX asociada al mall.

10 N

TBK_TIPO_PAGO_MXXXForma de Pago de la tienda XXX asociada al mall. .

2 A

TBK_NUMERO_CUOTAS_MXXXNúmero de cuotas a pagar para tienda XXX.

2 N



2 N

TBK_ID_USUARIO Usuario One Click 10 ATabla 15. Parámetros de entrada de la Modalidad Mall Virtual One Click.

Observación: La base de datos utilizada por la Modalidad Mall One Click es la misma que se utiliza en la Modalidad One Click, por lo cual las operaciones de registro, modificación y eliminación de la base de datos one click es la definida en el punto 9.3 .

TRANSBANK S.A.42

9.6 MODALIDAD CONSULTA DE TASA

La totalidad de los parámetros de entrada al cgi tbk_bp_pago se muestran en la Tabla 16.


TBK_TIPO_TRANSACCIONTipo de transacción (TR_TASA_INTERES_MAX)

50 A


256 A


256 A

Tabla 16. Parámetros de entrada de la Modalidad Consulta de Tasa.

Los parámetros de salida de la Modalidad Consulta De Tasa se muestran la Tabla 17.


TBK_TIPO_TRANSACCIONTipo de transacción (TR_TASA_INTERES_MAX)

50 A

TBK_RESPUESTARespuesta a la solicitud de la transacción.

2 N

TBK_FECHA_TRANSACCIÓNFecha en que se realizó la transacción.

8 N

TBK_HORA_TRANSACCIÓNHora en la que se realizó la transacción

6 N

TBK_ID_TRANSACCIÓN Identificador de transacción. 20 N

TBK_TASA_INTERES_MAXTasa de interés máxima permitida del periodo.

4 N

TBK_MAC Firma digital 32 NTabla 17. Parámetros de entrada de la Modalidad Consulta de Tasa.

TRANSBANK S.A.43

10. ARCHIVOS GENERADOS POR EL KCC

El KCC genera dos tipos de archivos logs, un log de eventos y un log de transacciones. Ambos archivos de logs se generan en el directorio $(PATH_DIRCGI_DISCO)/log y son de texto.

10.1 ARCHIVO DE LOG DE EVENTOS

En este archivo se escriben todos los logs informativos, de error o fatales según lo configurado en el archivo tbk_trace.dat. Se genera un archivo distinto por cada día y el nombre del archivo es de la forma TBK_EVN$(FECHA).log.

Donde:$(FECHA): corresponde a la fecha en formato aaaammdd.

El formato de este archivo es el que se muestra a continuación:

Variable Descripción Largo Tipo

ID_PROCESO Número único por transacción 10 N

ID_OPERACION Proceso que se está registrando 10 A

PARAMETROSDatos relevantes, Ejemplo: Id_comercio, id_venta

40 A

FECHA Formato ddmmaaaa 14 N

HORA Formato hhmmss 6 N

IP IP máquina en que se está procesando 15 A

RESULTADO

Resultado operación, donde :OK = evento correctoKO = evento incorrecto

3 A

ID_COMERCIO Id_comercio que origina requerimiento 20 N

DESCRIPCIÓN Descripción evento o error 50 A

Tabla 18. Formato log de eventos.

Observación: Todas las variables están ordenadas en una sola línea, así se genera una línea por transacción.

10.2 ARCHIVO DE LOG DE TRANSACCIONES

TRANSBANK S.A.44

Este archivo contiene una línea con cada transacción ejecutada y almacena la data que entrega el cgi tbk_bp_resultado.cgi a la página de confirmación de la transacción.

El nombre de este archivo es TBK_$(TIPO_TRANSACCIÓN)_$(FECHA).log.

Donde: $(TIPO_TRANSACCIÓN) = TR_NORMAL, TR_MALL, etc. $(FECHA) = mmdd o aaaammdd.

El formato de este archivo es el que se muestra a continuación en la Tabla 19:

TRANSBANK S.A.45

Variable Descripción Largo Tipo

TBK_ORDEN_COMPRANúmero de la orden de compra generada por el comercio (número único por transacción).

26 A

TBK_TIPO_TRANSACCION Indica el tipo de Modalidad utilizada. 50 A

TBK_RESPUESTA Respuesta entregada por Transbank 2 N

TBK_MONTOMonto de la transacción entregado por el comercio.

10 N

TBK_CODIGO_AUTORIZACION

Código de autorización entregado por Transbank.Solo tienen código las transacciones aprobadas “R=0”.

6 N

TBK_FINAL_NUMERO_TARJETA

Campos correspondientes a datos de la tarjeta que no son entregados al comercio Internet “sin envío de tarjeta 00000”.

17 N

TBK_FECHA_CONTABLE Fecha (mm/dd). 4 N

TBK_FECHA_TRANSACCION Fecha (mm/dd) de la transacción. 4 N

TBK_HORA_TRANSACCION Hora (hh/mm/ss) de la transacción. 6 N

TBK_ID_SESION Identificador de la sesión. 61 A

TBK_ID_TRANSACCION Identificador de la transacción. 20 N

TBK_TIPO_PAGO Tipo de pago utilizado. 2 A

TBK_NUMERO_CUOTAS Numero de cuotas 1 N

TBK_TASA_INTERES_MAXSolo CI. Tasa de interés máxima permitida del periodo.

4 N

TBK_MONTO_CUOTASolo CI. Monto correspondiente de cada cuota.

9 N

Tabla 19. Formato log de transacciones

Observación: Todas las variables están ordenadas en una sola línea, así se genera una línea por transacción.

10.3 CÓDIGOS DE RESPUESTA

TRANSBANK S.A.46

Los códigos de respuesta que entrega TRANSBANK a la tienda virtual se definen el la Tabla 20.

TBK_RESPUESTA Definición 0 Transacción aprobada.-1 Rechazo de tx. En B24-2 Transacción debe reintentarse-3 Error en tx.-4 Rechazo de tx. En B24-5 Recazo por error de tasa-6 Excede cupo máximo mensual-7 Excede límite diario por

transacción-8 Rubro no autorizado

Tabla 20. Definición de Códigos de Respuesta.

TRANSBANK S.A.47

11. EJEMPLO DE INTEGRACIÓN DE KCC CON EL SOFTWARE DE COMERCIO

Para la mejor comprensión de la integración del KCC con un software de comercio electrónico, se muestra a continuación un ejemplo.

11.1 SUPOSICIONES:

Tipo De Transacción NORMALDirección Física SUPERCOMERCEDirección Web www.supercomerce.clCódigo de Comercio 597026018034IP Servidor de Comercio 198.22.250.29Puerto de acceso al Servidor de Comercio 80URL Servidor de Pago pruebas.webpay.clPuerto de acceso al Servidor de Pago 5443Plataforma Windows NT Servidor Web ISS

Tabla 20. Suposiciones ejemplo de integración KCC.

Hechas estas suposiciones los pasos para integrar el KCC con el comercio son los siguientes.

11.2 CREACIÓN DE DIRECTORIO DE CGIS

Dentro del directorio “C:\SUPERCOMERCE” crear el directorio “cgi-bin”. Configurar el directorio “cgi-bin” desde el ISS de Windows NT con permisos de

ejecución (incluyendo scripts).

11.3 CREACIÓN DE ESTRUCTURA DE DIRECTORIOS, COPIA DE ARCHIVOS Y DEFINICIÓN DE PERMISOS

Dentro del directorio “C:\SUPERCOMERCE\cgi-bin” crear los directorios: “datos”, “maestros” y “template”. Luego habilitar desde el IIS permiso de lectura.

Dentro del directorio “C:\SUPERCOMERCE\cgi-bin” crear los directorios: “log” y “temporal”. Luego habilitar desde el IIS permisos de lectura y escritura.

Copiar los cgis tbk_bp_pago.cgi, tbk_bp_resultado.cgi y tbk_check_mac.cgi al directorio “C:\SUPERCOMERCE\cgi-bin”.

Copiar el archivo tbk_comercio.db al directorio “maestros”. Luego habilitar desde el IIS permiso de lectura.

Copiar el archivo “reintento.html” al directorio “templates”. Luego habilitar desde el IIS permiso de lectura.

Crear los archivos tbk_trace.dat y tbk_config.dat (vacíos por ahora) dentro del directorio “datos”. Luego habilitar desde el IIS permisos de lectura”.

11.4 CONFIGURACIÓN DE KCC

TRANSBANK S.A.48

11.4.1 ARCHIVO DE CONFIGURACIÓN TBK_CONFIG.DAT

Editar el archivo tbk_config.dat y agregar el siguiente contenido:

11.4.2 ARCHIVO DE CONFIGURACIÓN TBK_TRACE.DAT

Agregar la siguiente línea al archivo:

11.5 PÁGINAS DE LLAMADA AL KCC

La llamada al KCC se hace a través del cgi tbk_bp_pago.cgi el que a su vez debe ser llamado desde la página de pago del comercio. Este archivo tiene como objetivo recoger la información de la compra que se pretende realizar. Así de acuerdo a los parámetros de entrada de una transacción normal, este formulario de pago tiene la siguiente forma:

11.6 PAGINA ÉXITO Y FRACASO

TRANSBANK S.A.

IDCOMERCIO = 597026018034URLCGICOM = /cgi-bin/tbk_bp_resultado.cgiSERVERCOM = 198.22.250.29PORTCOM = 80HOST = 198.22.250.29WPORT = 80URLCGITRA = /cgi-bin/bp_revision.cgiSERVERTRA = https://pruebas.webpay.clPORTTRA = 5443PREF_CONF_TR = HTML_HTML_TR_NORMAL = /SUPERCOMERCE/xt_compra.asphttp_REFERER = http://www.supercomerce.cl/pagar.asp

GLEVEL = 7

<FORM METHOD="POST" ACTION="/SUPERCOMERCE/cgi-bin/tbk_bp_pago.cgi"><INPUT TYPE="TEXT" NAME="TBK_TIPO_TRANSACCION" VALUE="TR_NORMAL"> <INPUT TYPE="TEXT" NAME="TBK_MONTO" VALUE="10000"> <INPUT TYPE="TEXT" NAME="TBK_ORDEN_COMPRA" VALUE="5fx9022222"> <INPUT TYPE="TEXT" NAME="TBK_ID_SESION" VALUE="123456789><INPUT TYPE="TEXT" NAME="TBK_URL_EXITO" SIZE=40 VALUE="http://www.supercomerce.cl/exito.asp" SIZE=50><INPUT TYPE="TEXT" NAME="TBK_URL_FRACASO" SIZE=40 VALUE=" http://www.supercomerce.cl/fracaso.asp" SIZE=50><INPUT TYPE="submit" value="Pagar con Tarjeta de Crédito" SIZE=20> </FORM>

49

El parámetro TBK_URL_FRACASO corresponde a la URL que contiene a la página que se llamará en el caso que la transacción fracase. No hay ningún requerimiento sobre esta página, basta con que contenga un mensaje apropiado que de a entender al usuario que la transacción no se realizó.

El parámetro TBK_URL_EXITO corresponde a la URL que contiene a la página que se llamará en caso que la transacción se haya ejecutado correctamente.

11.7 PAGINA DE CIERRE

Esta pagina debe ser capaz de extraer el código de autorización que entrega Transbank y posteriormente confirmar la transacción por parte del comercio, de ser exitosa la operación anterior debe devolver por la misma vía un string “ACEPTADO”. Como forma de prueba se puede generar el siguiente código ASP que siempre acepta la transacción y guarda el código de autorización en un archivo temporal.

Esta pagina se debe guardar con el nombre xt_compra.asp o con el que se configura en el archivo tbk_config.dat bajo el parámetro HTML_TR_NORMAL.

11.7.1 VALIDACIÓN DE MAC

La validación del MAC se realiza a través del programa tbk_check_mac, al cual se debe ejecutar entregándole un archivo que contenga todos los parámetros recibidos. La salida estándar del programa entregara un “0” si el MAC es correcto. A continuación de muestra un ejemplo de una pagina de cierre utilizando tal validación.

Ejemplo en ASP:

TRANSBANK S.A.

<html><%myPath = "c:\temporal.txt"set filesys=CreateObject("Scripting.FileSystemObject")set file=filesys.CreateTextFile( myPath )file.write( Request.Form("TBK_CODIGO_AUTORIZACION") )file.Close%>ACEPTADO</html>

<html><%'*** Ejemplo de Pagina de Cierre usando validador de MAC ***'*** DCE - Transabnk S.A. - Mayo 2001 ***

' Función de validación de MAC' (salida es 0 si MAC es correcto)

function check_mac () path = "d:\Certificacion_WebPay\Kcc\kcc_normal\cgi-bin" filename= path & "\temporal\" & Request.Form("TBK_ID_TRANSACCION")&".tmp" set filesys = CreateObject("Scripting.FileSystemObject") set file = filesys.CreateTextFile (filename) file.write (Request.Form()) file.close () str = path & "\tbk_check_mac.exe " & filename Set WshShell = CreateObject ("WScript.Shell") iReturn = WshShell.Run (str, 0, TRUE) set file = filesys.GetFile (filename) file.delete () check_mac = iReturnend function%><%' Captura del Codigo de Autorización' (se graba en archivo temporal de texto)

myPath = "c:\temporal.txt"set filesys=CreateObject("Scripting.FileSystemObject")set file=filesys.CreateTextFile( myPath )file.write( Request.Form("TBK_CODIGO_AUTORIZACION") )file.Close%><%' Validación del MACresultado = check_mac()if (resultado = 0) then' (aquí, además, se debe incluir la lógica de validación de' la transacción y el registro del código de autorización' en la base de datos de la tienda virtual)%>ACEPTADO<% elseRECHAZADO%><% end if %></html>

50

TRANSBANK S.A.51

Ejemplo en PHP:

TRANSBANK S.A.

<?php

/* WEBPAY: Ejemplo de pagina de cierre con uso de tbk_check_mac CSS - DCE - Transbank S.A.- Mayo 2001 */

/* 1.- Abrir archivo y guardar variables POST recibidas */

$filename = "/tmp/log$TBK_ID_TRANSACCION.txt";$fp=fopen($filename,"w");reset($HTTP_POST_VARS);while (list($key,$val) = each($HTTP_POST_VARS)){ fwrite($fp,"$key=$val&");}fclose($fp);

/* 2.- Invocar a tbk_check_mac (Que en realidad no es una cgi) usando como parámetro el archivo generado */

$cmdline = "/home/csantiba/public_html/cgi-bin/tbk_check_mac.cgi $filename";exec($cmdline,$result,$retint);

/* Si $result[0]="CORRECTO" , entonces mac válido/

if ($result[0]=="CORRECTO") {

/* Aquí la lógica de validación de la transacción y el registro de código de autorización en la base de datos de la tienda virtual. No olvidar de validar que TBK_MONTO sea igual al enviado. */ echo "ACEPTADO"; } else echo "RECHAZADO";

?>

52

ANEXO A

DATOS AMBIENTE DE DESARROLLO WEBPAY

DATOS DE L SERVIDOR DE PRUEBA

URL Servidor de Pago https://pruebas.webpay.clPuerto Servidor de Pago 5443

DATOS CODIGO DE COMERCIO

Modalidad Normal 597026008034Modalidad Completa 597026008905Modalidad One Click 597026008913Modalidad Mall

Tienda Mall 1 Tienda Mall 2

597026010039597026010047597026010055

Modalidad Mall Completo 597026014964 Tienda Mall 1 597026014980 Tienda Mall 2 597026015006

Modalidad Mall Completo 597026016797 Tienda Mall 1 597026016940

Observación: Cada código de comercio tiene asociado una llave, la cual es suministrada por Transbank S.A.

DATOS TARJETA DE CRÉDITO

Marca VISA MASTERCARDNº de Tarjeta 4508000021111116 5390212511111112Año Expiración

2005 2001

Mes Expiración

12 01

Resultado APROBADO RECHAZADO

HORARIO

24 hrs, 7 días a la semana.

TRANSBANK S.A.53

ANEXO B

PREGUNTAS FRECUENTES Pregunta¿ Qué es Kit de Conexión de Comercio y como se realiza la instalación de los CGI ?RespuestaEl Kit de Conexión de Comercio (KCC) de Transbank, consiste en dos CGI (Programas ejecutables) que deben ser copiados en el servidor donde operará la tienda virtual.Estos CGI deben ser “integrados” con las páginas de la tienda.

El primer CGI debe ser invocado al momento de iniciar un pago. El pago se efectuará cuando la tienda cuente con el monto final de la compra y un número de compra, que permite identificar la operación.

El CGI se comunicará con un servidor de Transbank, el cual solicitará los datos de la Tarjeta de Crédito (TC) al comprador.

Cuando se tenga una respuesta sobre la transacción (aproximadamente 1 segundo después de la solicitud) desde Transbank se ejecutará la segunda CGI en el sitio del comercio, la que recibirá el resultado de la transacción (aprobado o rechazado)

La tarea de integración consiste, entonces, en ejecutar la primera CGI desde la tienda virtual al momento de iniciar un proceso de pago con TC y en segundo lugar capturar el resultado de la operación desde la segunda CGI de modo de obtener y registrar un código de autorización enviado por Transbank.

Por lo que el manejo del carro de compras u otras características con respecto al procedimiento de selección de los ítemes a comprar siempre depende de la solución del Comercio.

Pregunta¿ Que productos entrega Transbank ?RespuestaTransbank entrega a sus clientes el Kit de Conexión de Comercio (KCC) el cual consiste en dos programas que se ejecutarán vía CGI en la tienda virtual.

Actualmente estos CGI se encuentran disponibles para Windows NT, SUN Solaris, Linux Redhat 6.xx, AIX. Hasta este momento KCC ha sido integrado en una variada combinación de soluciones tecnológicas que incluye servidores web como IIS, Netscape, APACHE y Lotus Domino. Además ha sido utilizado en soluciones de comercio electrónico tales como Siteserver, Intershop, INEX, Netcommerce y otras (Incluyendo soluciones propietarias)

TRANSBANK S.A.54

Pregunta¿ Que pasa si tengo definido varios servidores virtuales en un solo servidor físico ?RespuestaEn el archivo tbk_config.dat debe configurarse el parámetro URLCGICOM con la dirección de referencia lógica completa.

Ejemplo: URLCGICOM = http://www.supercomerce.cl/cgi-bin/tbk_bp_resultado.cgi

Pregunta¿ Por qué no tengo respuesta desde Transbank?Respuesta 1Puede que estén mal configurados los parámetros PORTCOM y WPORT en el archivo tbk_config.dat. Estos indican el valor de los puertos del Servidor de Comercio y del Servidor de las paginas de éxito y fracaso. La mayoría de las veces estas últimas están ubicadas en el mismo Servidor del Comercio por lo tanto los puertos son iguales y los parámetros tienen el mismo valor. Se acostumbra a utilizar el puerto por defecto 80 ó 5555.Respuesta 2Puede que el parámetro SERVERTRA ubicado en el archivo tbk_config.dat no tenga la dirección del Servidor de Pago correcta o este mal referenciada, esta debe ser de la forma https.

Ej: https://pruebas.webpay.clRespuesta 3Puede que el parámetro PORTTRA en el archivo tbk_config.dat este mal configurado y no corresponda al asignado por Transbank.

ANEXO C

TRANSBANK S.A.55

RECOMENDACIONES A LA SEGURIDAD DEL KCC

Dejar habilitado un puerto exclusivo para la comunicación con Transbank S.A. en el firewall del comercio si es que lo tuviese.

Manejar en forma segura la llave de comercio entregada a la tienda para evitar algún posible plagio de la tienda.

Las paginas de cierre de transacciones deben ubicarse en un directorio virtual distinto del resto de las páginas de la tienda virtual. Este directorio debe protegerse de tal forma que permita la ejecución de dichas páginas sólo desde el servidor donde se encuentra tbk_bp_resultado. Habitualmente el mismo directorio.

Configurar correctamente el parámetro TBK_REFERER en el archivo de configuración del Kit KCC.

TRANSBANK S.A.56

ANEXO D

CERTIFICACIÓN EFECTUADA POR TRANSBANK

Recibida la Solicitud de Certificación de Integración, personal de Transbank realizará pruebas con el objetivo de verificar que el proceso de integración efectuado por el Establecimiento se haya realizado exitosamente y que los números de orden de pedido generados por la tienda sean correctamente interpretados por el comercio.

Para poder efectuar este proceso, el Establecimiento en certificación debe quedar habilitado para que Transbank ingrese (en forma remota a través de Internet o en las dependencias del Establecimiento) el set de transacciones de certificación.

Luego de este proceso el Establecimiento debe entregar a Transbank el archivo de transacciones que se generó en su servidor web (ejemplo tbk_bitácora_TR_NORMALmmdd.log), el cual se utilizará para validar la correcta integración de su sitio con el KCC.

Adicionalmente en esta etapa Transbank verificará el cumplimiento de los siguientes requisitos establecidos para el sitio web del Establecimiento:

Indicar claramente la identidad del Establecimiento. Indicar el país donde se encuentra el Establecimiento. Incluir una descripción completa de los bienes y/o servicios (tallas/tamaños ropa,

voltaje, etc.). Indicar las políticas del Establecimiento relacionadas con devoluciones y reembolsos. Indicar la política de entrega de productos del Establecimiento. Por ejemplo, si la

entrega está limitada al país en que está radicado el comercio, cuándo puede esperar el tarjetahabiente recibir la entrega, etc.

Indicar, cuando las haya, las restricciones para la exportación. Indicar claramente los costos totales de los productos y servicios, incluyendo todos

los cargos de envío e impuestos. Exponer el valor de los productos y servicios en la moneda correspondiente para la

cual el Establecimiento contrató el servicio Webpay. Indicar el país y moneda de la transacción. Incluir los logotipos de las marcas y del servicio Webpay de acuerdo a las

indicaciones de señal ética existentes en la página web http://www.webpay.cl/logos.htm

Incluir el logotipo de Tres cuotas sin intereses en el caso de que el comercio se haya afiliado a esta modalidad de venta.

Indicar algún modo de contacto para servicio de atención al cliente. Entregar al tarjetahabiente un comprobante físico o electrónico

TRANSBANK S.A.57

ENTREGA DEL PRODUCTO/SERVICIO Y NOTIFICACIÓN DE COMPRA

En caso de que la transacción sea aprobada por Transbank, el Comercio deberá despachar el o los productos seleccionados por el tarjetahabiente o prestar el servicio pagado según corresponda.

INFORMACIÓN A DESPLEGAR EN PAGINA DE ÉXITO O RESULTADO

El Comercio Internet está obligado a entregar al tarjetahabiente, una vez concluida la venta, un recibo de la compra que debe contener como mínimo la siguiente información:

4 últimos dígitos de la tarjeta de crédito. (informado por Transbank) Número de orden de Pedido Nombre del comercio URL del comercio (dirección on line del comercio) Monto y moneda de la transacción Fecha de la transacción Nombre del comprador Código de autorización Tipo de transacción: se debe indicar la palabra Venta Número de Cuotas: Se debe indicar el número de cuotas informado por Transbank

(para las transacciones sin cuotas se debe informar 00) Tipo de Cuotas: se debe señalar lo siguiente dependiendo de la respuesta informada

por Transbank:o Sin Cuotas: si se trata de ventas sin cuotas.o Normales: si se trata de cuotas normaleso Sin intereses: si se trata de tres cuotas sin intereseso Cuotas Comercio: Si se trata de ventas en modalidad cuotas Comercio.o Descripción de los bienes y/o servicioso Una lista de cualquier restricción relacionada con las devoluciones de

reembolsos.

Este recibo además puede enviarse a través de algún medio electrónico o físico cuando la mercadería sea entregada al tarjetahabiente.

TRANSBANK S.A.58

ANEXO E

CALCULO DEL VALOR CUOTA

Las siguientes son las fórmulas utilizadas para el cálculo del Valor Presente (precio contado) y del Valor Cuota, referidos a la tasa máxima convencional.

El VALOR PRESENTE a la máxima se obtiene aplicando la siguiente fórmula:

Valor Presente a Máxima =

Donde: Vc: es el monto de la cuota (informado en la Tx) Tm: es la tasa Máxima Definida (almacenada en tabla) n :es el número de cuotas (informado en Tx).

EL VALOR CUOTA se obtiene despejando de la fórmula anterior:

=

el extracto corresponde al factor F.

Luego:

Vc = Precio Contado * F

Donde:

F: es función del nº cuotas y de la Tm.Nº cuotas: 6 a 24Tm: se modifica mensualmente y se publica en el

diario oficial entre el día 8 y 10 de cada mes.

TRANSBANK S.A.59

ANEXO F

TIPIFICACIÓN DE ERRORES

Los errores se verifican en la pagina que lo genera haciendo una vista al código fuente y observando al pie del código generado el numero del error ocurrido. Además estos quedan registrados en los logs de eventos.

Nº Error

Código Error Descripción

TRANSBANK S.A.60

0 SIN_ERR No hay errores1 ERR_LECTURA_INPUT Error de lectura e el Input

2 ERR_LETURA_PARAMETROSError en lectura de parámetros archivo

3 ERR_PARAM_CODIGO_COMERCIOError en parámetro CODIGO_COMERCIO

4 ERR_PARAM_URL_CGI_COMERCIOFalta parámetro URL_CGI_COMERCIO

5 ERR_PARAM_SERVIDOR_COMERCIOFalta parámetro SERVIDOR_COMERCIO

6 ERR_PARAM_PUERTO_COMERCIOFalta parámetro PUERTO_COMERCIO

7 ERR_PARAM_URL_CGI_TRANSBANKFalta parámetro URL_CGI_TRANSBANK

8 ERR_PARAM_SERVIDOR_TRANSBANKFalta parámetro SERVIDOR_TRANSBANK

9 ERR_PARAM_PUERTO_TRANSBANKFalta parámetro PUERTO_TRANSBANK

10 ERR_MEM_MENSAJEFalta memoria para variable mensaje

11 ERR_MAC Error firma digital12 ERR_VERSION_KCC Versión de KCC no valida

13 ERR_MSG_OLDKCCVersión antigua de KCC sin variable msg

14 ERR_CODIGO_COMERCIOError en la variable CODIGO_COMERCIO

15 ERR_DATOS_COMERCIOError en datos en archivo datos de comercio

16 ERR_TIPO_TRANSACCIONError en variable TIPO_TRANSACCION

17 ERR_URL_CGI_COMERCIOError en la variable URL_CGI_COMERCIO

18 ERR_SERVIDOR_COMERCIOError en variable SERVIDOR_COMERCIO

19 ERR_PUERTO_COMERCIOError en variable PUERTO_COMERCIO

20ERR_CVV Error en variable CVV

21 ERR_DUPLICADOError por detección de transacción duplicada

22 ERR_ESTADO_COMERCIOError en estado del comercio (comercio no activo)

23 ERR_TEMPLATE_COMPRA Error en archivo template compra

Nº Error


24 ERR_TEMPLATE_COMPRA_DET Error en archivo template de detalle

TRANSBANK S.A.61

de compra

25 ERR_FECHA_EXPIRACIONError en variable VAR_FECHA_EXPIRACION

26 ERR_MONEDA_INVALIDA Error en moneda de comercio

27 ERR_TEMPLATE_REINTENTOError en archivo template de pagina de reintento

28 ERR_EDITA_MONTO Error en función edita monto29 ERR_ORDEN_COMPRA Error en variable orden de compra

30 ERR_ID_TRANSACCIONError en variable VAR_I_TRANSACCION

31 ERR_URL_EXITO Error en variable URL de Exito32 ERR_URL_FRACASO Error en variable URL de Fracaso33 ERR_MONTO Error en variable Monto34 ERR_REFERER Error en invocación (referer)

35 ERR_NUM_TRXError en variable numero de transacciones

36 ERR_MAX_TIENDAError numero de transacciones supera máximo (MALL)

37 ERR_CODIGO_TIENDAError tienda no se encuentra en nuestro comercio

38 ERR_TIENDA_NO:SOCIADAError tienda no esta asociada a comercio (MALL)

39 ERR_MONTO_TIENDA Error en variable monto tienda

40 ERR_CONF_TIENDAError de configuración tienda en maestro comercios

41 ERR_URL_RESULTADO Error en variable url_resultado

42 ERR_CONECTA_SERVIDORError al conectar servidor especificado

43 ERR_SOCKET_LECTURA Error al abrir socket para lectura44 ERR_SOCKET_ESCRITURA Error al abrir socket para escritura45 ERR_TIMEOUT_ACK Timeout al esperar ack46 ERR_OBTENER_ACK Error al obtener ack47 ERR_ORDEN_TIENDA Error variable orden compra tienda

48 ERR_NUMERO_TARJETAError en variable VAR_NUMERO_TARJETA

49 ERR_NUMERO_CUOTASError en variable VAR_NUMERO_CUOTAS

50 ERR_MES_VENCIMIENTOError en variable VAR_MES_VENCIMIENTO

51 ERR_ANO_VENCIMIENTOError en variable VAR_ANO_VENCIMIENTO

52 ERR_TARJETAError en variable VAR_ANO_VENCIMIENTO

Nº Error


53 ERR_TIPO_PAGOError en variable VAR_TIPO_PAGO

TRANSBANK S.A.62

54 ERR_RESPUESTA_BASE24 Error en respuesta del base2455 ERR_ACK Error al obtener ACK56 URL_FRACASO_MALL Error variable Fracaso MALL57 ERR_TIENDA_EN_NULO Error en variable de tienda MALL

58 ERR_PARAM_PREF_CONF_TRError en parámetro PARAM_PREF_CONF_TR

59 ERR_PARAM_URL_CONF_TRError en parámetro de pagina de confirmación

60 ERR_PARAM_PUERTO_CONF_TRError en parámetro PARAM_SERVIDOR_CONF_TR

61 ERR_PARAM_SERVIDOR_CONF_TRError en parámetro PARAM_SERVIDOR_CONF_TR

62 ERR_FECHA_TRANSACCIONError en variable VAR_FECHA_TRANSACCION

63 ERR_ABRIR_BITACORA Error al abrir el archivo de bitácora64 ERR_FALLO_CUOTA_NORMAL Fallo venta en cuotas65 ERR_FALLO_CUOTA_C3C Fallo venta contado 3 cuotas66 ERR_MONEDA_DESCONOCIDA Error código moneda desconocido

67 ERR_TIENDA_NOENCONTRADAError tienda no encontrada en maestro

68 ERR_TIENDA_NOASOCIADAError tienda no esta asociada a MALL

69 ERR_TIENDA_DIF_MONEDA Error tienda con distinta moneda70 ERR_SINMEMORIA Error no se puede obtener memoria71 ERR_MONTO_DESCUADRADO Error monto descuadrado

72 TRX_DESCUADRADASError numero de transacciones descuadradas

73 ERR_TEMPLATE_ONECLICK Error al abrir template de one click74 ERR_TIENDA_TIPO_PAGO Error en variable tienda tipo pago

75 ERR_ID_USUARIOError en variable VAR_ID_USUARIO

76 ERR_USUARIO_YA_REGISTRADOUsuario ya estaba registrado en la base de datos one_click

77 ERR_INSERTAR_ONECLICKError al intentar insertar usuario en base de datos one_click

78 ERR_USUARIO_NO_REGISTRADOUsuario no esta registrado en la base de datos one_click

79 ERR_LEER_ONECLICKError al intentar leer usuario en base de datos one_click

80ERR_TEMPLATE_TRANSICIÓN

Error al abrir template de transición

81 ERR_LOGO_WEBPAYError en validación LOGO WEBPAY

82ERR_TEMPLATE_LOGO_WEBPAY Error en template de LOGO

Nº Error


83 ERR_ACTUALIZAR_ONECLICK Error al actualizar la base de datos

TRANSBANK S.A.63

one_click

84 ERR_ELIMINAR_ONECLICKError al eliminar de la base de datos one_click

85 ERR_TEMPLATE_MENSAJE Error al abrir template de mensajes

86 ERR_NUMERO_TARJET_ANTIGUAError en variable VAR_NUMERO_TARJETA_ANTIGUA

87 ERR_ONECLICK_DESHABILITADOComercio no tiene habilitado one click

88 ERR_TR_COMPLETA_DESHABILITADAComercio no tiene habilitada la transacción completa

89 ERR_CAMBIO_MULTICODEError en cambio de multicodigo, variable vacía

90 ERR_RESPUESTA Error en variable VAR_RESPUSTA91 ERR_LARGO_TIENDA Error largo variable tienda

92 ERR_CORRESPONDENCIA_CUOTASNumero de cuotas invalido para tipo de pago indicado

93 ERR_TIPO_PAGO_DESHABILITADOTipo de pago no esta habilitado para el comercio

94 ERR_ENVIO_REG_ONECLICKError al intentar espejar registro one click modificado

95 ERR_ID_SESION Error en variable ID_SESION

96 ERR_TIPO_TBK_TIPO_TRANSACCIONError Tipo Dato variable TIPO_TRANSACCION

97 ERR_TIPO_TBK_CODIGO_COMERCIOError Tipo Dato var. CODIGO COMERCIO

98 ERR_TIPO_TBK_ID_TRANSACCIONError Tipo Dato var. ID_TRANSACCION

99 ERR_TIPO_TBK_URL_CGI_COMERCIOError Tipo Dato variable CGI_COMERCIO

100ERR_TIPO_TBK_SERVIDOR_COMERCIO

Error Tipo Dato variable SERVIDOR_COMERCIO

101 ERR_TIPO_TBK_PUERTO_COMERCIOError Tipo Dato variable PUERTO_COMERCIO

102ERR_TIPO_TBK_VERSION_KCC Error Tipo Dato variable

VERSION_KCC103 ERR_TIPO_TBK_MAC Error Tipo Dato variable MAC

104 ERR_TIPO_TBK_MONTOError Tipo Dato variable MONTO

105 ERR_TIPO_TBK_ORDEN_COMPRAError Tipo Dato variable ORDEN COMPRA

106 ERR_TIPO_TBK_ID_SESION Error Tipo Dato variable ID_SESION

Nº Error


107 ERR_TIPO_TBK_URL_ÉXITOError Tipo Dato variable URL_ÉXITO

TRANSBANK S.A.64

108 ERR_TIPO_TBK_URL_FRACASOError Tipo Dato variable URL_FRACASO

109 ERR_TIPO_TBK_TARJETA Error Tipo Dato variable TARJETA

110 ERR_TIPO_TBK_TIPO_PAGOError Tipo Dato variable TIPO_PAGO

111 ERR_TIPO_TBK_NUMERO_CUOTASError Tipo Dato variable NUMERO_CUOTAS

112 ERR_TIPO_TBK_NUMERO_TARJETAError Tipo Dato variable NUMERO_TARJETA

113 ERR_TIPO_TBK_MES_VENCIMIENTOError Tipo Dato variable MES_VENCIMIENTO

114 ERR_TIPO_TBK_ANO_VENCIMIENTOError Tipo Dato variable ANO_VENCIMIENTO

115 ERR_TIPO_TBK_CVV Error Tipo Dato variable CVV

116 ERR_LEN_TBK_TIPO_TRANSACCIONError Largo variable TIPO_TRANSACCION

117 ERR_LEN_TBK_CODIGO_COMERCIOError Largo variable CODIGO_COMERCIO

118 ERR_LEN_TBK_ID_TRANSACCIONError Largo variable ID_TRANSACCION

119 ERR_LEN_TBK_URL_CGI_COMERCIOError Largo variable URL_CGI_COMERCIO

120 ERR_LEN_TBK_SERVIDOR_COMERCIOError Largo variable SERVIDOR_COMERCIO

121 ERR_TIPO_TBK_PUERTO_COMERCIOError Largo variable PUERTO_COMERCIO

122 ERR_LEN_TBK_VERSION_KCCError Largo variable VERSION_KCC

123 ERR_LEN_TBK_MAC Error Largo variable MAC124 ERR_LEN_TBK_MONTO Error Largo variable MONTO

125 ERR_LEN_TBK_ORDEN_COMPRAError Largo variable ORDEN_COMPRA

126 ERR_LEN_TBK_ID_SESION Error Largo variable ID_SESION127 ERR_LEN_TBK_URL_EXITO Error Largo variable URL_ÉXITO

128 ERR_LEN_TBK_URL_EXITOError Largo variable URL_FRACASO

129 ERR_LEN_TBK_TARJETA Error Largo variable TARJETA130 ERR_LEN_TBK_TIPO_PAGO Error Largo variable TIPO_PAGO

131 ERR_LEN_TBK_NUMERO_CUOTASError Largo variable NUMERO_CUOTAS

132 ERR_LEN_TBK_NUMERO_TARJETAError Largo variable NUMERO_TARJETA

Nº Error


133 ERR_LEN_TBK_MES_VENCIMIENTOError Largo variable MES_VENCIMIENTO

TRANSBANK S.A.65

134 ERR_LEN_TBK_ANO_VENCIMIENTOError Largo variable ANO_VENCIMIENTO

135 ERR_LEN_TBK_CVV Error Largo variable CVV

136 ERR_TIPO_TBK_URL_RESULTADOError tipo variable URL_RESULTADO

137 ERR_TIPO_TBK_NUM_TRX Error tipo variable NUM_TRX

138 ERR_TIPO_TBK_CODIGO_TIENDAError tipo variable CODIGO_TIENDA

144 ERR_LEN_TBK_CODIGO_TIENDAError largo variable CODIGO_TIENDA

145 ERR_LEN_TBK_ORDEN_TIENDAError largo variable ORDEN_TIENDA

146 ERR_LEN_TBK_MONTO_TIENDAError largo variable MONTO_TIENDA

147 ERR_LEN_TBK_ID_USUARIO Error largo variable ID_USUARIO

148 ERR_LEN_PARAM_TR_NORMALError largo parámetros TR_NORMAL

149 ERR_LEN_PARAM_TR_MALL Error largo parámetros TR_MALL

150 ERR_LEN_PARAM_TR_COMPLETAError largo parámetros TR_COMPLETA

151 ERR_LEN_PARAM_TR_ONECLICKError largo parámetros TR_ONECLICK

152ERR_LEN_PARAM_TR_INGRESO_ONCLICK

Error largo parámetros TR_INGRESO_ONECLICK

153ERR_LEN_PARAM_TR_ELIMINACION_ONCLICK

Error largo parámetros TR_ELIMINACION_ONECLICK

154ERR_LEN_PARAM_TR_MODIFICACION_ONCLICK

Error largo parámetros TR_MODIFICACION_ONECLICK

155ERR_LEN_PARAM_TR_MALL_COMPLETA

Error largo parámetros TR_MALL_COMPLETA

156 ERR_LEN_PARAM_TR_MALL_ONECLICKError largo parámetros TR_MALL_ONECLICK

157 ERR_LEN_PARAM_TR_LOGO_WEBPAYError largo parámetros TR_LOGO_WEBPAY

158 ERR_CANT_PARAM_TR_NORMALError cantidad parámetros TR_NORMAL

159 ERR_CANT_PARAM_TR_MALLError cantidad parámetros TR_MALL

160 ERR_CANT_PARAM_TR_COMPLETAError cantidad parámetros TR_COMPLETA

161 ERR_CANT_PARAM_TR_ONECLICKError cantidad parámetros TR_ONECLICK

Nº Error


162 ERR_CANT_PARAM_TR_INGRESO_ONECLICKError cantidad parámetros TR_ING_ONECLICK

TRANSBANK S.A.66

163 ERR_CANT_PARAM_ELIMINACION_ONECLICKError cantidad parámetros TR_ELIMIN_ONECLICK

164ERR_CANT_PARAM_TR_MODIFICACION_ONECLICK

Error cantidad parámetros TR_MODIF_ONECLICK

165 ERR_CANT_PARAM_TR_MALL_COMPLETAError cantidad parámetros TR_MALL_COMPLETA

166 ERR_CANT_PARAM_TR_MALL_ONECLICKError cantidad parámetros TR_MALL_ONECLICK

167 ERR_CANT_PARAM_TR_LOGO_WEBPAYError cantidad parámetros TR_LOGO_WEBPAY

168 ERR_TIPO_TBK_URL_FRACASO_MALLError Tipo Dato variable URL_FRACASO_MALL

169 ERR_LEN_TBK_URL_FRACASO_MALLError Largo variable URL_FRACASO_MALL

170 ERR_TIPO_TBK_FECHA_EXPIRACIONError Tipo Dato variable FECHA_EXPIRACION

171 ERR_LEN_TBK_FECHA_EXPIRACIONError Largo variable FECHA_EXPIRACION

172 ERR_TIPO_TBK_URL_COMERCIOError Tipo Dato variable URL_COMERCIO

173 ERR_LEN_TBK_URL_COMERCIOError Largo Dato variable URL_COMERCIO

174 ERR_TIPO_TBK_MONTO_CUOTAError Tipo Dato variable MONTO_CUOTA

175 ERR_LEN_TBK_MONTO_CUOTAError Largo Dato variable MONTO_CUOTA

176 ERR_MONTO_CUOTAError en la variableMONTO_CUOTA

177 ERR_TR_TASA_INTERES_DESHABILITADAError Tasa De Interés Deshabilitada

178 ERR_LEN_PARAM_TR_TASA_INTERES_MAXError Largo Dato variable TR_TASA_INTERES_MAX

179 ERR_CANT_PARAM_TR_TASA_INTERES_MAXError cantidad parámetros TR_TASA_INTERES_MAX

180 ERR_CONSISTENCIA_CIC

Error por no consistencia entre tiendas de un mall para tipo de pago CIC. Deben ser todas CIC o ninguna.

181 ERR_FALLO_CUOTA_CICError en cuota asociada a CIC.

TRANSBANK S.A.67

manual kcc40 1

Documents