Transbank S.A.: Kit de Conexión de Comercio KCC Versión 2.0 - 4.0

Transbank S.A.
Gerencia de Desarrollo y Tecnologa
Manual de Integracin
Kit de Conexin de Comercio KCC Versin 2.0 4.0
( Versin Borrador )
INDICE
Nomenclaturas Generales.................................................................................................. 4 1. Introduccin ................................................................................................................. 6 2. Que es el KCC ?......................................................................................................... 6 3. Etapas Tcnicas de Incorporacin a WebPay................................................................. 7 3.1 Desarrollo ............................................................................................................... 7 3.2 Produccin .............................................................................................................. 7 4. Atributos de WebPay .................................................................................................... 7 5. Apreciacin global del proceso de la Transaccin Electrnica....................................... 7 6. Modalidades de uso soportadas por WebPay................................................................. 8 6.1 Tipos De Modalidades............................................................................................. 8 6.1.1 Modo de Operacin de la Modalidad Normal .................................................... 9 6.2 Tipo de Moneda ...................................................................................................... 9 6.3 Modalidad de Captura ............................................................................................. 9 7. Arquitectura del KCC ................................................................................................. 11 7.1 Definiciones Generales........................................................................................... 11 7.1.1 Subprogramas ................................................................................................. 11 7.1.2 Flujo de Informacin entre Servidor de Comercio y Servidor de Pago ............. 12 7.1.3 Condiciones de Excepcin............................................................................... 13 8. Integracin del KCC con el software de la Tienda Virtual............................................ 16 8.1 Instalacin del KCC............................................................................................... 16 8.1.1 Creacin de estructura de Directorios............................................................. 16 8.1.2 Definicin de Permisos.................................................................................... 17 8.1.3 Copia de Archivos........................................................................................... 18 8.2 Configuracin del KCC ......................................................................................... 20 8.2.1 Configuracin del archivo Tbk_config.dat ....................................................... 21 8.2.2 Configuracin del archivo Tbk_trace.dat ......................................................... 23 8.3 Creacin de Paginas de Comercio.......................................................................... 25 8.3.1 Pgina de Pago ............................................................................................... 25 8.3.2 Pgina de Cierre para confirmar las transacciones............................................ 25 8.3.3 Pagina de Exito............................................................................................... 26 8.3.4 Pagina de Fracaso ........................................................................................... 26 8.4 Validaciones Obligatorias en Pagina De Cierre....................................................... 26 8.4.1 Validacin de Monto....................................................................................... 26 8.4.2 Validacin de MAC ........................................................................................ 26
2 TRANSBANK S.A.
9. Descripcin de las Modalidades................................................................................... 28 9.1 Modalidad Normal................................................................................................. 29 9.2 Modalidad Completa ............................................................................................. 31 9.3 Modalidad One Click............................................................................................ 32 9.3.1 Pago One Click ............................................................................................... 32 9.3.2 Ingreso a One Click......................................................................................... 33 9.3.3 Modificacin One Click................................................................................... 34 9.3.4 Eliminacin One Click..................................................................................... 36 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................................................................................ 42 10. Archivos Generados Por El KCC .............................................................................. 43 10.1 Archivo de Log de Eventos ................................................................................ 43 10.2 Archivo de Log de Transacciones ........................................................................ 44 10.3 Cdigos De Respuesta......................................................................................... 46 11. Ejemplo de Integracin de KCC con el Software de Comercio .................................. 47 11.1 Suposiciones:....................................................................................................... 47 11.2 Creacin de directorio de cgis.............................................................................. 47 11.3 Creacin de estructura de directorios, copia de archivos y.................................... 47 definicin de permisos ................................................................................................. 47 11.4 Configuracin de KCC ........................................................................................ 48 11.4.1 Archivo de configuracin tbk_config.dat ....................................................... 48 11.4.2 Archivo de configuracin tbk_trace.dat ......................................................... 48 11.5 Pginas de llamada al KCC .................................................................................. 48 11.6 Pagina xito y Fracaso ........................................................................................ 49 11.7 Pagina De Cierre ................................................................................................. 49 11.7.1 Validacin de MAC....................................................................................... 49 ANEXO A - Datos Ambiente de Desarrollo WebPay ...................................................... 52 ANEXO B - Preguntas Frecuentes .................................................................................. 53 ANEXO C - Recomendaciones a la seguridad del KCC................................................... 55 ANEXO D - Certificacin Efectuada Por TRANSBANK................................................ 56 ANEXO E - Calculo del Valor Cuota.............................................................................. 58 ANEXO F Tipificacin De Errores............................................................................... 59
3 TRANSBANK S.A.
NOMENCLATURAS GENERALES
La principales nomenclaturas utilizadas en este manual son : $(PATH_DISCO_DIRCGI) Descripcin Direccin fsica del comercio donde se instalar el KCC Genrico. Ejemplo C:\inetpub\wwwroot\comercio\cgi-bin\ (Para Windows), /home/comercio/cgi-bin/ (Para Unix) $(PATH_WEB_DIRCGI) Descripcin Direccin lgica, asignada por el Servidor Web del comercio al directorio de CGIs. Ejemplo Donde la URL del cgi tbk_bp_pago.cgi es : http://www.comercio.cl/cgi-bin/tbk_bp_pago.cgi , entonces la direccin lgica sera (PATH_WEB_DIRCGI) = /CGI-BIN $(PREFIJO) Descripcin Ejemplo
Es el nomenclatura que se utiliza para definir cul ser el nombre del parmetro a utilizar por la pgina que confirma la transaccin. Por ejemplo, si utilizamos como prefijo lo siguiente HTML_, el parmetro para confirmar una transaccin normal ser HTML_TR_NORMAL.
$(TRANSACCION) Descripcin Es el nombre de la solucin a ejecutar. Ejemplo Las alternativas de solucin o transaccin 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) Descripcin Cdigo asignado por Transbank al comercio Ejemplo Id = 597026008034 $(SERVIDOR_COMERCIO) Descripcin Nombre del Servidor Web del comercio Ejemplo www.comercio.cl
4 TRANSBANK S.A.
$(REFERER) Descripcin URL absoluta de la pgina de la tienda virtual desde donde se inicializa el proceso de pago con TRANSBANK. Ejemplo http://www.comercio.cl/pago.asp
TRANSBANK S.A.
1. INTRODUCCIN
WebPay es un servicio de pago con Tarjeta De Crdito desarrollado por Transbank para realizar transacciones va INTERNET. Hoy en da constituye una herramienta clave para el desarrollo de un comercio electrnico eficaz y seguro en Chile. Este servicio se sustenta a travs de un software de aplicacin que se separa en dos componentes independientes que interactan entre s. Una de ellas esta ubicada fsicamente 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 travs del cual se realiza la transaccin.
2. QUE ES EL KCC ?
La aplicacin 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 Conexin 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 instalacin y configuracin por parte del comercio afiliado al servicio WepPay de Transbank. As la finalidad de este manual es explicar en detalle como realizar la integracin 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 Integracin. Datos ambiente de pruebas. KCC Produccin: 2 cgi ambiente de produccin. Datos ambiente de produccin. Actualmente, ambos ambientes estn disponibles para Windows NT, Sun Solaris, Redhat Linux y AIX.
TRANSBANK S.A.
3. ETAPAS TCNICAS DE INCORPORACIN A WEBPAY

En el proceso de incorporacin de WebPay a una tienda virtual existen dos etapas: Desarrollo. Produccin. 3.1 DESARROLLO La etapa de desarrollo consiste de dos sub-etapas: Integracin. Certificacin. Integracin: El proceso de integracin 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 travs de un servidor de prueba habilitado para tal efecto (ver Anexo A). Certificacin: La etapa de certificacin 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 PRODUCCIN Una vez aprobada la etapa de desarrollo, el comercio pasa a la ultima fase denominada de produccin 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 lnea a travs de INTERNET, uno de los aspectos ms importantes de resaltar es que la informacin de la Tarjeta de Crdito del cliente slo 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 informacin que viaja por la Red, adems se ve reforzado por medio de la utilizacin de servidores seguros protegidos con SSL (Secure Socket Layer), cdigos de encriptacin y firmas digitales.
5. APRECIACIN
GLOBAL DEL PROCESO DE LA TRANSACCIN ELECTRNICA
La Transaccin Electrnica 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 crdito por medio del sistema de pago WepPay. En este instante un subprograma (CGI) del KCC denominado tbk_bp_pago inicia la comunicacin con Transbank en donde se realiza todo el proceso de validacin de la compra con la tarjeta
7 TRANSBANK S.A.
especificada, el resultado de este proceso es comunicado al comercio a travs de un segundo cgi denominado tbk_bp_resultado.
6. MODALIDADES DE USO SOPORTADAS POR WEBPAY

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 solucin tecnolgica a una amplia gama de modelos de operacin 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 travs 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 informacin del cliente y administran ellos la informacin de la tarjeta de crdito. Modalidad One Click: Permite la compra inmediata de clientes habituales de una tienda slo eligiendo el producto y/o servicio sin tener la necesidad de volver a ingresar los datos de la tarjeta de crdito nuevamente. Esta modalidad hace una transaccin ms rpida y segura slo apretando una vez el botn pagar. Modalidad Mall Virtual: Permite que un grupo de tiendas virtuales realicen ventas en conjunto generando slo un total de venta final. Modalidad Mall Virtual Completo: Permite que un grupo de tiendas virtuales realicen ventas en conjunto generando slo un total de venta final. La modalidad de pago de este tipo de transaccin esta definido por la Modalidad Completa. Modalidad Mall Virtual One Click: Permite que un grupo de tiendas virtuales realicen ventas en conjunto generando slo un total de venta final. La modalidad de pago de este tipo de transaccin esta definido por la Modalidad One Click.
TRANSBANK S.A.
6.1.1 MODO DE OPERACIN DE LA MODALIDAD NORMAL La Modalidad Normal comienza cuando el potencial cliente de una tienda virtual presiona el botn pagar, en ese instante la tienda se comunica con Transbank para solicitar autorizacin para transar la compra, en este punto la aplicacin ubicada en el Servidor de Pago toma el control de la transaccin comunicndose directamente con el cliente solicitando los datos de su tarjeta. Una vez realizado el envo de dicha informacin directamente a Transbank, se verifica la disponibilidad de cursar la transaccin. Luego se le enva una respuesta positiva o negativa a la tienda virtual, as esta puede cerrar la transaccin 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 grfica en la Figura 1.
Figura 1. Modalidad Normal de la Transaccin Electrnica con WebPay
6.2 TIPO DE MONEDA Adems de las modalidades de empleo de WebPay mencionadas anteriormente se permite elegir el tipo de moneda de la transaccin, es decir, peso o dlar. Esto debido a que se pueden realizar compras con tarjetas emitidas en el extranjero con cupo en dlares y validas internacionalmente. 6.3 MODALIDAD DE CAPTURA Se permiten dos modalidades de captura de la transaccin electrnica estas son: Captura Simultanea: Es la utilizada cuando la transaccin es validada en lnea por Transbank. El cargo del pago se hace simultneamente en la tarjeta de crdito del cliente.
TRANSBANK S.A.
Captura Diferida: Es utilizada cuando el comercio por diversas razones, ejemplo verificacin de stock, no puede realizar la transaccin 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 transaccin hasta que el comercio apruebe la compra y lo comunique a Transbank. Existe un tiempo mximo estipulado para realizar esto ltimo, de no ser as la retencin de la tarjeta de crdito del cliente ser reversada. Observacin: 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, transaccin y software de comercio utilizado. 6.4 FORMAS DE PAGO Actualmente existen cuatro formas de pago posibles. Estas se detallan a continuacin. Venta Normal: Corresponde al pago total del precio establecido por la tienda para un producto cuestin. Venta Cuotas: Corresponde al pago de un producto en una cantidad de cuotas establecida por el tarjetahabiente. Tres Cuotas Sin Inters: Corresponde al pago de un producto en tres cuotas precio contado. Cuotas Comercio: La modalidad de pago tiene como caracterstica principal que el comerciante ofrece al Tarjetahabiente el pago por sus productos, en cuotas iguales y conocidas por l. Esto implica que la informacin principal en cada transaccin la constituye el precio contado del producto, el valor y nmero de cuotas. Observacin: En la forma de pago Cuotas Comercio, la nica condicin que Transbank impone a los comercios, es que en el calculo del monto de la cuota no se transgreda el lmite correspondiente a la tasa de inters mxima legal. Para velar por que tal condicin se cumpla se realiza una validacin de esta tasa para todas aquellas transacciones que utilicen esta forma de pago. (Ver Anexo E)
10
TRANSBANK S.A.
7. ARQUITECTURA DEL KCC

