Manual de Integración Oscommerce

Guía de integración de Oscommerce con PagosOnline.net

VERSIÓN 3.0

TABLA DE CONTENIDO

Pág.

1. INTRODUCCIÓN 2

2. REQUERIMIENTOS DEL SERVIDOR 3

3. INSTALACIÓN DE OSCOMMERCE 2.2 4

4. INSTALACIÓN Y CONFIGURACIÓN DEL PLUGIN DE PAGOSONLINE.NET 8

5 PRUEBAS 14

1. INTRODUCCIÓN

Este pequeño tutorial busca facilitar el proceso de instalación y configuración del carro de compras Oscommerce (http://www.oscommerce.com ) con el gateway de pagos Pagosonline.net (http://www.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

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

3. INSTALACIÓN DE OSCOMMERCE 2.2

Primero descargamos el instalador http://www.oscommerce.com/solutions/downloads . 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:

http:// www.misitio.com/tienda/

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

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

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

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

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.

4.1. 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 = "1111111111111111";

• 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

2. Modificamos el archivo:

/includes/constantes_pagosonline.php

y colocamos los datos de acuerdo a nuestro comercio.

4.2. PERSONALIZACIÓN DEL ADMINISTRADOR

1. Ingresamos al administrador del oscommerce:

http:// www.misitio.com/tienda/admin

• 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

• 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”.

ImportanteSi 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

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 = 0.00043859

Valor: 0.00043859

Le damos en insertar para que tome los cambios y enseguida hacemos lo mismo con la moneda Dólares: 1/1950 = 0.00051282

Valor: 0.00051282

Nota: Es recomendable actualizar estos datos semanalmente.

3. En la misma sección de “Localización” haga clic en el menú “Estado Pedidos”:

11

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 : RejectedDeutsch : 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.

4.3. 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

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 “E-mail Address”.

Nota: En este punto puede deshabilitar los otros medios de pago al seleccionarlos y dar clic en “quitar”.

13

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

9955555555555501 Aprobada

9955555555555504 Rechazada

9955555555555515 En proceso de validación

14

Por ejemplo, para aceptar una transacción escriba el siguiente número de tarjeta de crédito: 9900000000000001. 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'.

ImportanteNo realice pruebas con tarjetas débito, cuenta de ahorro o cuenta corriente si el action del form envía los datos a

https://gateway.pagosonline.net/apps/gateway/index.html

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

2009