instalación y configuración del módulo de pago joomla...

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

Instalacin y Configuracin del Mdulo de Pago Joomla/VirtueMart (SafetyPay API 2.2)

SafetyPay Inc. provee de un mdulo de manera libre para ser usado en conjunto con la solucin Joomla. Este mdulo le permite que sea muy fcil el integrar SafetyPay dentro de su sistema de tienda en lnea. El servicio es sencillo de instalar y probar. NOTA: Antes de instalar y configurar la extensin, 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: Extensin cURL activa. Idiomas soportados: Ingls y Espaol.

3. Configure y Actualice sus Credenciales SafetyPay (Apndice A).

4. Activar Servicio de Notificaciones (Apndice B).

5. Realice una copia de seguridad (archivos y base de datos) de su aplicacin actual.

6. Si posee una versin 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 versin beta).

INSTALACION DE COMPONENTE Seleccione Extensiones > Instalar/Desinstalar del menu desplegable ubicado en el Panel

Administrador de Joomla!. Clic en el botn "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 instalacin no tiene xito, se le mostrarn mensajes de error.

Terminada la instalacin, 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 botn "Preferencias" ubicado en la parte superior derecha en la barra de

herramientas donde encontrar una serie de parmetros a completar.

Completar/Actualizar los siguientes parmetros:

a. API Key y Signature Key: registre sus credenciales. Siga el apndice A. b. Moneda Predeterminada (En Prueba): Ingrese el Cdigo de Moneda en la cual

vende sus productos. Usado solo (por el momento) en SafetyPay Express. Ingresar solo cdigos del estndar ISO 4217, ejemplo: MXN, PEN, USD, EUR, etc.

c. Habilitar Plataforma: seleccione Sandbox (si posee credencial de prueba) Produccin (si posee credencial de produccin). Siga el apndice A.


d. Protocolo de Conexin: seleccione HTTP (para establecer conexiones en prueba)

HTTPS (para establecer conexiones en produccin, recomendado). e. Notificacin a Comprador (En Prueba): seleccione Activar (enviar mensajes de

notificacin a comprador) Desactivar (deshabilita mensajes de notificacin). f. URL Retorno Satisfactorio a Comercio: indique su Direccin Web (URL) completa

donde desea redireccionar al comprador luego que su intento por pagar una transaccin sea satisfactoria desde el Sistema de Banca Electrnica. NOTE: Si deja vaco, el componente toma una URL predeterminada. Ver Apnd. B.

g. URLde Retorno Errneo a Comercio: indique su Direccin Web (URL) completa donde desea redireccionar al comprador luego que su intento por pagar una transaccin sea errnea desde el Sistema de Banca Electrnica. NOTE: Si deja vaco, el componente toma una URL predeterminada. Ver Apnd. B.

Guarde todos los cambios presionando el botn "Guardar". PRUEBA AL SERVICIO Seleccione Mens > Main Menu del menu desplegable ubicado en el Panel Administrador de

Joomla!. Clic en el botn "Crear" en la barra de herramientas. Seleccione un Tipo de Item de men. De la lista seleccione:

SafetyPay > SafetyPay > Prueba del Servicio . Ingrese el Ttulo (ejemplo: Demo SafetyPay), y a continuacin

clic en el botn Guardar.

Ahora recarge la pgina principal de su sitio web para ver el nuevo elemento de men. Clic en la opcin 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 produccin .


2. Segundo, para incluir a SafetyPay como nuevo mtodo de pago en Virtuemart se requiere tener

previamente instalado el componente. Desde aqu le indicaremos los pasos para agregar a SafetyPay como nuevo mtodo 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 raz su instalacin 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 lneas:

echo ''; echo $db->f("payment_method_name"); echo "";

Reemplcelas por estas lneas:

echo ''; echo $db->f("payment_method_name"); echo ""; 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 Transaccin 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 > Aadir mtodo de pago . Ingrese/Seleccione la siguiente informacin en Formulario de mtodo de pago:

Activo?: (Debe estar marcado) Nombre: SafetyPay Cdigo: SAFTAPI Nombre de la clase de pago: ps_safetypay_api Tipo de mtodo de pago: Basado en formulario HTML (p.e. PayPal)

Registre todos lo ingresado hasta el momento, presionando el botn Aplicar. Seleccione la ficha Configuration e ingrese el siguiente cdigo en Payment Extra Info:

Tal como se muestra en la siguiente imagen:


Guarde todos los cambios presionando el botn Guardar y retornar al Listado mtodos de

pago .


SERVICIO ACTIVO Cuando termine de instalar y configurar correctamente, SafetyPay debe estar ya activo. A continuacin imgenes como se muestra SafetyPay activo en VirtueMart: a. SafetyPay en Lista de Mtodos de Pago.

b. Choice of currency and bank to pay order.

c. Create Transaction. Confirmation Message display ed information to Shopper.


Soporte Oficial Las futuras revisiones del Componente SafetyPay sern 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.


Apndice A: Configuracin de Credenciales SafetyPay

Ingrese al Sistema de Administracin de Comercios (SafetyPay Merchant Management System - MMS): MMS Sandbox (Prueba) : https://secure.safetypay.com/sandbox/Merchants/ MMS Produccin : https://secure.safetypay.com/Merchants/

Ingrese a la opcin: Perfil > Credenciales. Presione el botn Generar Nuevas Credenciales de WS para generar las llaves de acceso: API Key y

Signature Key.

Presionar Actualizar para registrar la nueva informacin. Copie estas llaves de acceso y regstrelos en los campos correspondientes API Key y Signature

Key de la seccin de configuracin del mdulo de pago en el rea de Administracin. Puede solicitar las Credenciales de Produccin en c ualquier momento. Recomendamos que notifique a su representante SafetyPay una vez que la integracin se haya completado para promover su sitio en la red de negocios SafetyPay.


Apndice B: Activar Servicio de Notificaciones

Ingrese al Sistema de Administracin 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 Electrnica. MMS Sandbox (Prueba) : https://secure.safetypay.com/sandbox/Merchants/ MMS Produccin : https://secure.safetypay.com/Merchants/ Ingrese a la opcin: Perfil > Notificaciones. Defina y active las dos formas de notificacin:

1. Correo Electrnico , actualice este campo con una cuenta de correo electrnico para enviarle un correo de Notificacin de Pago SAFETYPAY.

2. POST URL, actualice este campo con el valor de una Direccin Web (URL) del script que permita a su sistema recibir Notificaciones de Pago Automtica.

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 Automticas de SafetyPay apenas un comprador confirme el pago de una transaccin. La notificacin consta de dos tareas: la primera, actualizar el estado de una determinada Orden de Pendiente a Completado; segundo, envia automticamente un correo electrnico Confirmando el Pago de la Orden al comprador y tercero, Confirma a SafetyPay el Nmero de Despacho o Pedido para futuras referencias. Para activar el servicio de notificacin, deber marcar las opciones: Notificacin por Post y/o Notificacin por Email.


RECURSOS

1. SafetyPay Demo Store. Tienda virtual demostrativa integrada con la modalidad SAFETYPAY API como mtodo de pago. Comunicacin al SAFETYPAY WebService v.2.2 bajo plataforma Sandbox (Prueba). Desde aqu podr generar Transacciones SAFETYPAY.

http://demostore.safetypay.com/api/

2. Banca Electrnica Demo. Simula un Sistema de Banca en Lnea 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 disposicin 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/

instalación y configuración del módulo de pago joomla...

Documents