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.
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.
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.
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:
Guarde todos los cambios presionando el botón Guardar y retornará al Listado métodos de pago.
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.
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.
Apéndice A: Configuración de Credenciales SafetyPay Ingrese al Sistema de Administración de Comercios (SafetyPay Merchant Management System - MMS): MMS Sandbox (Prueba) MMS Producción : https://secure.safetypay.com/sandbox/merchants/ : 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.
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) MMS Producción : https://secure.safetypay.com/sandbox/merchants/ : 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.
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/