Instalación y Configuración del Módulo de Pago Joomla/VirtueMart

(SafetyPay API 2.2)

SafetyPay Inc. provee de un módulo de manera libre para ser usado en conjunto con la solución Joomla. Este
módulo le permite que sea muy fácil el integrar SafetyPay dentro de su sistema de tienda en línea. El servicio
es sencillo de instalar y probar.

NOTA: Antes de instalar y configurar la extensión, aseguresé que sea compatible con la version de Joomla y
VirtueMart que está usando.

Preliminar

1. Compatibilidad: PHP 4.3.x o superior / MySQL 4.x o superior / Joomla 1.5.x o superior / VirtueMart
1.1.3 o superior.
2. Requerimientos: Extensión cURL activa. Idiomas soportados: Inglés y Español.
3. Configure y Actualice sus Credenciales SafetyPay (Apéndice A).
4. Activar Servicio de Notificaciones (Apéndice B).
5. Realice una copia de seguridad (archivos y base de datos) de su aplicación actual.
6. Si posee una versión anterior instalada en su tienda virtual, recomendamos desinstalarla y eliminar los
archivos relacionados.

Procedimiento

1. Primero, active el Componente SafetyPay. Para ello use el archivo: com_safetypay_r1.zip, este
instalará el componente principal y un plugin (en versión beta).

INSTALACION DE COMPONENTE
• Seleccione Extensiones > Instalar/Desinstalar del menu desplegable ubicado en el Panel
Administrador de Joomla!.
• Clic en el botón "Examinar" dentro de "Subir archivo desde un paquete"para seleccionar el
archivo que contiene el componente (com_safeypay_r1.zip).
Clic en “Subir archivo & instalar” para que Joomla! descomprima e instale el componente.
• Cuando esto finalice, en pantalla debe mostrarse un mensaje: "Instalar Componente: Éxito".
Si la instalación no tiene éxito, se le mostrarán mensajes de error.
• Terminada la instalación, clic en “Show SafetyPay Transactions List”. Esta le mostrará una lista
del estado de todas las transacciones y ordenes que usan a SafetyPay como forma de pago.

SafetyPay - El sistema de pagos global y seguro para compras en Internet

Listado de Transacciones SafetyPay
Para visualizar el estado de las Ordenes y Transacciones SafetyPay, seleccione Componentes >
SafetyPay del menu desplegable ubicado en el Panel Administrador de Joomla!.

CONFIGURACION DE COMPONENTE
• Seleccione Componentes > SafetyPay del menu desplegable ubicado en el Panel
Administrador de Joomla!.
• Clic en el botón "Preferencias" ubicado en la parte superior derecha en la barra de
herramientas donde encontrará una serie de parámetros a completar.

• Completar/Actualizar los siguientes parámetros:

a. API Key y Signature Key: registre sus credenciales. Siga el apéndice A.
b. Moneda Predeterminada (En Prueba): Ingrese el Código de Moneda en la cual
vende sus productos. Usado solo (por el momento) en SafetyPay Express. Ingresar
solo códigos del estándar ISO 4217, ejemplo: MXN, PEN, USD, EUR, etc.
c. Habilitar Plataforma: seleccione Sandbox (si posee credencial de prueba) ó
Producción (si posee credencial de producción). Siga el apéndice A.

SafetyPay - El sistema de pagos global y seguro para compras en Internet

 d. Protocolo de Conexión: seleccione HTTP (para establecer conexiones en prueba)
ó HTTPS (para establecer conexiones en producción, recomendado).
e. Notificación a Comprador (En Prueba): seleccione Activar (enviará mensajes de
notificación a comprador) ó Desactivar (deshabilita mensajes de notificación).
f. URL Retorno Satisfactorio a Comercio: indique su Dirección Web (URL) completa
donde desea redireccionar al comprador luego que su intento por pagar una
transacción sea satisfactoria desde el Sistema de Banca Electrónica.
NOTE: Si deja vacío, el componente toma una URL predeterminada. Ver Apénd. B.
g. URLde Retorno Erróneo a Comercio: indique su Dirección Web (URL) completa
donde desea redireccionar al comprador luego que su intento por pagar una
transacción sea errónea desde el Sistema de Banca Electrónica.
NOTE: Si deja vacío, el componente toma una URL predeterminada. Ver Apénd. B.
• Guarde todos los cambios presionando el botón "Guardar".

