Manual de Integración Oscommerce - Guía de integración de Oscommerce con PagosOnline.net
←
→
Transcripción del contenido de la página
Si su navegador no muestra la página correctamente, lea el contenido de la página a continuación
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”.
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).
10Le 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”:
11Haga 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.
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:
12Modifique 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”.
135. 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
14Por 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'.
Importante
No 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.
152009
También puede leer