7.1 DEFINICIONES GENERALES El KCC es una aplicacin que bsicamente esta compuesta por: Subprogramas Libreras Archivos de configuracin Archivos de seguridad Archivos de registro Pginas Web
7.1.1 SUBPROGRAMAS Subprograma Pago Resultado de la Transaccin Verificacin de Firma Digital Nombre del Archivo TBK_BP_PAGO TBK_BP_RESULTADO TBK_CHECKMAC
Tabla 1. Subprogramas utilizados en el KCC.
La extensin 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, derivndole a Transbank el control del browser del tarjetahabiente. Funciones que realiza: Firma el mensaje, agregando el MAC (cdigo de encriptacin). Traspasa los datos de la transaccin 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 pgina definida por la tienda.
11 TRANSBANK S.A.
Funciones que realiza: Valida el MAC. Recibe resultado de la transaccin. Confirma con el comercio el cierre de las compras pasando todos los parmetros recibidos. Enva la confirmacin o rechazo del cierre de la compra con el comercio (aceptacin o rechazo por parte del comercio). TBK_CHECK_MAC Encargado de validar el MAC de encriptacin utilizado en las respuestas que entrega Transbank al comercio. Es una herramienta que se utiliza para asegurar que la respuesta provenga exactamente del KCC. Observacin: 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 INFORMACIN ENTRE SERVIDOR DE COMERCIO Y SERVIDOR DE PAGO A continuacin se explica el flujo de informacin para la Modalidad Normal entre el Servidor de Comercio y el Servidor de Pago. El tarjetahabiente realiza una compra a travs de una tarjeta de crdito en una tienda virtual a travs del servicio WebPay de Transbank. El software de la tienda ejecuta tbk_bp_pago entregndole los siguientes parmetros: Monto de la compra. Nmero 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 botn PAGAR
12
TRANSBANK S.A.
La transaccin es autorizada o rechazada por Transbank y su resultado es comunicado a travs de bp_transaccion (Servidor de Pago) a tbk_bp_resultado en el Servidor del Comercio. En caso de rechazo, tbk_bp_resultado registra la transaccin en su archivo log y confirma el resultado a Transbank. En caso de aprobacin, tbk_bp_resultado ejecuta una pgina (pagina de cierre) en la tienda virtual, comunicndole el nmero de la orden de compra y el cdigo de autorizacin asignado por Transbank. La tienda virtual busca en su base de datos el nmero de la orden de compra, verifica que no est ya pagada y procede a cerrar la transaccin registrando el cdigo de autorizacin de Transbank. Una vez realizado sto se devuelve un string de ACEPTADO que indica que la operacin fue realizada con xito. tbk_bp_resultado recibe ACEPTADO y confirma la transaccin hacia Transbank. Finalmente se redirecciona la pgina del tarjetahabiente a la pgina de xito o fracaso segn corresponda. Observacin: El string ACEPTADO debe ser devuelto en mayscula para que este sea reconocido por la aplicacin. El flujo de informacin se muestra grficamente en la Figura 2. 7.1.3 CONDICIONES DE EXCEPCIN Las condiciones de excepcin son ciertas instancias del proceso que hacen que la transaccin sea reversada cuando no se cumplen algunas condiciones bsicas, estas son: Timeout: El timeout se produce cuando el tiempo de espera, por parte de Transbank, de la comprobacin (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 confirmacin del cierre de la compra es distinto de ACEPTADO.
13
TRANSBANK S.A.
Figura 2a. Flujo de Informacin WebPay Modalidad Normal
14
TRANSBANK S.A.
Figura 2b. Flujo de Informacin WebPay Modalidad Normal
8. INTEGRACIN DEL KCC CON EL SOFTWARE DE LA TIENDA VIRTUAL

En la instalacin del KCC en el sitio del comercio hay aspectos que variarn entre un comercio y otro. Esto debido a que no todos los comercios tienen los mismos softwares instalados (Servidor Web y Software de Comercio Electrnico principalmente), as hay algunas decisiones en la instalacin que se dejan a criterio del comercio. Los pasos necesarios para la integracin del KCC genrico con un software de comercio electrnico son los siguientes:
Instalacin del KCC. Creacin de estructura de directorios Definicin de permisos. Copia de archivos Configuracin del KCC. Archivo de configuracin tbk_config.dat. Archivo de configuracin tbk_trace.dat. Creacin de pginas de comercio. Pginas de llamada al KCC. Pginas para confirmar las transacciones.
8.1 INSTALACIN DEL KCC 8.1.1 CREACIN DE
ESTRUCTURA DE DIRECTORIOS
DIRECTORIO BASE
La aplicacin se debe alojar en un directorio base para facilitar su ubicacin y posterior configuracin, as se debe crear un directorio base denominado, por ejemplo, KCC.
DIRECTORIO CGI-BIN
El segundo paso para la instalacin 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 vaco con el nombre $(PATH_DISCO_DIRCGI). Configurar el servidor WEB para agregar un directorio de cgis en la ubicacin $(PATH_DISCO_DIRCGI) cuya ubicacin lgica sea (PATH_WEB_DIRCGI). Asignar permisos de ejecucin para el usuario Web.
16
TRANSBANK S.A.
SUB-DIRECTORIOS
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
Observacin:Para la definicin de los parmetros ver Nomenclatura. 8.1.2 DEFINICIN DE PERMISOS Sistema Operativo Se le deben otorgar los siguientes permisos a los directorios creados. Directorio cgi-bin datos log maestros template Lectura x x x x Escritura Ejecucin x
x x
Tabla 2. Asignacin de Permisos
Observacin: En el caso de UNIX se debe agregar permiso de ejecucin 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 / cgi-bin / cgi-bin / log / cgi bin / datos / cgi-bin / maestros Atributos Permitir ejecucin de cgi utilizando el mtodo POST. Ningn permiso Ningn permiso Ningn permiso
17
TRANSBANK S.A.
8.1.3 COPIA DE ARCHIVOS Dentro de la estructura de directorios definida anteriormente se deben copiar los siguientes archivos. Libdb30.dll Descripcin
Ubicacin Permiso Lybeay32.dll Descripcin
Librera propia del KCC, generada por efectos de compilacin, solo utilizado para versin Windows NT. Permite ejecucin del KCC en el comercio. $(PATH_DISCO_DIRCGI) Lectura y Escritura
Librera propia del KCC, generada por efectos de compilacin, solo utilizado para versin Windows NT. Permite ejecucin del KCC en el comercio. Posee Tcnicas de seguridad. Ubicacin $(PATH_DISCO_DIRCGI) Permiso Lectura y Escritura tbk_bp_pago.cgi Descripcin Programa CGI, mdulo ejecutable. Permite: Traspaso de datos de la transaccin y del comercio a Transbank. Firmar el mensaje, agregando el MAC. Redireccionar al Tarjetahabiente al Servidor de Pago en Transbank. Ubicacin $(PATH_DISCO_DIRCGI) Permiso Lectura y Ejecucin tbk_bp_resultado.cgi Descripcin Programa CGI, mdulo ejecutable. Permite: Recibir resultado de la transaccin. Validar el MAC. Confirmar con el comercio el cierre de la compra, a travs de la pagina de cierre (ver punto 8.3.2) Realizar la confirmacin, ya sea exitosa o no, del cierre de la compra, enlazndose 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 transaccin del comercio. Ubicacin $(PATH_DISCO_DIRCGI) Permiso Lectura y Ejecucin
18
TRANSBANK S.A.
tbk_chek_mac.exe Descripcin Programa que permite asegurar que la pgina de confirmacin del comercio es llamada desde el programa tbk_bp_resultado.cgi. Se utiliza para brindar una mayor seguridad a la transaccin. Ubicacin $(PATH_DISCO_DIRCGI) Permiso Lectura y Ejecucin tbk_config.dat Descripcin Archivo de configuracin 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. Ubicacin $(PATH_DISCO_DIRCGI)/datos Permiso Lectura. tbk_trace.dat Descripcin Archivo de configuracin del registro de eventos del KCC (Log) Puede ser editado con un editor de texto. Ubicacin $(PATH_DISCO_DIRCGI)/datos Permiso Lectura. Tbk_bitacora_tipo_de_transaccion_fecha.dat Descripcin Archivo que permite almacenar el resultado de las operaciones realizadas durante el mes de acuerdo al tipo de transaccin habilitado. Se genera por fecha contable. Donde: tipo_de_transaccin: Transaccin Normal: tr_normal. Transaccin Completa: tr_completa. Transaccin One Click: tr_oneclick. Transaccin Mall Virtual: tr_mall fecha: mm: dos dgitos de mes. dd: dos dgitos de da. Puede ser editado con un editor de texto. tbk_bitacora_tr_normal_0407.log $(PATH_DISCO_DIRCGI)/log Lectura y escritura.
Ejemplo Ubicacin Permiso
19
TRANSBANK S.A.
Tbk_env_fecha.dat Descripcin Archivo que permite almacenar el resultado de las operaciones.. Se genera por da fsico. Donde: Fecha:

aaaa: cuatro dgitos de ao. mm: dos dgitos de mes. dd: dos dgitos de da.
Ejemplo Ubicacin Permiso
Puede ser editado con un editor de texto. tbk_evn20000410.log $(PATH_DISCO_DIRCGI)/log Lectura y escritura.
tbk_comercio.db Descripcin Archivo maestro provisto por Transbank al comercio, contiene un cdigo de llave del comercio que permite autentificar el comercio y asegurar los mensajes que se envan y reciben hacia y desde Transbank. Ubicacin $(PATH_DISCO_DIRCGI)/maestros Permiso Lectura. Reintento.htm Descripcin Pagina que se despliega en caso de ocurrir un error de CGI. Ubicacin $(PATH_DISCO_DIRCGI)/templates Permiso Lectura. Observacin: Al momento de subir los archivos al servidor de comercio se debe setear en la aplicacin utilizada el modo de envi como sigue:
Tipo ASCII BINARIO Extensin *.log; *.dat; *.html; *.asp *.cgi; *.dll; *.db
8.2 CONFIGURACIN DEL KCC Los archivos de configuracin del KCC son:

tbk_config.dat tbk_trace.dat
y tienen la forma: $(NOMBRE_PARAMETRO) = $(VALOR_PARAMETRO) donde:

20 TRANSBANK S.A.
$(NOMBRE_PARAMETRO): Corresponde al nombre del parmetro a configurar. $(VALOR_PARAMETRO) : Valor asignado a dicho parmetro.
Observacin: Solamente puede ir un par: $(NOMBRE_PARAMETRO) = $(VALOR_PARAMETRO) por lnea 8.2.1 CONFIGURACIN DEL ARCHIVO TBK_CONFIG.DAT Este archivo configura el comportamiento general del KCC, tiene los siguientes parmetros. IDCOMERCIO $(CODIGO_COMERCIO) Valor Descripcin Cdigo numrico de 12 dgitos asignado por Transbank al comercio de acuerdo a la modalidad adoptada. IDCOMERCIO = 597026011655 Ejemplo
URLCGICOM
Valor Descripcin Ejemplo

SERVERCOM
$(PATH_DIRCGI_WEB)/tbk_bp_resultado.cgi Path web donde se encuentra el cgi tbk_bp_resultado.cgi. URLCGICOM = /cgi-bin/tbk_bp_resultado.cgi

PORTCOM
$(SERVIDOR_COMERCIO) Numero IP del servidor Web del comercio donde est el cgi tbk_bp_resultado.cgi. Largo mximo 12 dgitos. SERVERCOM = 198.22.250.29

HOST
$(PUERTO_COMERCIO) Puerto asignado al servidor Web del comercio donde est el CGI tbk_bp_resultado. PORT = 80
$(SERVIDOR_CONFIRMACION_COMERCIO) IP del servidor Web del comercio donde estn las pginas de confirmacin de las transacciones por parte del comercio. HOST = 198.22.250.29
21 TRANSBANK S.A.
WPORT

SERVERTRA
$(PUERTO_CONFIRMACIN_COMERCIO). Puerto asignado al servidor Web del comercio donde estn pginas de confirmacin de las transacciones por parte del comercio. WPORT = 80

PORTTRA
$(SERVIDOR_TRANSBANK) Nombre o IP del servidor de Transbank donde se ejecutan las transacciones de WebPay. Incluye el prefijo https. SERVERTRA = https://pruebas.webpay.cl

URLCGITRA
$(PUERTO_TRANSBANK) Puerto asignado al servidor Web de Transbank donde se ejecutan las transacciones WebPay. PORTTRA = 5443
/cgi-bin/bp_revision.cgi Path Web del cgi bp_revisin.cgi en Transbank. URLCGITRA = /cgi-bin/bp_revision.cgi
PREFIJO_CONF_TR
$(PREFIJO) Prefijo que contiene el nombre del parmetro que indica cual es la pgina que se ejecuta en el comercio para confirmar la transaccin. PREFIJO_CONF_TR=HTML_
$(PREF)$(TRANSACCIN)
$(PAGINA_CONFIRMACIN) Pgina que se ejecutar para confirmar la transaccin $(TRANSACCIN). HTML_TR_NORMAL=http://198.22.250.29/kcc_normal/xt_compra.asp
TBK_REFERER $(REFERER) Valor Descripcin URL absoluta que debe indicar la direccin de la pgina encargada de inicializar el proceso de pago, es decir, desde donde se ejcuta el cgi tbk_bp_pago. http://www.comercio.cl/pago.asp Ejemplo
22
TRANSBANK S.A.
8.2.2 CONFIGURACIN DEL ARCHIVO TBK_TRACE.DAT Configura el nivel de logs que reporta el KCC, este tiene los siguientes parmetros. GLEVEL Valor Descripcin
$(NIVEL_LOG) Nivel de logs que genera el KCC. Ej.: GLEVEL = 7
Los niveles posibles de log son: Nivel Valor Descripcin LOGINFO 1 El KCC genera logs informativos. LOGERROR 2 El KCC genera logs de errores. LOG_FATAL 4 El KCC genera logs Fatales Tambin existen las combinaciones de nivel de logs. De esta manera los valores posibles del parmetro GLEVEL son: Valor Nivel de Log 0 No hay logs. 1 LOGINFO 2 LOGERROR 3 LOGINFO+LOGERROR 4 LOGFATAL 5 LOGFATAL+LOGINFO 6 LOGFATAL+LOGERROR 7 LOGINFO+LOGERROR+LOGFATAL 8.2.3 HABILITACIN DE LAS FORMAS DE PAGO EN WEBPAY Las formas de pago que acepta cada tienda en particular son una definicin comercial. Estas son habilitadas automticamente 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 inters se habilitan en el formulario de pago estndar de Transbank y le permiten al tarjetahabiente seleccionar la opcin 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 opcin de pago. Ver Figura 4.
23
TRANSBANK S.A.
Figura 3. Formulario de Pago Estndar
Figura 4. Formulario de Pago para Cuotas Comercio
24
TRANSBANK S.A.
8.3 CREACIN DE PAGINAS DE COMERCIO El ltimo paso en la integracin del KCC con el software del comercio es la creacin de cuatro pginas dinmicas por parte de la tienda para conectarse con el KCC. 8.3.1 PGINA DE PAGO Por cada transaccin WebPay que el comercio quiera ejecutar deber crear una pgina dinmica de pago, que haga la llamada al cgi tbk_bp_pago.cgi con los parmetros adecuados de acuerdo a la transaccin y que se explicitan ms delante. As, esta es la pgina que tiene el botn pagar y llama al cgi tbk_bp_pago.cgi con los parmetros adecuados. Ejemplo: Default.asp Ubicacin Permiso
Directorio base Lectura
8.3.2 PGINA DE CIERRE PARA CONFIRMAR LAS TRANSACCIONES Esta pgina denominada pagina de cierre es ejecutada por el cgi tbk_bp_resultado y tiene la finalidad de confirmar la transaccin por parte del comercio. La pgina de cierre recibir por mtodo POST los parmetros que se indican en el punto 9, como salida. Con ellos, esta pgina deber ser capaz de realizar las operaciones necesarias (validacin y almacenaje de parmetros), desde el punto de vista del comercio, para confirmar la transaccin. Si el comercio aprueba la transaccin, la salida estndar de esta pgina debe devolver el string (html) ACEPTADO, en tal caso el cgi tbk_bp_resultado se encarga de realizar la confirmacin (ACK) a Transbank. Observacin: Para KCC V2.0, esta pagina, a excepcin de la Modalidad Mall, solo se ejecuta si la transaccin ha sido exitosa por parte de Transbank, es decir, luego que se ha verificado que la tarjeta de crdito no tiene ninguna restriccin para realizar la compra. Por otro lado si el comercio rechaza la transaccin, el string de salida deber ser RECHAZADO, en tal caso la transaccin es reversada. Ejemplo: Xt_compra.asp Ubicacin Directorio base Permiso Lectura y Escritura
25
TRANSBANK S.A.
Observacin: Dado que esta pgina debe ser capaz de recibir datos por mtodo POST y adems ejecutar acciones, esta en realidad no debe ser una pgina HTML pura, sino ms bien una pagina dinmica (cgi, php, asp, etc) capaz de generar una pgina HTML como salida. 8.3.3 PAGINA DE EXITO Se define como la pagina que indica al cliente del comercio que su transaccin fue realizada con xito, esta pagina debe ser programada por el comercio. Ejemplo: Exito.asp Ubicacin Permiso 8.3.4 PAGINA DE FRACASO Se define como la pagina que indica al cliente del comercio que su transaccin no pudo ser realizada, sta debe ser programada por el comercio. Ejemplo: Fracaso.asp Ubicacin Permiso
Directorio base Lectura y Escritura
Directorio base Lectura
Observacin: 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. 8.4 VALIDACIONES OBLIGATORIAS EN PAGINA DE CIERRE 8.4.1 VALIDACIN DE MONTO Para aumentar la seguridad de la tienda virtual, Transbank exige la realizacin de una validacin del monto de cada transaccin. Para tal efecto, se entrega a la pagina de cierre el parmetro 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 VALIDACIN DE MAC Debido a que la pgina de cierre es la que define finalmente la ejecucin de la transaccin, es importante asegurar que solo sea invocada desde el cgi tbk_bp_resultado instalado en el comercio. Para lo anterior es necesario realizar una validacin de la firma digital.
26
TRANSBANK S.A.
El cgi tbk_bp_resultado entrega a la pgina de cierre un parmetro con el nombre TBK_MAC que contiene la firma digital de los datos entregados. Para la validacin de dicha firma se entrega el programa tbk_check_mac el cul se encarga de verificar esta firma retornando 0 en el caso que sea vlida o un cdigo de error en caso contrario. En el caso de error, adems escribe en la salida estndar la razn del error. Para chequear los parmetros de respuesta utilizando el programa tbk_check_mac, la pgina de cierre debe generar un archivo de texto con los parmetros 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 parmetros se pueden obtener llamando al mtodo Form del objeto Request sin parmetros (data = Request.Form()). Observacin: Para generar el nombre del archivo se requiere usar un nombre distinto para cada transaccin ejecutada. Para lo anterior se recomienda utilizar el valor que viene en el parmetro TBK_ID_TRANSACCIN.
27
TRANSBANK S.A.
9. DESCRIPCIN DE LAS MODALIDADES

Para el buen funcionamiento del sistema de pago WebPay se deben definir para cada una de las modalidades de pago, parmetros de entrada y salida. Los parmetros de entrada son los que se deben generar en las paginas de llamada al KCC por parte del comercio, bsicamente a travs de algn formulario que enve dichos parmetros por cualquiera de los mtodos establecidos, ya sea POST al cgi tbk_bp_pago.cgi. Los parmetros de salida son aquellos que entrega Transbank a travs del CGI tbk_bk_resultado al comercio por medio de la pagina de cierre para finalizar la transaccin. Observacin: Las modalidades soportadas por las tiendas estn definidas implcitamente con cada cdigo de comercio.
28
TRANSBANK S.A.
9.1 MODALIDAD NORMAL La Modalidad Normal consiste en realizar una transaccin virtual llamando al cgi tbk_bp_pago con los parmetros de entrada definidos en la Tabla 3. Una vez ejecutado este cgi el control de la transaccin es tomado por Transbank quien le exige al tarjetahabiente que entregue una serie de datos de su tarjeta para terminar la transaccin, el resultado de sta es comunicado al comercio por medio del cgi tbk_bp_resultado que entrega los parmetros a la pagina de cierre, estos parmetros de salida son mostrados en la Tabla 4. Una vez confirmada la transaccin 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 crdito.
Parmetro TBK_TIPO_TRANSACCION Descripcin Largo Tipo Tipo de transaccin (TR_NORMAL) 50 A Monto de la transaccin. Sin separadores de miles ni de decimales. Se asume los dos TBK_MONTO 10 N ltimos dgitos como valores decimales. TBK_ORDEN_COMPRA Orden de compra. 26 A TBK_ID_SESION Identificador de sesin. (opcional) 61 A Pgina a llamar en caso de xito en la transaccin. Debe ser una direccin 256 A TBK_URL_XITO absoluta, para lograr el redireccionamiento del browser del cliente. Pgina a llamar en caso de fracaso en la transaccin. Debe ser una direccin 256 A TBK_URL_FRACASO absoluta, para lograr el redireccionamiento del browser del cliente. Solo se enva para caso de pago CI. 9 N TBK_MONTO_CUOTA Monto correspondiente de cada cuota. Solo se enva para caso de pago CI. 2 N TBK_NUMERO_CUOTAS Nmero de cuotas a pagar. Tabla 3. Parmetros de entrada Modalidad Normal.
29
TRANSBANK S.A.
Parmetro
Descripcin Tipo de transaccin (TR_NORMAL en TBK_TIPO_TRANSACCION este caso) Respuesta a la solicitud de la TBK_RESPUESTA transaccin. TBK_ORDEN_COMPRA Orden de compra. Identificador de sesin. (si fue TBK_ID_SESION habilitado) Cdigo de autorizacin de la TBK_CODIGO_AUTORIZACION transaccin de compra. Monto de la transaccin. Sin separadores de miles ni de decimales. TBK_MONTO Se asume los dos ltimos dgitos como valores decimales. Cuatro ltimos nmeros de la Tarjeta de Crdito con que se realiz la TBK_NUMERO_FINAL_TARJETA compra. (Slo para los comercios que Transbank habilite esta opcin). Numero de Tarjeta de Crdito con que se realiz la compra. (Slo para los TBK_NUMERO_TARJETA comercios que Transbank habilite esta opcin). Fecha de expiracin de Tarjeta de Crdito con que se realiz la compra. TBK_FECHA_EXPIRACION (Slo para los comercios que Transbank habilite esta opcin). Fecha contable de la transaccin. TBK_FECHA_CONTABLE (mmdd) Fecha en que se realiz la transaccin. TBK_FECHA_TRANSACCIN (aaaammdd) Hora en la que se realiz la TBK_HORA_TRANSACCIN transaccin. (hhmmss) TBK_ID_TRANSACCIN Identificador de transaccin Forma de Pago escogida por el TBK_TIPO_PAGO tarjetahabiente. En el caso de corresponder a un tipo de pago CI, tiene el mismo valor que el parmetro de entrada. Para los otros TBK_NUMERO_CUOTAS tipos de pago (VC y SI) contiene el numero de Cuotas escogida por el tarjetahabiente. TBK_MAC Firma digital Solo se enva para caso de pago CI. TBK_MONTO_CUOTA Monto correspondiente de cada cuota. Solo se enva para caso de pago CI. TBK_TASA_INTERES_MAX Tasa de inters mxima permitida del periodo. Tabla 4. Parmetros de salida Modalidad Normal. 30
Largo 50 2 26 61 6
Tipo A N A A N
10
19
4 8 6 20 2
N N N N A
32 9 4
A N N
TRANSBANK S.A.
9.2 MODALIDAD COMPLETA La modalidad completa permite una transaccin slo con los datos enviados por el comercio, en este caso se envan por intermedio del cgi tbk_bp_pago los parmetros bsicos de la modalidad normal junto con los datos del tarjetahabiente:

Numero de Tarjeta Fecha de Expiracin CVV
La totalidad de los parmetros de entrada se muestran en la Tabla 5. Por otro lado los parmetros de salida para la transaccin completa son exactamente los mismos que para una transaccin normal.
Parmetro TBK_TIPO_TRANSACCION Descripcin Largo Tipo de transaccin (TR_COMPLETA) 50 Monto de la transaccin. Sin separadores TBK_MONTO de miles ni de decimales. Se asume los dos 10 ltimos dgitos como valores decimales. TBK_ORDEN_COMPRA Orden de compra. 26 TBK_ID_SESION Identificador de sesin. (opcional) 61 Pgina a llamar en caso de xito en la 256 TBK_URL_EXITO transaccin Pgina a llamar en caso de fracaso en la 256 TBK_URL_FRACASO transaccin. Numero de Tarjeta de Crdito con que se 19 TBK_NUMERO_TARJETA realizar la compra. Fecha de expiracin de Tarjeta de Crdito 6 TBK_FECHA_EXPIRACION con que se realizar la compra. TBK_CVV Cdigo de Verificacin de la Tarjeta 4 TBK_TIPO_PAGO Forma de Pago (VN, VC, SI, CI). 2 TBK_NUMERO_CUOTAS Numero de Cuotas. 2 Solo se enva para caso de pago CI. 9 TBK_MONTO_CUOTA Monto correspondiente de cada cuota. Tabla 5. Parmetros de entrada Modalidad Completa. Tipo A N A A A A N N N A N N
31
TRANSBANK S.A.
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. Modificacin a One Click: Permite realizar una modificacin del perfil del usuario ingresado. Eliminacin a One Click: Permite eliminar usuarios de este tipo de modalidad.
9.3.1 PAGO ONE CLICK La Operacin Pago One Click permite realizar compras en una misma tienda virtual sin necesidad de ingresar los datos de la tarjeta de crdito 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.
Figura 5. Diagrama de Flujo de la Modalidad Pago One Click.
Los parmetros de entrada al cgi tbk_bp_pago se definen en la Tabla 6.

32 TRANSBANK S.A.
Parmetro TBK_TIPO_TRANSACCION
Descripcin Largo Tipo Tipo de transaccin (TR_ONECLICK) 50 A Monto de la transaccin. Sin separadores TBK_MONTO de miles ni de decimales. Se asume los dos 10 N ltimos dgitos como valores decimales. TBK_ORDEN_COMPRA Orden de compra. 26 A TBK_ID_SESION Identificador de sesin. (opcional) 61 A Pgina a llamar en caso de xito en la TBK_URL_EXITO 256 A transaccin Pgina a llamar en caso de fracaso en la TBK_URL_FRACASO 256 A transaccin. TBK_ID_USUARIO Usuario One Click 10 A TBK_TIPO_PAGO Forma de Pago (VN, VC, SI, CI). 2 A TBK_NUMERO_CUOTAS Numero de Cuotas. 2 N Solo se enva para caso de pago CI. TBK_MONTO_CUOTA 9 N Monto correspondiente de cada cuota. Tabla 6. Parmetros de entrada Modalidad Pago One Click.
Los parmetros de salida para la Operacin Pago One Click son exactamente los mismos que para la Modalidad Normal. 9.3.2 INGRESO A ONE CLICK La Operacin Ingreso One Click permite la inclusin 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 parmetros de entrada al cgi tbk_bp_pago se definen en la Tabla 7.
Parmetro Descripcin Largo Tipo Tipo de transaccin 50 A TBK_TIPO_TRANSACCION (TR_INGRESO_ONECLICK) Identificador de usuario a inscribir en one 10 A TBK_ID_USUARIO click. Pgina a llamar en caso de xito en la TBK_URL_EXITO 256 A transaccin Pgina a llamar en caso de fracaso en la TBK_URL_FRACASO 256 A transaccin. Tabla 7. Parmetros de entrada Modalidad Ingreso One Click.
Los parmetros de salida de la Operacin Ingreso One Click se muestran la Tabla 8.
33
TRANSBANK S.A.
Parmetro
Descripcin Largo Tipo Tipo de transaccin TBK_TIPO_TRANSACCION 50 A (TR_INGRESO_ONECLICK) Respuesta a la solicitud de la transaccin TBK_RESPUESTA en el Base24. Si es cero significa que se 2 N ejecut normalmente. Identificador de usuario a inscrito en one TBK_ID_USUARIO 10 A click. TBK_FECHA_TRANSACCIN Fecha en que se realiz la transaccin. 8 N TBK_HORA_TRANSACCIN Hora en la que se realiz la transaccin 6 N TBK_ID_TRANSACCIN Identificador de transaccin 20 N TBK_MAC Firma digital 32 A Tabla 8. Parmetros de salida de una Modalidad Ingreso One Click.
Figura 6. Diagrama de Flujo de la Modalidad Ingreso One Click.
9.3.3 MODIFICACIN ONE CLICK Este proceso permite la modificacin del perfil de algn 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.
34
TRANSBANK S.A.
Figura 7. Diagrama de Flujo de la Modalidad Modificacin One Click.

Parmetro Descripcin Largo Tipo Tipo de transaccin 50 A TBK_TIPO_TRANSACCION (TR_MODIFICACION_ONECLICK) Identificador de usuario a modificar en one TBK_ID_USUARIO 10 A click. Pgina a llamar en caso de xito en la TBK_URL_EXITO 256 A transaccin Pgina a llamar en caso de fracaso en la TBK_URL_FRACASO 256 A transaccin. Tabla 9. Parmetros de entrada Modalidad Modificacin One Click.
Los parmetros de salida de la Operacin Modificacin One Click se muestran la Tabla 10.
35
TRANSBANK S.A.
Parmetro
Descripcin Largo Tipo Tipo de transaccin TBK_TIPO_TRANSACCION 50 A (TR_MODIFICACION_ONECLICK) Respuesta a la solicitud de la transaccin TBK_RESPUESTA en el Base24. Si es cero significa que se 2 N ejecut normalmente. Identificador de usuario a modificado en TBK_ID_USUARIO 10 A one click. TBK_FECHA_TRANSACCIN Fecha en que se realiz la transaccin. 8 N TBK_HORA_TRANSACCIN Hora en la que se realiz la transaccin 6 N TBK_ID_TRANSACCIN Identificador de transaccin 20 N TBK_MAC Firma digital 32 A Tabla 10. Parmetros de salida Modalidad Modificacin One Click.
9.3.4 ELIMINACIN ONE CLICK Este proceso permite la eliminacin del perfil de algn 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 Eliminacin One Click.
36
TRANSBANK S.A.

Parmetro Descripcin Largo Tipo Tipo de transaccin A TBK_TIPO_TRANSACCION 50 (TR_ELIMINACION_ONECLICK) Identificador de usuario a eliminar en one A TBK_ID_USUARIO 10 click. Pgina a llamar en caso de xito en la A TBK_URL_EXITO 256 transaccin Pgina a llamar en caso de fracaso en la A TBK_URL_FRACASO 256 transaccin. Tabla 11. Parmetros de entrada Modalidad Eliminacin One Click.
Los parmetros de salida de la Operacin Modificacin One Click se muestran la Tabla 12.
Parmetro Descripcin Largo Tipo Tipo de transaccin 50 A TBK_TIPO_TRANSACCION (TR_ELIMINACION_ONECLICK) Respuesta a la solicitud de la transaccin TBK_RESPUESTA en el Base24. Si es cero significa que se 2 N ejecut normalmente. Identificador de usuario a eliminado en 10 A TBK_ID_USUARIO one click. TBK_FECHA_TRANSACCIN Fecha en que se realiz la transaccin. 8 N TBK_HORA_TRANSACCIN Hora en la que se realiz la transaccin 6 N TBK_ID_TRANSACCIN Identificador de transaccin 20 N TBK_MAC Firma digital 32 A Tabla 12. Parmetros de salida de la Modalidad Eliminacin One Click.
37
TRANSBANK S.A.
9.4 MODALIDAD MALL VIRTUAL La Modalidad Mall Virtual permite agrupar a varias tiendas virtuales a un Mall Virtual, el cual posee un cdigo de comercio propio y nico que corresponde al parmetro ID_COMERCIO que se configura en el archivo tbk_config.dat. Por otro lado cada tienda virtual asociada al Mall tambin posee un cdigo de comercio (cdigo de tienda) que la identifica como nica, este cdigo se enva como parmetro al momento de realizar la compra. Esta modalidad acta bsicamente igual que la Modalidad Normal con la salvedad que al momento de la confirmacin por parte de Transbank, la derivacin 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 confirmacin por parte de la tienda (Mall) a Transbank en cuanto a la realizacin del cierre de la compra el browser del cliente ser derivado a la pagina de fracaso definida por el comercio. Los parmetros de entrada al cgi tbk_bp_pago se definen en la Tabla 13.
Parmetro TBK_TIPO_TRANSACCION TBK_MONTO TBK_ORDEN_COMPRA TBK_ID_SESION TBK_URL_RESULTADO TBK_URL_FRACASO TBK_NUM_TRX TBK_CODIGO_TIENDA_MXXX TBK_ORDEN_TIENDA_MXXX TBK_MONTO_TIENDA_MXXX Descripcin Largo Tipo Tipo de transaccin (TR_MALL) 50 A Monto total de la transaccin mall. 10 N A Orden de compra de la transaccin 26 mall. Identificador de sesin. (opcional) 61 A A Pgina a llamar con los resultados 256 de las transacciones. A Pgina a llamar en caso de fracaso 256 en la transaccin de mall. N Nmero de transacciones de 4 compra. N Cdigo de Comercio de la tienda 12 nmero XXX en la transaccin mall. A Orden de compra de la tienda XXX 26 en la transaccin mall. N Monto de compra de la tienda XXX 10 en la transaccin mall. Solo se enva para caso de pago N CI. 9 Monto correspondiente de cada cuota para tienda XXX. Solo se enva para caso de pago N CI. 2 Nmero de cuotas a pagar para tienda XXX.
TBK_MONTO_CUOTA_MXXX
TBK_NUMERO_CUOTAS_MXXX
Tabla 13. Parmetros de entrada de la Modalidad Mall Virtual.
Los parmetros de salida de la Modalidad Mall Virtual se muestran la Tabla 14.

38 TRANSBANK S.A.
Parmetro TBK_TIPO_TRANSACCION TBK_RESPUESTA TBK_ORDEN_COMPRA
Descripcin Largo Tipo Tipo de transaccin (TR_MALL) 50 A Siempre viene en 0. 2 N Orden de compra mall. 26 A Identificador de sesin. (si fue TBK_ID_SESION 61 A habilitado) TBK_MONTO Monto de la transaccin mall 10 N Cuatro ltimos nmeros de la Tarjeta de Crdito con que se TBK_NUMERO_FINAL_TARJETA realiz la compra. (Slo para los 4 N comercios que Transbank habilite esta opcin). Numero de Tarjeta de Crdito con que se realiz la compra. (Slo para TBK_NUMERO_TARJETA 19 N los comercios que Transbank habilite esta opcin). Fecha de expiracin de Tarjeta de Crdito con que se realiz la TBK_FECHA_EXPIRACION 6 N compra. (Slo para los comercios que Transbank habilite esta opcin). TBK_FECHA_CONTABLE Fecha contable de la transaccin 4 N Fecha en que se realiz la 8 N TBK_FECHA_TRANSACCIN transaccin. Hora en la que se realiz la 6 N TBK_HORA_TRANSACCIN transaccin TBK_ID_TRANSACCIN Identificador de transaccin 20 N Cdigo de Autorizacin nmero 6 N TBK_COD_AUT_MXXX XXX. TBK_TIPO_PAGO_MXXX Forma de pago nmero XXX. 2 A Nmero de cuotas de la compra en 2 N TBK_NUMERO_CUOTAS_MXXX tienda nmero XXX. Solo se enva para caso de pago CI. 9 N TBK_MONTO_CUOTA_MXXX Monto correspondiente de cada cuota para tienda XXX. Respuesta a la transaccin nmero TBK_COD_RESP_MXXX 2 N XXX. TBK_MONTO_TIENDA_MXXX Monto en la tienda nmero XXX. 26 A Orden de compra para la tienda TBK_ORDEN_TIENDA_MXXX 10 N XXX. TBK_MAC MAC 32 N Tasa de inters mxima permitida TBK_TASA_INTERES_MAX 4 N para el periodo vigente. Tabla 14. Parmetros de salida Modalidad Mall Virtual.
Observacin: XXX vara de 001 a 006.

39 TRANSBANK S.A.
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 parmetros entregados al cgi tbk_bp_pago son los de una Modalidad Mall ms los de una Modalidad Completa. La totalidad de los parmetros de entrada al cgi tbk_bp_pago se muestran en la Tabla 14. Por otro lado los parmetros de salida son exactamente los mismos que para la Modalidad Mall.
Parmetro Descripcin Largo Tipo Tipo de transaccin TBK_TIPO_TRANSACCION 50 A (TR_MALL_COMPLETA) TBK_MONTO Monto total de la transaccin mall. 10 N Orden de compra de la transaccin TBK_ORDEN_COMPRA 26 A mall. TBK_ID_SESION Identificador de sesin. 61 A Pgina a llamar con los resultados de 256 A TBK_URL_RESULTADO las transacciones. Pgina a llamar en caso de fracaso 256 A TBK_URL_FRACASO en la transaccin de mall. TBK_NUM_TRX Nmero de transacciones de compra. 4 N Cdigo de Comercio de la tienda 12 N TBK_CODIGO_TIENDA_MXXX nmero XX en la transaccin mall. Orden de compra nmero XX en la 26 A TBK_ORDEN_TIENDA_MXXX transaccin mall. Monto de compra nmero XX en la 10 N TBK_MONTO_TIENDA_MXXX transaccin mall. TBK_TIPO_PAGO_MXXX Forma de Pago (VN, VC, SI, CI). 2 A Indica el nmero de cuotas de la 2 N TBK_NUMERO_CUOTAS_MXXX compra Solo se enva para caso de pago CI. TBK_MONTO_CUOTA_MXXX Monto correspondiente de cada 9 N cuota para tienda XXX. TBK_NUMERO_TARJETA Nmero Tarjeta De Crdito 19 N Fecha de expiracin de Tarjeta de TBK_FECHA_EXPIRACION Crdito con que se realizar la 6 N compra. TBK_CVV Cdigo de verificacin CVV 4 N Tabla 14. Parmetros de entrada de una Transaccin Mall Virtual Completo.
40
TRANSBANK S.A.
9.5 MODALIDAD MALL VIRTUAL ONE CLICK La Modalidad Mall Virtual One Click opera de la misma forma que la Modalidad Mall con la diferencia que los parmetros entregados al cgi tbk_bp_pago son los de una Modalidad Mall ms los de una Modalidad One Click. La totalidad de los parmetros de entrada al cgi tbk_bp_pago se muestran en la Tabla 15. Por otro lado los parmetros de salida son exactamente los mismos que para la Modalidad Mall.
Parmetro Descripcin Largo Tipo Tipo de transaccin TBK_TIPO_TRANSACCION 50 A (TR_MALL_ONECLICK) TBK_MONTO Monto total de la transaccin mall. 10 N Orden de compra de la transaccin TBK_ORDEN_COMPRA 26 A mall. TBK_ID_SESION Identificador de sesin. (opcional) 61 A Pgina a llamar con los resultados 256 A TBK_URL_RESULTADO de las transacciones. Pgina a llamar en caso de fracaso 256 A TBK_URL_FRACASO en la transaccin de mall. Nmero de transacciones de 4 N TBK_NUM_TRX compra. Cdigo de Comercio de la tienda 12 N TBK_CODIGO_TIENDA_MXXX XXX asociada mall. Orden de compra de la tienda XXX 26 A TBK_ORDEN_TIENDA_MXXX asociada al mall. Monto de la compra en la tienda 10 N TBK_MONTO_TIENDA_MXXX XXX asociada al mall. Forma de Pago de la tienda XXX 2 A TBK_TIPO_PAGO_MXXX asociada al mall. . Nmero de cuotas a pagar para 2 N TBK_NUMERO_CUOTAS_MXXX tienda XXX. Solo se enva para caso de pago CI. TBK_MONTO_CUOTA_MXXX 2 N Monto correspondiente de cada cuota para tienda XXX. TBK_ID_USUARIO Usuario One Click 10 A Tabla 15. Parmetros de entrada de la Modalidad Mall Virtual One Click.
Observacin: 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, modificacin y eliminacin de la base de datos one click es la definida en el punto 9.3 .
41
TRANSBANK S.A.
9.6 MODALIDAD CONSULTA DE TASA La totalidad de los parmetros de entrada al cgi tbk_bp_pago se muestran en la Tabla 16.
Parmetro Descripcin Largo Tipo Tipo de transaccin TBK_TIPO_TRANSACCION 50 A (TR_TASA_INTERES_MAX) Pgina a llamar en caso de xito en TBK_URL_EXITO 256 A la transaccin Pgina a llamar en caso de fracaso TBK_URL_FRACASO 256 A en la transaccin. Tabla 16. Parmetros de entrada de la Modalidad Consulta de Tasa.
Los parmetros de salida de la Modalidad Consulta De Tasa se muestran la Tabla 17.

Parmetro Descripcin Largo Tipo Tipo de transaccin 50 A TBK_TIPO_TRANSACCION (TR_TASA_INTERES_MAX) Respuesta a la solicitud de la 2 N TBK_RESPUESTA transaccin. Fecha en que se realiz la 8 N TBK_FECHA_TRANSACCIN transaccin. Hora en la que se realiz la 6 N TBK_HORA_TRANSACCIN transaccin TBK_ID_TRANSACCIN Identificador de transaccin. 20 N Tasa de inters mxima permitida 4 N TBK_TASA_INTERES_MAX del periodo. TBK_MAC Firma digital 32 N Tabla 17. Parmetros de entrada de la Modalidad Consulta de Tasa.
42
TRANSBANK S.A.
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 segn lo configurado en el archivo tbk_trace.dat. Se genera un archivo distinto por cada da 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 continuacin:
Variable ID_PROCESO ID_OPERACION PARAMETROS FECHA HORA IP RESULTADO ID_COMERCIO DESCRIPCIN Descripcin Nmero nico por transaccin Proceso que se est registrando Datos relevantes, Ejemplo: Id_comercio, id_venta Formato ddmmaaaa Formato hhmmss IP mquina en que se est procesando Resultado operacin, donde : OK = evento correcto KO = evento incorrecto Id_comercio que origina requerimiento Descripcin evento o error Tabla 18. Formato log de eventos. Largo Tipo 10 10 40 14 6 15 3 20 50 N A A N N A A N A
Observacin: Todas las variables estn ordenadas en una sola lnea, as se genera una lnea por transaccin.
43
TRANSBANK S.A.
10.2 ARCHIVO DE LOG DE TRANSACCIONES Este archivo contiene una lnea con cada transaccin ejecutada y almacena la data que entrega el cgi tbk_bp_resultado.cgi a la pgina de confirmacin de la transaccin. El nombre de este archivo es TBK_$(TIPO_TRANSACCIN)_$(FECHA).log. Donde:

$(TIPO_TRANSACCIN) = TR_NORMAL, TR_MALL, etc. $(FECHA) = mmdd o aaaammdd.
El formato de este archivo es el que se muestra a continuacin en la Tabla 19:
44
TRANSBANK S.A.
Variable TBK_ORDEN_COMPRA TBK_TIPO_TRANSACCION TBK_RESPUESTA TBK_MONTO
Descripcin Largo Tipo Nmero de la orden de compra generada por el comercio (nmero 26 A nico por transaccin). Indica el tipo de Modalidad utilizada. Respuesta entregada por Transbank Monto de la transaccin entregado por el comercio. Cdigo de autorizacin entregado por Transbank. Solo tienen cdigo las transacciones aprobadas R=0 . Campos correspondientes a datos de la tarjeta que no son entregados al comercio Internet sin envo de tarjeta 00000 . Fecha (mm/dd). Fecha (mm/dd) de la transaccin. Hora (hh/mm/ss) de la transaccin. Identificador de la sesin. Identificador de la transaccin. Tipo de pago utilizado. Numero de cuotas 50 2 10 A N N
TBK_CODIGO_AUTORIZACION
TBK_FINAL_NUMERO_TARJETA TBK_FECHA_CONTABLE TBK_FECHA_TRANSACCION TBK_HORA_TRANSACCION TBK_ID_SESION TBK_ID_TRANSACCION TBK_TIPO_PAGO TBK_NUMERO_CUOTAS TBK_TASA_INTERES_MAX
17 4 4 6 61 20 2 1 4 9
N N N N A N A N N N
Solo CI. Tasa de inters mxima permitida del periodo. Solo CI. Monto correspondiente de TBK_MONTO_CUOTA cada cuota. Tabla 19. Formato log de transacciones
Observacin: Todas las variables estn ordenadas en una sola lnea, as se genera una lnea por transaccin.
45
TRANSBANK S.A.
10.3 CDIGOS DE RESPUESTA Los cdigos de respuesta que entrega TRANSBANK a la tienda virtual se definen el la Tabla 20.
TBK_RESPUESTA 0 -1 -2 -3 -4 -5 -6 -7 Definicin Transaccin aprobada. Rechazo de tx. En B24 Transaccin debe reintentarse Error en tx. Rechazo de tx. En B24 Recazo por error de tasa Excede cupo mximo mensual Excede lmite diario por transaccin -8 Rubro no autorizado Tabla 20. Definicin de Cdigos de Respuesta.
46
TRANSBANK S.A.
11. EJEMPLO DE INTEGRACIN DE KCC CON EL SOFTWARE DE COMERCIO

Para la mejor comprensin de la integracin del KCC con un software de comer io c electrnico, se muestra a continuacin un ejemplo. 11.1 SUPOSICIONES: Tipo De Transaccin Direccin Fsica Direccin Web Cdigo de Comercio IP Servidor de Comercio Puerto de acceso al Servidor de Comercio URL Servidor de Pago Puerto de acceso al Servidor de Pago Plataforma Servidor Web NORMAL SUPERCOMERCE www.supercomerce.cl 597026018034 198.22.250.29 80 pruebas.webpay.cl 5443 Windows NT ISS
Tabla 20. Suposiciones ejemplo de integracin KCC.
Hechas estas suposiciones los pasos para integrar el KCC con el comercio son los siguientes. 11.2 CREACIN 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 ejecucin (incluyend scripts). o
11.3 CREACIN DE ESTRUCTURA DE DIRECTORIOS, COPIA DE ARCHIVOS Y

DEFINICIN DE PERMISOS

Dentro del directorio C:\SUPERCOMERCE\cgi-bin crear los directorios: datos, maestros y template. Luego habilitar desde el IIS permisode 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 (vacos por ahora) dentro del directorio datos. Luego habilitar desde el IIS permisos de lectura.
47
TRANSBANK S.A.
11.4 CONFIGURACIN DE KCC 11.4.1 ARCHIVO DE CONFIGURACIN TBK_CONFIG.DAT Editar el archivo tbk_config.dat y agregar el siguiente contenido:
IDCOMERCIO = 597026018034 URLCGICOM = /cgi-bin/tbk_bp_resultado.cgi SERVERCOM = 198.22.250.29 PORTCOM = 80 HOST = 198.22.250.29 WPORT = 80 URLCGITRA = /cgi-bin/bp_revision.cgi SERVERTRA = https://pruebas.webpay.cl PORTTRA = 5443 PREF_CONF_TR = HTML_ HTML_TR_NORMAL = /SUPERCOMERCE/xt_compra.asp http_REFERER = http://www.supercomerce.cl/pagar.asp
11.4.2 ARCHIVO DE CONFIGURACIN TBK_TRACE.DAT Agregar la siguiente lnea al archivo:

GLEVEL = 7
11.5 PGINAS DE LLAMADA AL KCC La llamada al KCC se hace a travs del cgi tbk_bp_pago.cgi el que a su vez debe ser llamado desde la pgina de pago del comercio. Este archivo tiene como objetivo recoger la informacin de la compra que se pretende realizar. As de acuerdo a los parmetros de entrada de una transaccin normal, este formulario de pago tiene la siguiente form a:
<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 Crdito" SIZE=20> </FORM>
48
TRANSBANK S.A.
11.6 PAGINA XITO Y FRACASO El parmetro TBK_URL_FRACASO corresponde a la URL que contiene a la pgina que se llamar en el caso que la transaccin fracase. No hay ningn requerimiento sobre esta pgina, basta con que contenga un mensaje apropiado que de a entender al usuario que la transaccin no se realiz. El parmetro TBK_URL_EXITO corresponde a la URL que contiene a la pgina que se llamar en caso que la transaccin se haya ejecutado correctamente. 11.7 PAGINA DE CIERRE Esta pagina debe ser capaz de extraer el cdigo de autorizacin que entrega Transbank y posteriormente confirmar la transaccin por parte del comercio, de ser exitosa la operacin anterior debe devolver por la misma va unstring ACEPTADO. Como forma de prueba se puede generar el siguiente cdigo ASP que siempre acepta la transaccin y guarda el cdigo de autorizacin en un archivo temporal.
<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>
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 parmetro HTML_TR_NORMAL. 11.7.1 VALIDACIN DE MAC La validacin del MAC se realiza a travs del programa tbk_check_mac, al cual se debe ejecutar entregndole un archivo que contenga todos los parmetros recibidos. La salida estndar del programa entregara un 0 si el MAC es correcto. A continuacin de muestra un ejemplo de una pagina de cierre utilizando tal validacin.
49
TRANSBANK S.A.
Ejemplo en ASP:
<html> <% '*** Ejemplo de Pagina de Cierre usando validador de MAC *** '*** DCE - Transabnk S.A. - Mayo 2001 *** ' Funcin de validacin 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 = iReturn end function %> <% ' Captura del Codigo de Autorizacin ' (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 %> <% ' Validacin del MAC resultado = check_mac() if (resultado = 0) then ' (aqu, adems, se debe incluir la lgica de validacin de ' la transaccin y el registro del cdigo de autorizacin ' en la base de datos de la tienda virtual) %> ACEPTADO <% else RECHAZADO %> <% end if %> </html> 50 TRANSBANK S.A.
Ejemplo en PHP:
<?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 parmetro 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 vlido/ if ($result[0]=="CORRECTO") { /* Aqu la lgica de validacin de la transaccin y el registro de cdigo de autorizacin 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"; ?>
51
TRANSBANK S.A.
ANEXO A
DATOS AMBIENTE DE DESARROLLO WEBPAY DATOS DE L SERVIDOR DE PRUEBA
URL Servidor de Pago Puerto Servidor de Pago https://pruebas.webpay.cl 5443
DATOS CODIGO DE COMERCIO

Modalidad Normal Modalidad Completa Modalidad One Click Modalidad Mall Tienda Mall 1 Tienda Mall 2 Modalidad Mall Completo Tienda Mall 1 Tienda Mall 2 Modalidad Mall Completo Tienda Mall 1 597026008034 597026008905 597026008913 597026010039 597026010047 597026010055 597026014964 597026014980 597026015006 597026016797 597026016940
Observacin: Cada cdigo de comercio tiene asociado una llave, la cual es suministrada por Transbank S.A.
DATOS TARJETA DE CRDITO

Marca N de Tarjeta Ao Expiracin Mes Expiracin Resultado VISA 4508000021111116 2005 12 APROBADO MASTERCARD 5390212511111112 2001 01 RECHAZADO
HORARIO 24 hrs, 7 das a la semana.
52
TRANSBANK S.A.
ANEXO B
PREGUNTAS FRECUENTES Pregunta Qu es Kit de Conexin de Comercio y como se realiza la instalacin de los CGI ? Respuesta El Kit de Conexin 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 pginas 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 nmero de compra, que permite identificar la operacin. El CGI se comunicar con un servidor de Transbank, el cual solicitar los datos de la Tarjeta de Crdito (TC) al comprador. Cuando se tenga una respuesta sobre la transaccin (aproximadamente 1 segundo despus de la solicitud) desde Transbank se ejecutar la segunda CGIen el sitio del comercio, la que recibir el resultado de la transaccin (aprobado o rechazado) La tarea de integracin 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 operacin desde la segunda CGI de modo de obtener y registrar un cdigo de autorizacin enviado por Transbank. Por lo que el manejo del carro de compras u otras caractersticas con respecto al procedimiento de seleccin de los temes a comprar siempre depende de la solucin del Comercio. Pregunta Que productos entrega Transbank ? Respuesta Transbank entrega a sus clientes el Kit de Conexin de Comercio (KCC) el cual consiste en dos programas que se ejecutarn va 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 combinacin de soluciones tecnolgicas que incluye servidores web como IIS, Netscape, APACHE y Lotus Domino. Adems ha sido utilizado en soluciones de comercio electrnico tales como Siteserver, Intershop, INEX, Netcommerce y otras (Incluyendo soluciones propietarias)
53
TRANSBANK S.A.
Pregunta Que pasa si tengo definido varios servidores v irtuales en un solo servidor fsico ? Respuesta En el archivo tbk_config.dat debe configurarse el parmetro URLCGICOM con la direccin de referencia lgica completa. Ejemplo: SERVERCOM = http://www.supercomerce.cl/cgi-bin/tbk_bp_resultado.cgi Pregunta Por qu no tengo respuesta desde Transbank? Respuesta 1 Puede que estn mal configurados los parmetros 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 mayora de las veces estas ltimas estn ubicadas en el mismo Servidor del Comercio por lo tanto los puertos son iguales y los parmetros tienen el mismo valor. Se acostumbra a utilizar el puerto por defecto 80. Respuesta 2 Puede que el parmetro SERVERTRA ubicado en el archivo tbk_config.dat no tenga la direccin del Servidor de Pago correcta o este mal referenciada, esta debe ser de la forma https. Ej: https://pruebas.webpay.cl Respuesta 3 Puede que el parmetro PORTTRA en el archivo tbk_config.dat este mal configurado y no corresponda al asignado por Transbank.
54
TRANSBANK S.A.
ANEXO C
RECOMENDACIONES A LA SEGURIDAD DEL KCC
Dejar habilitado un puerto exclusivo para la comunicacin 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 algn posible plagio de la tienda. Las paginas de cierre de transacciones deben ubicarse en un directorio virtual distinto del resto de las pginas de la tienda virtual. Este directorio debe protegerse de tal forma que permita la ejecucin de dichas pginas slo desde el servidor donde se encuentra tbk_bp_resultado. Habitualmente el mismo directorio.
55
TRANSBANK S.A.
ANEXO D CERTIFICACIN EFECTUADA POR TRANSBANK

Recibida la Solicitud de Certificacin de Integracin, personal de Transbank realizar pruebas con el objetivo de verificar que el proceso de integracin efectuado por el Establecimiento se haya realizado exitosamente y que los nmeros de orden de pedido generados por la tienda sean correctamente interpretados por el comercio. Para poder efectuar este proceso, el Establecimiento en certificacin debe quedar habilitado para que Transbank ingrese (en forma remota a travs de Internet o en las dependencias del Establecimiento) el set de transacciones de certificacin.
Luego de este proceso el Establecimiento debe entregar a Transbank el archivo de transacciones que se gener en su servidor web (ejemplo tbk_bitcora_TR_NORMALmmdd.log), el cual se utilizar para v alidar la correcta integracin 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 pas donde se encuentra el Establecimiento. Incluir una descripcin completa de los bienes y/o servicios (tallas/tamaos ropa, voltaje, etc.). Indicar las polticas del Establecimiento relacionadas con devoluciones y reembolsos. Indicar la poltica de entrega de productos del Establecimiento. Por ejemplo, si la entrega est limitada al pas en que est radicado el comercio, cundo puede esperar el tarjetahabiente recibir la entrega, etc. Indicar, cuando las haya, las restricciones para la exportacin. Indicar claramente los costos totales de los productos y servicios, incluyendo todos los cargos de envo 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 pas y moneda de la transaccin. Incluir los logotipos de las marcas y del servicio Webpay de acuerdo a las indicaciones de seal tica existentes en la pgina 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 algn modo de contacto para servicio de atencin al cliente. Entregar al tarjetahabiente un comprobante fsico o electrnico
56
TRANSBANK S.A.
ENTREGA DEL PRODUCTO/SERVICIO Y NOTIFICACIN DE COMPRA En caso de que la transaccin sea aprobada por Transbank, el Comercio deber despachar el o los productos seleccionados por el tarjetahabiente o prestar el servicio pagado segn corresponda. INFORMACIN 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 mnimo la siguiente informacin:

4 ltimos dgitos de la tarjeta de crdito. (informado por Transbank) Nmero de orden de Pedido Nombre del comercio URL del comercio (direccin on line del comercio) Monto y moneda de la transaccin Fecha de la transaccin Nombre del comprador Cdigo de autorizacin Tipo de transaccin: se debe indicar la palabra Venta Nmero de Cuotas: Se debe indicar el nmero de cuotas informado por Transbank (para las transacciones sin cuotas se debe informar 00) Tipo de Cuotas: se debe sealar lo siguiente dependiendo de la respuesta informada por Transbank:
o Sin Cuotas: si se trata de ventas sin cuotas.

o o o o Normales: si se trata de cuotas normales Sin intereses: si se trata de tres cuotas sin intereses Descripcin de los bienes y/o servicios Una lista de cualquier restriccin relacionada con las devoluciones de reembolsos.
Este recibo adems puede enviarse a travs de algn medio electrnico o fsico cuando la mercadera sea entregada al tarjetahabiente.
57
TRANSBANK S.A.
ANEXO E CALCULO DEL VALOR CUOTA

Las siguientes son las frmulas utilizadas para el clculo del Valor Presente (precio contado) y del Valor Cuota, referidos a la tasa mxima convencional. El VALOR PRESENTE a la mxima se obtiene aplicando la siguiente frmula:
Valor Presente a Mxima =
VC * 1 (1 + Tm ) Tm
Donde: Vc: es el monto de la cuota (informado en la Tx) Tm: es la tasa Mxima Definida (almacenada en tabla) n :es el nmero de cuotas (informado en Tx). EL VALOR CUOTA se obtiene despejando de la frmula anterior:
Vc = VP * Tm * (1 + Tm ) n
(1 + Tm ) n 1
Tm * (1 + Tm )
el extracto
n
(1 +
Tm ) 1
n
corresponde al factor F.
Luego:
Vc = Precio Contado * F
Donde: F: N cuotas: Tm: es funcin del n cuotas y de la Tm. 6 a 24 se modifica mensualmente y se publica en el diario oficial entre el da 8 y 10 de cada mes.
En cualquier caso, para clientes con webpay con cuotas comercio como T. Cocha lo que debemos hacer es enviarles la tabla de factores actualizada para que puedan calcular el valor cuota.
58
TRANSBANK S.A.
ANEXO F
TIPIFICACIN DE ERRORES Los errores se verifican en la pagina que lo genera haciendo una vista al cdigo fuente y observando al pie del cdigo generado el numero del error ocurrido. Adems estos quedan registrados en los logs de eventos.
59
TRANSBANK S.A.
N Cdigo Error Error 0 SIN_ERR 1 ERR_LECTURA_INPUT 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 ERR_LETURA_PARAMETROS ERR_PARAM_CODIGO_COMERCIO ERR_PARAM_URL_CGI_COMERCIO ERR_PARAM_SERVIDOR_COMERCIO ERR_PARAM_PUERTO_COMERCIO ERR_PARAM_URL_CGI_TRANSBANK ERR_PARAM_SERVIDOR_TRANSBANK ERR_PARAM_PUERTO_TRANSBANK ERR_MEM_MENSAJE ERR_MAC ERR_VERSION_KCC ERR_MSG_OLDKCC ERR_CODIGO_COMERCIO ERR_DATOS_COMERCIO ERR_TIPO_TRANSACCION ERR_URL_CGI_COMERCIO ERR_SERVIDOR_COMERCIO ERR_PUERTO_COMERCIO ERR_CVV ERR_DUPLICADO ERR_ESTADO_COMERCIO ERR_TEMPLATE_COMPRA
Descripcin No hay errores Error de lectura e el Input Error en lectura de parmetros archivo Error en parmetro CODIGO_COMERCIO Falta parmetro URL_CGI_COMERCIO Falta parmetro SERVIDOR_COMERCIO Falta parmetro PUERTO_COMERCIO Falta parmetro URL_CGI_TRANSBANK Falta parmetro SERVIDOR_TRANSBANK Falta parmetro PUERTO_TRANSBANK Falta memoria para variable mensaje Error firma digital Versin de KCC no valida Versin antigua de KCC sin variable msg Error en la variable CODIGO_COMERCIO Error en datos en archivo datos de comercio Error en variable TIPO_TRANSACCION Error en la variable URL_CGI_COMERCIO Error en variable SERVIDOR_COMERCIO Error en variable PUERTO_COMERCIO Error en variable CVV Error por deteccin de transaccin duplicada Error en estado del comercio (comercio no activo) Error en archivo template compra
60
TRANSBANK S.A.
N Error 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
Cdigo Error
ERR_TEMPLATE_COMPRA_DET ERR_FECHA_EXPIRACION ERR_MONEDA_INVALIDA ERR_TEMPLATE_REINTENTO ERR_EDITA_MONTO ERR_ORDEN_COMPRA ERR_ID_TRANSACCION ERR_URL_EXITO ERR_URL_FRACASO ERR_MONTO ERR_REFERER ERR_NUM_TRX ERR_MAX_TIENDA ERR_CODIGO_TIENDA ERR_TIENDA_NO:SOCIADA ERR_MONTO_TIENDA ERR_CONF_TIENDA ERR_URL_RESULTADO ERR_CONECTA_SERVIDOR ERR_SOCKET_LECTURA ERR_SOCKET_ESCRITURA ERR_TIMEOUT_ACK ERR_OBTENER_ACK ERR_ORDEN_TIENDA ERR_NUMERO_TARJETA ERR_NUMERO_CUOTAS ERR_MES_VENCIMIENTO ERR_ANO_VENCIMIENTO ERR_TARJETA 61
Descripcin Error en archivo template de detalle de compra Error en variable VAR_FECHA_EXPIRACION Error en moneda de comercio Error en archivo template de pagina de reintento Error en funcin edita monto Error en variable orden de compra Error en variable VAR_I_TRANSACCION Error en variable URL de Exito Error en variable URL de Fracaso Error en variable Monto Error en invocacin (referer) Error en variable numero de transacciones Error numero de transacciones supera mximo (MALL) Error tienda no se encuentra en nuestro comercio Error tienda no esta asociada a comercio (MALL) Error en variable monto tienda Error de configuracin tienda en maestro comercios Error en variable url_resultado Error al conectar servidor especificado Error al abrir socket para lectura Error al abrir socket para escritura Timeout al esperar ack Error al obtener ack Error variable orden compra tienda Error en variable VAR_NUMERO_TARJETA Error en variable VAR_NUMERO_CUOTAS Error en variable VAR_MES_VENCIMIENTO Error en variable VAR_ANO_VENCIMIENTO Error en variable VAR_ANO_VENCIMIENTO TRANSBANK S.A.
N Error 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82
Cdigo Error
ERR_TIPO_PAGO ERR_RESPUESTA_BASE24 ERR_ACK URL_FRACASO_MALL ERR_TIENDA_EN_NULO ERR_PARAM_PREF_CONF_TR ERR_PARAM_URL_CONF_TR ERR_PARAM_PUERTO_CONF_TR ERR_PARAM_SERVIDOR_CONF_TR ERR_FECHA_TRANSACCION ERR_ABRIR_BITACORA ERR_FALLO_CUOTA_NORMAL ERR_FALLO_CUOTA_C3C ERR_MONEDA_DESCONOCIDA ERR_TIENDA_NOENCONTRADA ERR_TIENDA_NOASOCIADA ERR_TIENDA_DIF_MONEDA ERR_SINMEMORIA ERR_MONTO_DESCUADRADO TRX_DESCUADRADAS ERR_TEMPLATE_ONECLICK ERR_TIENDA_TIPO_PAGO ERR_ID_USUARIO ERR_USUARIO_YA_REGISTRADO ERR_INSERTAR_ONECLICK ERR_USUARIO_NO_REGISTRADO ERR_LEER_ONECLICK ERR_TEMPLATE_TRANSICIN ERR_LOGO_WEBPAY ERR_TEMPLATE_LOGO_WEBPAY 62
Descripcin Error en variable VAR_TIPO_PAGO Error en respuesta del base24 Error al obtener ACK Error variable Fracaso MALL Error en variable de tienda MALL Error en parmetro PARAM_PREF_CONF_TR Error en parmetro de pagina de confirmacin Error en parmetro PARAM_SERVIDOR_CONF_TR Error en parmetro PARAM_SERVIDOR_CONF_TR Error en variable VAR_FECHA_TRANSACCION Error al abrir el archivo de bitcora Fallo venta en cuotas Fallo venta contado 3 cuotas Error cdigo moneda desconocido Error tienda no encontrada en maestro Error tienda no esta asociada a MALL Error tienda con distinta moneda Error no se puede obtener memoria Error monto descuadrado Error numero de transacciones descuadradas Error al abrir template de one click Error en variable tienda tipo pago Error en variable VAR_ID_USUARIO Usuario ya estaba registrado en la base de datos one_click Error al intentar insertar usuario en base de datos one_click Usuario no esta registrado en la base de datos one_click Error al intentar leer usuario en base de datos one_click Error al abrir template de transicin Error en validacin LOGO WEBPAY Error en template de LOGO TRANSBANK S.A.
N Error 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106
Cdigo Error
ERR_ACTUALIZAR_ONECLICK ERR_ELIMINAR_ONECLICK ERR_TEMPLATE_MENSAJE ERR_NUMERO_TARJET_ANTIGUA ERR_ONECLICK_DESHABILITADO ERR_TR_COMPLETA_DESHABILITADA ERR_CAMBIO_MULTICODE ERR_RESPUESTA ERR_LARGO_TIENDA ERR_CORRESPONDENCIA_CUOTAS ERR_TIPO_PAGO_DESHABILITADO ERR_ENVIO_REG_ONECLICK ERR_ID_SESION ERR_TIPO_TBK_TIPO_TRANSACCION ERR_TIPO_TBK_CODIGO_COMERCIO ERR_TIPO_TBK_ID_TRANSACCION ERR_TIPO_TBK_URL_CGI_COMERCIO ERR_TIPO_TBK_SERVIDOR_COMERCIO ERR_TIPO_TBK_PUERTO_COMERCIO ERR_TIPO_TBK_VERSION_KCC ERR_TIPO_TBK_MAC ERR_TIPO_TBK_MONTO ERR_TIPO_TBK_ORDEN_COMPRA ERR_TIPO_TBK_ID_SESION 63
Descripcin Error al actualizar la base de datos one_click Error al eliminar de la base de datos one_click Error al abrir template de mensajes Error en variable VAR_NUMERO_TARJETA_ANTI GUA Comercio no tiene habilitado one click Comercio no tiene habilitada la transaccin completa Error en cambio de multicodigo, variable vaca Error en variable VAR_RESPUSTA Error largo variable tienda Numero de cuotas invalido para tipo de pago indicado Tipo de pago no esta habilitado para el comercio Error al intentar espejar registro one click modificado Error en variable ID_SESION Error Tipo Dato variable TIPO_TRANSACCION Error Tipo Dato var. CODIGO COMERCIO Error Tipo Dato var. ID_TRANSACCION Error Tipo Dato variable CGI_COMERCIO Error Tipo Dato variable SERVIDOR_COMERCIO Error Tipo Dato variable PUERTO_COMERCIO Error Tipo Dato variable VERSION_KCC Error Tipo Dato variable MAC Error Tipo Dato variable MONTO Error Tipo Dato variable ORDEN COMPRA Error Tipo Dato variable ID_SESION TRANSBANK S.A.
N Error 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132
Cdigo Error
ERR_TIPO_TBK_URL_XITO ERR_TIPO_TBK_URL_FRACASO ERR_TIPO_TBK_TARJETA ERR_TIPO_TBK_TIPO_PAGO ERR_TIPO_TBK_NUMERO_CUOTAS ERR_TIPO_TBK_NUMERO_TARJETA ERR_TIPO_TBK_MES_VENCIMIENTO ERR_TIPO_TBK_ANO_VENCIMIENTO ERR_TIPO_TBK_CVV ERR_LEN_TBK_TIPO_TRANSACCION ERR_LEN_TBK_CODIGO_COMERCIO ERR_LEN_TBK_ID_TRANSACCION ERR_LEN_TBK_URL_CGI_COMERCIO ERR_LEN_TBK_SERVIDOR_COMERCIO ERR_TIPO_TBK_PUERTO_COMERCIO ERR_LEN_TBK_VERSION_KCC ERR_LEN_TBK_MAC ERR_LEN_TBK_MONTO ERR_LEN_TBK_ORDEN_COMPRA ERR_LEN_TBK_ID_SESION ERR_LEN_TBK_URL_EXITO ERR_LEN_TBK_URL_EXITO ERR_LEN_TBK_TARJETA ERR_LEN_TBK_TIPO_PAGO ERR_LEN_TBK_NUMERO_CUOTAS ERR_LEN_TBK_NUMERO_TARJETA
Descripcin Error Tipo Dato variable URL_XITO Error Tipo Dato variable URL_FRACASO Error Tipo Dato variable TARJETA Error Tipo Dato variable TIPO_PAGO Error Tipo Dato variable NUMERO_CUOTAS Error Tipo Dato variable NUMERO_TARJETA Error Tipo Dato variable MES_VENCIMIENTO Error Tipo Dato variable ANO_VENCIMIENTO Error Tipo Dato variable CVV Error Largo variable TIPO_TRANSACCION Error Largo variable CODIGO_COMERCIO Error Largo variable ID_TRANSACCION Error Largo variable URL_CGI_COMERCIO Error Largo variable SERVIDOR_COMERCIO Error Largo variable PUERTO_COMERCIO Error Largo variable VERSION_KCC Error Largo variable MAC Error Largo variable MONTO Error Largo variable ORDEN_COMPRA Error Largo variable ID_SESION Error Largo variable URL_XITO Error Largo variable URL_FRACASO Error Largo variable TARJETA Error Largo variable TIPO_PAGO Error Largo variable NUMERO_CUOTAS Error Largo variable NUMERO_TARJETA
64
TRANSBANK S.A.
N Error 133 134 135 136 137 138 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161
Cdigo Error
ERR_LEN_TBK_MES_VENCIMIENTO
Descripcin
Error Largo variable MES_VENCIMIENTO Error Largo variable ERR_LEN_TBK_ANO_VENCIMIENTO ANO_VENCIMIENTO ERR_LEN_TBK_CVV Error Largo variable CVV Error tipo variable ERR_TIPO_TBK_URL_RESULTADO URL_RESULTADO ERR_TIPO_TBK_NUM_TRX Error tipo variable NUM_TRX Error tipo variable ERR_TIPO_TBK_CODIGO_TIENDA CODIGO_TIENDA Error largo variable ERR_LEN_TBK_CODIGO_TIENDA CODIGO_TIENDA Error largo variable ERR_LEN_TBK_ORDEN_TIENDA ORDEN_TIENDA Error largo variable ERR_LEN_TBK_MONTO_TIENDA MONTO_TIENDA ERR_LEN_TBK_ID_USUARIO Error largo variable ID_USUARIO Error largo parmetros ERR_LEN_PARAM_TR_NORMAL TR_NORMAL ERR_LEN_PARAM_TR_MALL Error largo parmetros TR_MALL Error largo parmetros ERR_LEN_PARAM_TR_COMPLETA TR_COMPLETA Error largo parmetros ERR_LEN_PARAM_TR_ONECLICK TR_ONECLICK ERR_LEN_PARAM_TR_INGRESO_ONCLI Error largo parmetros CK TR_INGRESO_ONECLICK ERR_LEN_PARAM_TR_ELIMINACION_ON Error largo parmetros CLICK TR_ELIMINACION_ONECLICK ERR_LEN_PARAM_TR_MODIFICACION_ Error largo parmetros ONCLICK TR_MODIFICACION_ONECLICK ERR_LEN_PARAM_TR_MALL_COMPLET Error largo parmetros A TR_MALL_COMPLETA Error largo parmetros ERR_LEN_PARAM_TR_MALL_ONECLICK TR_MALL_ONECLICK Error largo parmetros ERR_LEN_PARAM_TR_LOGO_WEBPAY TR_LOGO_WEBPAY Error cantidad parmetros ERR_CANT_PARAM_TR_NORMAL TR_NORMAL Error cantidad parmetros ERR_CANT_PARAM_TR_MALL TR_MALL Error cantidad parmetros ERR_CANT_PARAM_TR_COMPLETA TR_COMPLETA Error cantidad parmetros ERR_CANT_PARAM_TR_ONECLICK TR_ONECLICK
65
TRANSBANK S.A.
N Error 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179
Cdigo Error
ERR_CANT_PARAM_TR_INGRESO_ONECLICK
Descripcin
180
181
Error cantidad parmetros TR_ING_ONECLICK Error cantidad parmetros ERR_CANT_PARAM_ELIMINACION_ONECLICK TR_ELIMIN_ONECLICK ERR_CANT_PARAM_TR_MODIFICACION_ONE Error cantidad parmetros CLICK TR_MODIF_ONECLICK Error cantidad parmetros ERR_CANT_PARAM_TR_MALL_COMPLETA TR_MALL_COMPLETA Error cantidad parmetros ERR_CANT_PARAM_TR_MALL_ONECLICK TR_MALL_ONECLICK Error cantidad parmetros ERR_CANT_PARAM_TR_LOGO_WEBPAY TR_LOGO_WEBPAY Error Tipo Dato variable ERR_TIPO_TBK_URL_FRACASO_MALL URL_FRACASO_MALL Error Largo variable ERR_LEN_TBK_URL_FRACASO_MALL URL_FRACASO_MALL Error Tipo Dato variable ERR_TIPO_TBK_FECHA_EXPIRACION FECHA_EXPIRACION Error Largo variable ERR_LEN_TBK_FECHA_EXPIRACION FECHA_EXPIRACION Error Tipo Dato variable ERR_TIPO_TBK_URL_COMERCIO URL_COMERCIO Error Largo Dato variable ERR_LEN_TBK_URL_COMERCIO URL_COMERCIO Error Tipo Dato variable ERR_TIPO_TBK_MONTO_CUOTA MONTO_CUOTA Error Largo Dato variable ERR_LEN_TBK_MONTO_CUOTA MONTO_CUOTA Error en la variable ERR_MONTO_CUOTA MONTO_CUOTA Error Tasa De Inters ERR_TR_TASA_INTERES_DESHABILITADA Deshabilitada Error Largo Dato variable ERR_LEN_PARAM_TR_TASA_INTERES_MAX TR_TASA_INTERES_MAX Error cantidad parmetros ERR_CANT_PARAM_TR_TASA_INTERES_MAX TR_TASA_INTERES_MAX Error por no consistencia entre tiendas de un mall para ERR_CONSISTENCIA_CIC tipo de pago CIC. Deben ser todas CIC o ninguna. Error en cuota asociada a ERR_FALLO_CUOTA_CIC CIC.
66
TRANSBANK S.A.
Departamento Desarrollo Comercio Electrnico Transbank S.A. (Ultima Actualizacin Diciembre 2001) COPYRIGHT2001
67 TRANSBANK S.A.

Transbank S.A.: Kit de Conexión de Comercio KCC Versión 2.0 - 4.0

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Transbank S.A.: Kit de Conexión de Comercio KCC Versión 2.0 - 4.0

Uploaded by

Copyright:

Available Formats

Transbank S.A.

Gerencia de Desarrollo y Tecnologa

3. ETAPAS TCNICAS DE INCORPORACIN A WEBPAY

GLOBAL DEL PROCESO DE LA TRANSACCIN ELECTRNICA

6. MODALIDADES DE USO SOPORTADAS POR WEBPAY

Figura 1. Modalidad Normal de la Transaccin Electrnica con WebPay

7. ARQUITECTURA DEL KCC

Tabla 1. Subprogramas utilizados en el KCC.

Figura 2a. Flujo de Informacin WebPay Modalidad Normal

Figura 2b. Flujo de Informacin WebPay Modalidad Normal

8. INTEGRACIN DEL KCC CON EL SOFTWARE DE LA TIENDA VIRTUAL

8.1 INSTALACIN DEL KCC 8.1.1 CREACIN DE

Datos Log Maestros Template

Tabla 2. Asignacin de Permisos

Ubicacin Permiso Lybeay32.dll Descripcin

Ejemplo Ubicacin Permiso

Ejemplo Ubicacin Permiso

y tienen la forma: $(NOMBRE_PARAMETRO) = $(VALOR_PARAMETRO) donde:

Valor Descripcin Ejemplo

$(PATH_DIRCGI_WEB)/tbk_bp_resultado.cgi Path web donde se encuentra el cgi tbk_bp_resultado.cgi. URLCGICOM = /cgi-bin/tbk_bp_resultado.cgi

Valor Descripcin Ejemplo

Valor Descripcin Ejemplo

Valor Descripcin Ejemplo

Valor Descripcin Ejemplo

Valor Descripcin Ejemplo

Valor Descripcin Ejemplo

Valor Descripcin Ejemplo

/cgi-bin/bp_revision.cgi Path Web del cgi bp_revisin.cgi en Transbank. URLCGITRA = /cgi-bin/bp_revision.cgi

Valor Descripcin Ejemplo

Valor Descripcin Ejemplo

$(PAGINA_CONFIRMACIN) Pgina que se ejecutar para confirmar la transaccin $(TRANSACCIN). HTML_TR_NORMAL=http://198.22.250.29/kcc_normal/xt_compra.asp

$(NIVEL_LOG) Nivel de logs que genera el KCC. Ej.: GLEVEL = 7

Figura 3. Formulario de Pago Estndar

Figura 4. Formulario de Pago para Cuotas Comercio

Directorio base Lectura

Directorio base Lectura y Escritura

Directorio base Lectura

9. DESCRIPCIN DE LAS MODALIDADES

Numero de Tarjeta Fecha de Expiracin CVV

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

Los parmetros de entrada al cgi tbk_bp_pago se definen en la Tabla 6.

Los parmetros de salida de la Operacin Ingreso One Click se muestran la Tabla 8.

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

Figura 7. Diagrama de Flujo de la Modalidad Modificacin One Click.

Los parmetros de entrada al cgi tbk_bp_pago se definen en la Tabla 9.

Figura 8. Diagrama de Flujo de la Modalidad Eliminacin One Click.

Los parmetros de entrada al cgi tbk_bp_pago se definen en la Tabla 11.

Tabla 13. Parmetros de entrada de la Modalidad Mall Virtual.

Los parmetros de salida de la Modalidad Mall Virtual se muestran la Tabla 14.

Parmetro TBK_TIPO_TRANSACCION TBK_RESPUESTA TBK_ORDEN_COMPRA

Observacin: XXX vara de 001 a 006.

Los parmetros de salida de la Modalidad Consulta De Tasa se muestran la Tabla 17.

10. ARCHIVOS GENERADOS POR EL KCC

$(TIPO_TRANSACCIN) = TR_NORMAL, TR_MALL, etc. $(FECHA) = mmdd o aaaammdd.

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

Variable TBK_ORDEN_COMPRA TBK_TIPO_TRANSACCION TBK_RESPUESTA TBK_MONTO

TBK_FINAL_NUMERO_TARJETA TBK_FECHA_CONTABLE TBK_FECHA_TRANSACCION TBK_HORA_TRANSACCION TBK_ID_SESION TBK_ID_TRANSACCION TBK_TIPO_PAGO TBK_NUMERO_CUOTAS TBK_TASA_INTERES_MAX

11. EJEMPLO DE INTEGRACIN DE KCC CON EL SOFTWARE DE COMERCIO

Tabla 20. Suposiciones ejemplo de integracin KCC.

11.3 CREACIN DE ESTRUCTURA DE DIRECTORIOS, COPIA DE ARCHIVOS Y

11.4.2 ARCHIVO DE CONFIGURACIN TBK_TRACE.DAT Agregar la siguiente lnea al archivo:

DATOS CODIGO DE COMERCIO

DATOS TARJETA DE CRDITO