PRUEBA AL SERVICIO
• Seleccione Menús > Main Menu del menu desplegable ubicado en el Panel Administrador de
Joomla!.
• Clic en el botón "Crear" en la barra de herramientas.
• Seleccione un Tipo de Item de menú. De la lista seleccione:
SafetyPay > SafetyPay > Prueba del Servicio.
• Ingrese el Título (ejemplo: “Demo SafetyPay”), y a continuación
clic en el botón “Guardar”.

• Ahora recarge la página principal de su sitio web para ver el nuevo elemento de menú. Clic en
la opción de menú recientemente creado (ejemplo: Demo SafetyPay). Ubique y al dar clic en
“¡Comprar Ahora!” se le redireccionará al servicio SafetyPay Express, si esto se cumple habrá
configurado correctamente el componente. Importante: Elimine o desactive este menú
cuando active a SafetyPay en producción.

SafetyPay - El sistema de pagos global y seguro para compras en Internet

2. Segundo, para incluir a SafetyPay como nuevo método de pago en Virtuemart se requiere tener
previamente instalado el componente. Desde aquí le indicaremos los pasos para agregar a SafetyPay
como nuevo método de pago en VirtueMart. Es importante mantener el Componente SafetyPay activo
y configurado.

INSTALACION DE EXTENSION
• Publique el archivo ps_safetypay_api.php en su servidor web, en la siguiente ruta teniendo como
ruta raíz su instalación Joomla: /administrator/components/com_virtuemart/classes/payment/
• Edite el archivo get_final_confirmation.tpl.php ubicado en:
/components/com_virtuemart/themes/default/templates/checkout/

Buscar estas líneas:

echo '<td>';
echo $db->f("payment_method_name");
echo "</td></tr>";

Reemplácelas por estas líneas:

echo '<td>';
echo $db->f("payment_method_name");
echo "</td></tr>";
require_once(JPATH_ROOT.DS.'components/com_safetypay/models/safetypay.php');
echo SAFETYPAYModelSafetyPay::showOptions($payment_method_id);

Este cambio mostrará el listado de monedas y bancos que el comprador seleccionará para
crear una Transacción SafetyPay.

INSTALACION DE SAFETYPAY EN VIRTUEMART

• Seleccione Componentes > VirtueMart del menu desplegable ubicado en el Panel
Administrador de Joomla!.
• En el Panel de Control VirtueMart seleccione Tienda > Añadir método de pago.
• Ingrese/Seleccione la siguiente información en “Formulario de método de pago”:
¿Activo?: (Debe estar marcado)
Nombre: SafetyPay
Código: SAFTAPI
Nombre de la clase de pago: ps_safetypay_api
Tipo de método de pago: Basado en formulario HTML (p.e. PayPal)
• Registre todos lo ingresado hasta el momento, presionando el botón “Aplicar”.
• Seleccione la ficha Configuration e ingrese el siguiente código en “Payment Extra Info”:
<?php
if (class_exists('ps_safetypay_api'))
echo ps_safetypay_api::showConfirmation($db->f("order_id"));
?>
Tal como se muestra en la siguiente imagen:

SafetyPay - El sistema de pagos global y seguro para compras en Internet

• Guarde todos los cambios presionando el botón Guardar y retornará al Listado métodos de
pago.

SafetyPay - El sistema de pagos global y seguro para compras en Internet

SERVICIO ACTIVO

Cuando termine de instalar y configurar correctamente, SafetyPay debe estar ya activo.

A continuación imágenes como se muestra SafetyPay activo en VirtueMart:

a. SafetyPay en Lista de Métodos de Pago.

b. Choice of currency and bank to pay order.

c. Create Transaction. Confirmation Message displayed information to Shopper.

SafetyPay - El sistema de pagos global y seguro para compras en Internet

Soporte Oficial

Las futuras revisiones del Componente SafetyPay serán publicadas oficialmente desde JoomlaCode.org quien
gestiona proyectos de software Open Source para Joomla!.

El nombre del proyecto es: SafetyPay for Joomla/VirtueMart, ubicado en:

http://joomlacode.org/gf/project/safetypay_api/

Estaremos atentos a sus comentarios y sugerencias.

