Guía de integración del módulo de Iupay!en Magento Versión: 1.0 14/03/2014 Referencia RS.ED.IND.MAN.0036 Redsys · C/ Francisco Sancha, 12 · 28034 · Madrid · ESPAÑA Ref RS.ED.IND.MAN.0036 <USO EXTERNO RESTRINGIDO> Versión: 1.0 <USO EXTERNO RESTRINGIDO> 14/03/2014 i MAN. Las versiones impresas los documentos no garantizan ser la última versión aprobada. Queda prohibida su reproducción.ED.Guía de integración Iupay en Magento La propiedad intelectual de este documento pertenece a Redsys.0 Fecha Afecta Breve descripción del cambio Versión inicial Redsys · C/ Francisco Sancha. 12 · 28034 · Madrid · ESPAÑA Ref RS. Versión 1. venta.0036 Versión: 1.0 14/03/2014 ii . Para consultar la última versión acceder a la base de datos de Alejandría.IND. o cesión a terceros Autorizaciones y control de versión AUTOR: Redsys VALIDADO POR: APROBADO POR: EMPRESA: Redsys EMPRESA: Redsys EMPRESA: Redsys Firma: Firma: Firma: Fecha: 14/03/2014 Fecha: 14/03/2014 Fecha: 14/03/2014 Comentarios: La gestión de la documentación impresa es responsabilidad de la persona que la imprime. .......................IND........................................ 9 Redsys · C/ Francisco Sancha.............. Pasos a seguir ...............................................................0 14/03/2014 iii ......... o cesión a terceros ÍNDICE DE CONTENIDO 1........................ED........................................ Objetivo ..... Código generado .....MAN.............0036 Versión: 1.........Guía de integración Iupay en Magento La propiedad intelectual de este documento pertenece a Redsys........................ 2 4.................. 12 · 28034 · Madrid · ESPAÑA Ref RS.................... venta.. 1 3............... Software necesario ............ 6 5..... 1 2...... Queda prohibida su reproducción................................................. Final del proceso de pago ............................. 0.Guía de integración Iupay en Magento 1.0 14/03/2014 1 . 1.1 y 1.8.0.8.1 (Sistema de gestión de tiendas on-line). Software necesario Para poder realizar el seguimiento de esta guía es necesario tener instalado Magento versión 1.0. Objetivo En el presente documento se detalla el procedimiento básico para la integración del módulo de pago de IUPAY en la tienda on-line Magento versión 1.9.9. 2.8.ED.MAN.8. Redsys · C/ Francisco Sancha.1 y 1. 12 · 28034 · Madrid · ESPAÑA Ref RS.1. 1.0.0036 Versión: 1. Además deberemos tener descargado el módulo de pago de IUPAY para Magento.IND. (OPCIONAL) Debido a que no es imprescindible para el correcto funcionamiento del módulo. Por último se debe colocar el archivo “Excellenceiupay_Iupay. en el siguiente directorio del módulo de Magento: http://your_domain/magento/app/etc/module/Excellenceiupay_ Iupay.php. incluido en el módulo de pago de IUPAY. incluido en el módulo de pago de IUPAY. incluido en el módulo de pago de IUPAY.Guía de integración Iupay en Magento 3. en el directorio “local” del módulo de Magento(en caso de que no exista.MAN. Pasos a seguir Una vez instalado el sistema de Magento se deben seguir los siguientes pasos: 1. Estos valores se modificarán en el atributo “value” de los input de las líneas 150 y 151 del fichero Excellenceiupay/Iupay/controllers/IndexController.IND. se pueden modificar los valores de los parámetros correspondientes a la “Url_KO” y la “Url_OK”.ED.xml”.xml 4. 12 · 28034 · Madrid · ESPAÑA Ref RS. tal y como se muestra en la siguiente imagen: Redsys · C/ Francisco Sancha. en el siguiente directorio del módulo de Magento: http://your_domain/magento/app/design/frontend/default/default/ template 3. se debe crear): http://your_domain/magento/app/code/local/Excellenceiupay 2. A continuación se debe colocar el directorio “Template”. Se deben colocar los ficheros de la carpeta “Source”. Inicialmente se debe colocar el directorio “Excellenceiupay”. incluido en el módulo de pago de IUPAY.0036 Versión: 1. en el siguiente directorio del módulo de Magento: http://your_domain/magento/app/code/core/Mage/Adminhtml/ Model/System/Config/Source 5.0 14/03/2014 2 . En este punto ya está integrado el módulo de IUPAY. donde la opción “Parámetros en las URLs” debe tener el valor “SI”. se tiene que verificar la configuración del comercio en el módulo de administración de Redsys. es necesario borrar la cache del sistema de Magento para poder visualizar el nuevo módulo de Iupay.MAN. Marcada la opción de Pago con tarjeta – Iupay. Una vez situados en el sistema de administración. A estas se las denomina URL_OK y URL_KO. 7. sólo falta realizar la configuración del mismo en el sistema de administración de Magento. y una vez que se muestra al cliente la pantalla con el resultado del mismo. Se debe visualizar el apartado “Sales” del menú lateral de la parte izquierda y pulsar la pestaña “Payments Methods”. es posible redirigir su navegador a una URL para las transacciones autorizadas y a otra si la transacción ha sido denegada. respectivamente. 12 · 28034 · Madrid · ESPAÑA Ref RS. Esto se consigue eliminando todos los directorios (mage--0. se debe acceder a la pestaña “System” y marcar la opción “Configuration”. Se trata de dos URL que pueden ser proporcionadas por el comercio. En caso de no haber modificado la “Url_KO” y la “Url_OK” en el paso anterior.mage--1. Una vez establecidos los ficheros y directorios donde corresponde.0036 Versión: 1.0 14/03/2014 3 . 6. se obtiene un formulario de configuración tal y como se muestra en la siguiente imagen: Redsys · C/ Francisco Sancha.ED.…) contenidos en la siguiente ruta: http://your_domain/magento/var/cache 8.Guía de integración Iupay en Magento URL_OK/URL_KO: durante el proceso del pago.IND. 2.0036 Versión: 1. de integración. 5. 3. Número de terminal: Se indica el terminal del TPV. Tipo de transacción: (Normalmente “0”).Guía de integración Iupay en Magento Es necesario realizar la configuración de manera adecuada. 8.0 14/03/2014 4 . Una vez finalizada la configuración se debe guardar pulsando el botón “Save Config” de la cabecera que dispone Magento. Entorno de Redsys: Se selecciona el valor según corresponda si estamos en fase de pruebas. 12 · 28034 · Madrid · ESPAÑA Ref RS.IND. Se indica el tipo de transacción Redsys · C/ Francisco Sancha. en caso contrario. Tipo de moneda: Se selecciona la moneda de nuestro terminal TPV (Normalmente Euros).ED. 7. 4.MAN. Nombre del comercio: Se indica el nombre del comercio. etc. Número de comercio (FUC): Se indica el número de comercio que nuestra entidad nos ha comunicado. Clave secreta de encriptación: Se indica la clave de encriptación que tenemos. todos los pedidos realizados por los usuarios se procesarán con fallos. 6. Para configurar correctamente el módulo de IUPAY se presentan cada uno de los parámetros que intervienen: 1. Tipo de firma: Se selecciona Ampliada. 12. Recargo: Se indica si queremos aplicar un porcentaje de recargo al usuario por utilizar este método de pago.0036 Versión: 1. 12 · 28034 · Madrid · ESPAÑA Ref RS. Si no queremos aplicar recargo. 11. 10. Contenido del mensaje al cliente: Se indica el contenido del correo electrónico destinado al cliente en los pedidos procesados correctamente.Guía de integración Iupay en Magento 9.IND. Activar idiomas TPV: Se debe marcar como desactivada.MAN. Redsys · C/ Francisco Sancha. 15. Usar SSL: Se debe marcar como desactivada. Notificación HTTP: Se debe marcar como activada. En caso de error permitir otro medio de pago: Se debe marcar como activada. 13. su valor debe ser “0”.ED. Activar correo electrónico: Se indica si se desea enviar un correo electrónico al cliente en los pedidos procesados correctamente. 14.0 14/03/2014 5 . una vez se hayan realizado los puntos del anterior apartado (Apartado 3) de manera correcta.Guía de integración Iupay en Magento 4.ED. en el que se seleccionaría la opción de “Pago con tarjeta .MAN.es/sis/realizarPago" method="post" id="redsys_formulario” class="hidden"> <input type="hidden" name="Ds_Merchant_Amount" value="3877"/> <input type="hidden" name="Ds_Merchant_Currency" value="978" /> <input type="hidden" name="Ds_Merchant_Order" value="000000041525" /> <input type="hidden" name="Ds_Merchant_MerchantCode" value="9999" /> Redsys · C/ Francisco Sancha.0036 Versión: 1. En la siguiente imagen se muestra un ejemplo del paso 4 del proceso de un pedido (Payment Information). Esto permite trasladar al usuario al TPV-Virtual con los valores establecidos en un formulario oculto como el que se muestra a continuación: <form action="https://sis. se finaliza el pedido en el siguiente paso (Paso 5: Order Review) pulsando el botón “Place Order”.IND.0 14/03/2014 6 . 12 · 28034 · Madrid · ESPAÑA Ref RS. Código generado En este apartado se detalla el código que la tienda on-line de Magento presenta al usuario.Iupay”: Una vez seleccionada la opción de Iupay.redsys. php?clave=de82edc3&id_or der=41525" /> <input type="hidden" name="Ds_Merchant_UrlKO" value="http:// wooCommerce /pago_error.Guía de integración Iupay en Magento <input type="hidden" name="Ds_Merchant_Terminal" value="1" /> <input type="hidden" name="Ds_Merchant_TransactionType" value="0" /> <input type="hidden" name="Ds_Merchant_Titular" value="Javier GO" /> <input type="hidden" name="Ds_Merchant_MerchantName" value="Prueba" /> <input type="hidden" name="Ds_Merchant_ProductDescription" value="1 Leather Case (iPod nano) .Negro / Chocolate<br>" /> <input type="hidden" name="Ds_Merchant_UrlOK" value="http://wooCommerce/confirmation.0 14/03/2014 7 .IND. Redsys · C/ Francisco Sancha.php?clave=de82edc3&id_order=41525" /> <input type="hidden" name="Ds_Merchant_MerchantSignature" value="4BFE694DD0882D69F02C1E0F70C6ED722B9C3828" /> <input type="hidden" name="Ds_Merchant_ConsumerLanguage" value="0" /> <input type="hidden" name="Ds_Merchant_PayMethods" value="T" /> </form> Los valores de los elementos del formulario se establecen en dos fases: a) Fase de configuración del módulo de Iupay.MAN. 12 · 28034 · Madrid · ESPAÑA Ref RS. en el que se rellenan los campos que obedecen a: o Ds_Merchant_Currency o Ds_Merchant_MerchantCode o Ds_Merchant_Terminal o Ds_Merchant_TransactionType o Ds_Merchant_MerchantName o Ds_Merchant_UrlKO (Url destino en caso de no realizarse el pago con éxito) o Ds_Merchant_UrlOK (Url destino en caso de realizarse el pago con éxito) o Ds_Merchant_MerchantSignature o Ds_Merchant_ConsumerLanguage o Ds_Merchant_PayMethods o Entorno: Atributo “Action” del formulario.0036 Versión: 1.ED. en el que se rellenan los campos que obedecen a: o Ds_Merchant_Order (Nº de pedido) o Ds_Merchant_Amount (Total del pedido) o Ds_Merchant_Titular (Nombre del titular) o Ds_Merchant_ProductDescription Redsys · C/ Francisco Sancha.MAN.Guía de integración Iupay en Magento b) Fase de elaboración del pedido.0 14/03/2014 8 .IND.0036 Versión: 1. 12 · 28034 · Madrid · ESPAÑA Ref RS.ED. Por último y como requisito fundamental. Final del proceso de pago Para terminar con esta guía se hace referencia al final del proceso de pago en su tienda Magento.IND. Redsys · C/ Francisco Sancha.MAN. 2. 3. Esto se consulta en la sección “Order Totals” (Solicitar totales) de la información asociada a un pedido. Un pedido que se haya procesado correctamente quedará en estado “Processing”. como se muestra en la siguiente imagen: Como se puede observar en la imagen el “Total Due” (Total de deuda) debe ser cero. Dicha factura debe quedar con el estado “Pagado”. Un pedido que se haya procesado correctamente mostrará en su información asociada que ha quedado pagado. Por el contrario un pedido que se procese incorrectamente quedará como “Pending” (Si no se finaliza el proceso de pago) o “Canceled” (Si existe un fallo de autenticación). como muestra la siguiente imagen: El estado de facturas y pedidos se puede consultar en la pestaña “Sales” (Ventas) del módulo de administración de Magento. un pedido que se haya procesado correctamente debe generar una factura asociada a su identificador de pedido. 12 · 28034 · Madrid · ESPAÑA Ref RS.ED.Guía de integración Iupay en Magento 5. Para ello nos centraremos en los tres requisitos que debe cumplir un pedido para que se considere como correctamente procesado: 1.0036 Versión: 1.0 14/03/2014 9 .