Manual de Integración Oscommerce Guía de integración de Oscommerce con PagosOnline.net VERSIÓN 3.0

Transcripción

1 Manual de Integración Oscommerce Guía de integración de Oscommerce con PagosOnline.net VERSIÓN 3.0

2 TABLA DE CONTENIDO Pág. 1. INTRODUCCIÓN 2 2. REQUERIMIENTOS DEL SERVIDOR 3 3. INSTALACIÓN DE OSCOMMERCE INSTALACIÓN Y CONFIGURACIÓN DEL PLUGIN DE PAGOSONLINE.NET 8 5 PRUEBAS 14

3 1. INTRODUCCIÓN Este pequeño tutorial busca facilitar el proceso de instalación y configuración del carro de compras Oscommerce ( con el gateway de pagos Pagosonline.net ( De una manera ilustrada, mostramos paso a paso el proceso de instalación del Oscommerce (a manera de ejemplo) y la posterior instalación y personalización de los archivos del plugin. Nuestra meta es hacer lo más fácil posible dicho proceso. 2

4 2. REQUERIMIENTOS DEL SERVIDOR La versión a trabajar en este tutorial es v2.2 Release Candidate 2. Los requerimientos del servidor son: PHP v3+ (PHP v5+ recommended) MySQL v3+ (MySQL v5+ recommended) También es recomendable un servidor de correos (sendmail por ejemplo) para enviar correos de confirmación a los compradores desde su tienda. 3

5 3. INSTALACIÓN DE OSCOMMERCE 2.2 Primero descargamos el instalador Enseguida debemos copiar el contenido de la carpeta catalogo a la carpeta del servidor donde va a quedar nuestra tienda virtual (puede utilizar fillezilla un cliente ftp para sistemas Linux y Windows). Una vez haya terminado la copia, cargue la ruta de la tienda en su navegados. A manera de ejemplo durante todo el manual, vamos a utilizar misitio.com como ejemplo: Se mostrará una advertencia haciendo referencia a ciertos archivos que, durante el proceso de instalación, deben tener permisos de escritura pública. Lo podemos cambiar a través de nuestro administrador del servidor o el cliente ftp, como se muestra a continuación: 4

6 Una vez hecho esto recargamos la página de instalación del oscommerce y debe salir así: Si aún siguen saliendo alguna advertencia verifique los permisos de los archivos de nuevo. 5

7 En seguida, se colocan los datos de la base de datos: Servidor de base de datos (normalmente localhost) Usuario (nombre del usuario de la base de datos) Password Nombre de la base de datos El Web Server (servidor web) regularmente se dejan los datos que ha detectado el oscommerce. 6

8 Si todo terminó bien, saldrá el mensaje mostrando que la instalación fue exitosa. Por último debemos vamos al catálogo, si sale la advertencia de problemas de permisos, realizamos el proceso de cambio de los mismos que realizamos al iniciar a través del administrador del servidor o cliente ftp. 7

9 4. INSTALACIÓN Y CONFIGURACIÓN DEL PLUGIN DE PAGOSONLINE.NET Descargamos el plugin del oscommerce y lo descomprimimos. Antes de cargarlos en el servidor debemos modificar los archivos de acuerdo a nuestras necesidades PERSONALIZACIÓN DE ARCHIVOS 1. Modificamos el archivo: /includes/modules/payment/pagosonline.php Vamos a la línea 34: $this->usuario_id = 0; Y la cambiamos por el identificador suministrado por pagosonline.net. Para este ejemplo vamos a utilizar el usuario ID 2 $this->usuario_id = 2; Vamos a la línea 40 y reemplazamos la llave por la que se encuentra en el panel administrativo en la pestaña Opciones. Para este ejemplo utilizaremos la asignada al usuario 2: $this->clave_secreta = " "; En la línea 43 modificamos el valor a utilizar en el IVA (para Colombia es el 16%). $this->tasa_iva = 0.16; En el caso de estar exentos de IVA, colocamos $this->tasa_iva = 0; 8

10 2. Modificamos el archivo: /includes/constantes_pagosonline.php y colocamos los datos de acuerdo a nuestro comercio PERSONALIZACIÓN DEL ADMINISTRADOR 1. Ingresamos al administrador del oscommerce: Allí vamos a Zonas/Impuestos Zonas de Impuestos : agregue una nueva zona y colóquele "Colombia" en el nombre, la descripción no es necesaria. Dentro de la zona creada es necesario agregar una subzona dándole clic a la zona recién creada (Colombia para este ejemplo) con la siguiente información: País Colombia, Zona Todas las zonas En esa misma sección vaya a "Tipos de Impuestos" y agregue un nuevo tipo, en el nombre colóquele IVA, la descripción no es necesaria. 9

11 En seguida vaya a "Impuestos" y de clic en nuevo porcentaje ; allí agregue un nuevo impuesto, verifique que en el nombre del Porcentaje aparezca IVA seleccionado, en Zona que aparezca Colombia seleccionada, en Porcentaje colóquele 16 (o '0' en el caso de ser régimen simplificado). En descripción puede colocar IVA 16% y en prioridad colóquele 1. Si lo queremos podemos borrar el que trae por defecto el Oscommerce ( Taxable Goods ), seleccionándolo y dándole clic en eliminar. En caso se manejar otros impuestos, se deben cargar en Tipos de Impuestos y Impuestos. Importante Si esta configuración no coincide con el porcentaje del IVA declarado en el archivo y tampoco se siguieron en su totalidad los puntos anteriores, es muy posible que los valores enviados a pagosonline.net no coincidan con los establecidos en el carro de compras. 2. Para este ejemplo, se configurará las siguientes monedas: Pesos colombianos, Dólares y Euros. Si desea configurar otras monedas debe seguir un proceso similar al aquí explicado. Estando en el administrador del oscommerce vaya a la sección "Localización" "Monedas". Allí aparecen listadas las monedas que trae por defecto el oscommerce: Nota: Si las monedas no aparecen es necesario crearlas, preferiblemente después de generar la moneda de pesos colombianos (en el caso de manejarlos). 10

12 Le damos en nueva moneda y colocamos los datos como siguen: Título: Pesos Colombianos Código: COP Símbolo a la izquierda: $ Símbolo a la derecha: (vacío) Punto decimal:. (punto) Separador de miles:, (coma) Lugares decimales: 2 (número 2) Valor: 1 (número uno) En el respectivo caso que nuestra tienda utilice los pesos colombianos como moneda estandarizada, se marca la casilla: [] Establecer como predeterminado/a y le damos insertar. Luego seleccionamos Euros y le damos en editar. En el campo valor colocamos el resultado de la división de 1 sobre el valor del Euro según la TRM del día. Para el caso de este ejemplo el Euro esta en 2050 pesos colombianos por lo tanto colocamos: 1/2280 = Valor: Le damos en insertar para que tome los cambios y enseguida hacemos lo mismo con la moneda Dólares: 1/1950 = Valor: Nota: Es recomendable actualizar estos datos semanalmente. 3. En la misma sección de Localización haga clic en el menú Estado Pedidos : 11

13 Haga clic en el botón insertar e ingrese los siguientes estados de pedidos, en todos los casos seleccione la opción Show the order to the customer at this order status level : English : Incomplete Deutsch : Unvollständig Español : Incompleto English : Approved Deutsch : Anerkannt Español : Aprobado English : Cancelled Deutsch : Annulliert Español : Cancelado English : Rejected Deutsch : Zurückgewiesen Español : Rechazado Nota: Los estados especificados en el idioma español no pueden ser cambiados, en los otros idiomas si puede cambiarlos CARGA DE ARCHIVOS Utilizando su gestor ftp realice la carga y sobreescritura (en dado caso) de los archivos del plugin en el carrito ya configurado. En seguida, en el administrador del mismo vaya a Módulos Pagos. Seleccione pagosonline.net y dele clic en instalar. Una vez lo haya instalado, dele clic en modificar y aparecerá la siguiente pantalla: 12

14 Modifique los siguientes: Payment Zone : Colombia (o según sea su caso) Set order status : Pendiente Sort order display : 0 (para que se muestre el medio de pago de pagosonline de primero) Igualmente coloque el mail de confirmación en Address. Nota: En este punto puede deshabilitar los otros medios de pago al seleccionarlos y dar clic en quitar. 13

15 5. PRUEBAS A continuación, cree un producto y realice una prueba de pago. Pagosonline.net cuenta con un módulo y un servidor de pruebas (clon del servidor de producción), que permite realizar pruebas con tarjetas de crédito ficticias y pagos simulados sobre el sistema PSE, en tiempo real. 5.1 PRUEBAS CON TARJETA DE CRÉDITO A continuación se describe el procedimiento para realizar una prueba en el sistema: 1. Para que el sistema utilice el módulo de pruebas debe enviar una solicitud de pago con la variable prueba con el valor 1, para hacer esto modificamos el archivo: /includes/modules/payment/pagosonline.php buscamos la línea 37 y activamos el modo prueba: $this->prueba = 1; Luego realice una prueba de pago. 2. Cuando llegue al gateway de pagos de Pagosonline.net debe seleccionar una de las franquicias emisoras de las tarjetas de crédito (VISA, MASTERCARD, ETC). 3. Debe ingresar todos los datos requeridos por el sistema, digitando en el campo de la tarjeta de crédito un número de longitud 16 dígitos. Para conseguir determinada respuesta ingrese uno de los siguientes números: Número de tarjeta Respuesta respuesta_estado_pol Aprobada Rechazada En proceso de validación 14

16 Por ejemplo, para aceptar una transacción escriba el siguiente número de tarjeta de crédito: Los dos primeros dígitos (99) indican que se trata de una tarjeta de crédito de pruebas. Los dos últimos dígitos de la tarjeta de crédito (01) corresponden al código de respuesta de una transacción aceptada. Los dígitos intermedios son irrelevantes pueden tomar cualquier número. Por lo tanto si usted desea generar otros estados de respuesta por favor remítase al Anexo V del Manual de integración Tradicional versión 3. Si hace la prueba con MasterCard los dígitos de verificación son '123'. Importante No realice pruebas con tarjetas débito, cuenta de ahorro o cuenta corriente si el action del form envía los datos a ya que se le debitará de la cuenta el pago como si fuera una transacción real. Para analizar el funcionamiento completo del sistema realice pruebas con tarjetas crédito, el flujo de la información con tarjetas débito es el mismo, tan solo que al momento de pagar se redirige al sitio web del banco para que allí ingrese usuario y contraseña, y al finalizar el pago se redirige a su página de respuesta. 15

17 2009