SafetyPay - El sistema de pagos global y seguro para compras en Internet

Apéndice A: Configuración de Credenciales SafetyPay

Ingrese al Sistema de Administración de Comercios (SafetyPay Merchant Management System - MMS):

MMS Sandbox (Prueba) : https://secure.safetypay.com/sandbox/Merchants/

MMS Producción : https://secure.safetypay.com/Merchants/

• Ingrese a la opción: Perfil > Credenciales.

• Presione el botón Generar Nuevas Credenciales de WS para generar las llaves de acceso: API Key y
Signature Key.

• Presionar “Actualizar” para registrar la nueva información.

• Copie estas llaves de acceso y regístrelos en los campos correspondientes “API Key” y “Signature
Key” de la sección de configuración del módulo de pago en el Área de Administración.

Puede solicitar las Credenciales de Producción en cualquier momento. Recomendamos que

notifique a su representante SafetyPay una vez que la integración se haya completado para
promover su sitio en la red de negocios SafetyPay.

SafetyPay - El sistema de pagos global y seguro para compras en Internet

Apéndice B: Activar Servicio de Notificaciones

Ingrese al Sistema de Administración de Comercios (SafetyPay Merchant Management System - MMS)

para activar las dos formas con las cuales desea Ud. como comercio ser notificado sobre los pagos de
transacciones que realicen los compradores en Banca Electrónica.

MMS Sandbox (Prueba) : https://secure.safetypay.com/sandbox/Merchants/

MMS Producción : https://secure.safetypay.com/Merchants/

• Ingrese a la opción: Perfil > Notificaciones.

• Defina y active las dos formas de notificación:
1. Correo Electrónico, actualice este campo con una cuenta de correo electrónico para enviarle un
correo de “Notificación de Pago SAFETYPAY”.

2. POST URL, actualice este campo con el valor de una Dirección Web (URL) del script que permita
a su sistema recibir Notificaciones de Pago Automática.

El componente genera la siguiente URL predeterminada:

http://www.mitienda.com/index.php?option=com_safetypay&task=post

Donde: www.mitienda.com representa el Dominio donde se encuentra su tienda virtual.

Este URL le permitirá recibir las Notificaciones Automáticas de SafetyPay apenas un comprador
confirme el pago de una transacción. La notificación consta de dos tareas: la primera, actualizar el
estado de una determinada Orden de Pendiente a Completado; segundo, envia automáticamente
un correo electrónico Confirmando el Pago de la Orden al comprador y tercero, Confirma a
SafetyPay el Número de Despacho o Pedido para futuras referencias.

Para activar el servicio de notificación, deberá marcar las opciones: Notificación por Post y/o
Notificación por Email.

SafetyPay - El sistema de pagos global y seguro para compras en Internet

RECURSOS

1. SafetyPay Demo Store.

Tienda virtual demostrativa integrada con la modalidad SAFETYPAY API como método de pago.
Comunicación al SAFETYPAY WebService v.2.2 bajo plataforma Sandbox (Prueba).
Desde aquí podrá generar Transacciones SAFETYPAY.
http://demostore.safetypay.com/api/

2. Banca Electrónica Demo.

Simula un Sistema de Banca en Línea donde podrá realizar el pago de transacciones SAFETYPAY
bajo plataforma Sandbox (Prueba).
http://demobank.safetypay.com

3. Certificados SafetyPay (Opcional).

En caso necesite autenticarse de manera segura (HTTPS) al Servicio Web de SafetyPay, tiene a
disposición los siguientes formatos del certificado SSL para instalar en su servidor.

• DER encoded binary X.509 (.CER)

http://files.safetypay.com/ssl20092010/securesaftpay/DERencodedbinaryX509/

• Base-64 encoded X.509 (.CER)

http://files.safetypay.com/ssl20092010/securesaftpay/Base64encodedX509/

• Cryptographic Message Syntax Standard - PKCS #7 Certificates (.P7B)

http://files.safetypay.com/ssl20092010/securesaftpay/CryptographicMessageSyntaxStandardPKCS7/

• Certificados Intermedios, no deben ser necesarios, pero en caso que su sistema requiera de ellos,
podrá descargarlos desde:
http://files.safetypay.com/ssl20092010/securesaftpay/Intermediates/

SafetyPay - El sistema de pagos global y seguro para compras en Internet