Guía de integración del módul de Redsys en WCmmerce Versión: 2.6 25/08/2015 Referencia RS.ED.IND.MAN.0033 Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 i
Guía de integración Redsys en WCmmerce Autrizacines y cntrl de versión La prpiedad intelectual de este dcument pertenece a Redsys. Queda prhibida su reprducción, venta, cesión a tercers AUTOR: Redsys VALIDADO POR: APROBADO POR: EMPRESA: Redsys EMPRESA: Redsys EMPRESA: Redsys Firma: Firma: Firma: Fecha: 25/08/2015 Fecha: 25/08/2015 Fecha: 25/08/2015 Cmentaris: Versión Fecha Afecta Breve descripción del cambi 1.0 Versión inicial 2.6 Versión actualizada Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 ii
Guía de integración Redsys en WCmmerce ÍNDICE DE CONTENIDO La prpiedad intelectual de este dcument pertenece a Redsys. Queda prhibida su reprducción, venta, cesión a tercers 1. Objetiv... 1 2. Sftware necesari... 1 3. Pass a seguir... 2 4. Códig generad... 6 5. Lgs... 9 Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 iii
Guía de integración Redsys en WCmmerce 1. Objetiv En el presente dcument se detalla el prcedimient básic para la integración del módul de pag de REDSYS en la tienda n-line WCmmerce. 2. Sftware necesari Para pder realizar el seguimient de esta guía es necesari tener instalad ls siguientes móduls: 1. WrdPress versión 3.8.1 superir: Sistema de gestión de cntenid. 2. WCmmerce versión 2.1.3 superir: Plug-in para la gestión de tiendas n-line en WrdPress. Además deberems tener descargad el módul de pag de REDSYS para WCmmerce. Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 1
Guía de integración Redsys en WCmmerce 3. Pass a seguir Una vez instalad el sistema de WrdPress y el plug-in WCmmerce se deben seguir ls siguientes pass: 1. Inicialmente se debe clcar el módul de pag de REDSYS en el siguiente directri dentr del módul de WrdPress: http://yur_dmain/wrdpress/wp-cntent/plugins/redsys 2. A cntinuación se debe acceder a la administración de WrdPress y situarse en la pción Plugins. En esta pción ya debe aparecer el plugin de Redsys, pr l que tan sl faltaría activarl desde el enlace que aparece en la descripción del plugin, tal y cm aparece en la siguiente imagen: Una vez activad, el plugin del módul de REDSYS habrá finalizad su instalación y será recncid pr el sistema de WCmmerce. Para cmprbar que la instalación es crrecta, basta cn acceder al sistema de administración de WrdPress y situarse en la pción WCmmerce. Desde esta pción, se debe acceder a su vez a la pción Settings y en ella a la pestaña Checkut. En esta pestaña se realiza un barrid de las pasarelas de pag dispnibles (gateways), y entre las pcines dispnibles debe aparecer la pción de Pag cn Tarjeta (REDSYS), tal y cm se muestra en la siguiente imagen: Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 2
Guía de integración Redsys en WCmmerce 3. (OPCIONAL) Pr últim y de carácter pcinal, ya que n es imprescindible para el crrect funcinamient del módul, se pueden mdificar ls valres de ls parámetrs crrespndientes a la Url_KO y la Url_OK. Ests valres se mdificarán en el atribut value de ls input de las líneas 334 y 335 del ficher /redsys/class-wc-redsys.php, tal y cm se muestra en la siguiente imagen: URL_OK/URL_KO: durante el prces del pag, y una vez que se muestra al cliente la pantalla cn el resultad del mism, es psible redirigir su navegadr a una URL para las transaccines autrizadas y a tra si la transacción ha sid denegada. A estas se las denmina URL_OK y URL_KO, respectivamente. Se trata de ds URL que pueden ser prprcinadas pr el cmerci. 4. En cas de n haber mdificad la Url_KO y la Url_OK en el pas anterir, se tiene que verificar la cnfiguración del cmerci en el módul de administración de Redsys, dnde la pción Parámetrs en las URLs debe tener el valr SI. 5. En este punt ya está integrad el módul de REDSYS, sól falta realizar la cnfiguración del mism. Est se cnsigue pulsand sbre el enlace que se presenta en la pestaña Checkut de la que se habló cn anteriridad, tal y cm muestra la siguiente imagen: Una vez pulsad el enlace anterir, se presenta al usuari un frmulari para realizar la cnfiguración del módul. A cntinuación se presenta una imagen de este frmulari y una descripción de tds ls elements que l cmpnen. Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 3
Guía de integración Redsys en WCmmerce 1. Títul: Se seleccina el nmbre cn el que el cliente identificará nuestr módul una vez realizad un pedid. 2. Descripción: Se seleccina la descripción cn la que el cliente identificará nuestr módul una vez realizad un pedid. 3. Entrn de Redsys: Se seleccina el valr según crrespnda si estams en fase de pruebas, de integración, etc. 4. Nmbre del cmerci: Se indica el nmbre del cmerci. Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 4
Guía de integración Redsys en WCmmerce 5. Númer de cmerci (FUC): Se indica el númer de cmerci que nuestra entidad ns ha cmunicad. 6. Tips de pag permitids: Se indican ls métds de pag que querems que se presenten al cliente. Cabe destacar que para que el cliente puede pagar a través de Iupay, el cmerci debe tener activad el servici de pag cn Iupay. 7. Clave secreta de encriptación: Se indica la clave de encriptación que tenems. 8. Númer de terminal: Se indica el terminal del TPV. 9. Tip de firma: Se seleccina Ampliada. 10. Tip de mneda: Se seleccina la mneda de nuestr terminal TPV (Nrmalmente Eurs). 11. Tip de transacción: Se indica el tip de transacción (Nrmalmente 0 ). 12. Activar idimas: Se debe marcar cm desactivada. Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 5
Guía de integración Redsys en WCmmerce 4. Códig generad En este apartad se detalla el códig que la tienda n-line de WCmmerce presenta al usuari, una vez se hayan realizad ls pass del anterir apartad (Apartad 3) de manera crrecta. En la siguiente imagen se muestra un ejempl de pedid de un usuari al cual, una vez seleccinad la pción de pag de REDSYS se le mstrará el siguiente resultad: Una vez accedid a la pción de pag cn tarjeta de Redsys, se presenta al usuari la pción de acces al TPV-Virtual para intrducir ls dats de su tarjeta de crédit, en cas de n querer cntinuar cn el pedid, la pción de cancelar su pedid, tal y cm se muestra a cntinuación: Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 6
Guía de integración Redsys en WCmmerce En cas de que el usuari acceda al sistema mediante el enlace de Pagar cn Tarjeta de Crédit, se le envía al TPV cn ls valres establecids en un frmulari cult cm el que se muestra a cntinuación: <frm actin="https://sis.redsys.es/sis/realizarpag" methd="pst" id="redsys_frmulari class="hidden"> </frm> <input type="hidden" name="ds_merchant_amunt" 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_merchantcde" value="9999" /> <input type="hidden" name="ds_merchant_terminal" value="1" /> <input type="hidden" name="ds_merchant_transactintype" 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_prductdescriptin" value="1 Leather Case (ipd nan) - Negr / Chclate<br>" /> <input type="hidden" name="ds_merchant_urlok" value="http://wcmmerce/cnfirmatin.php?clave=de82edc3&id_rder=41 525" /> <input type="hidden" name="ds_merchant_urlko" value="http:// wcmmerce /pag_errr.php?clave=de82edc3&id_rder=41525" /> <input type="hidden" name="ds_merchant_merchantsignature" value="4bfe694dd0882d69f02c1e0f70c6ed722b9c3828" /> <input type="hidden" name="ds_merchant_cnsumerlanguage" value="0" /> <input type="hidden" name="ds_merchant_paymethds" value="t" /> Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 7
Guía de integración Redsys en WCmmerce Ls valres de ls elements del frmulari se establecen en ds fases: a) Fase de cnfiguración del módul de Redsys, en el que se rellenan ls camps que bedecen a: Ds_Merchant_Currency Ds_Merchant_MerchantCde Ds_Merchant_Terminal Ds_Merchant_TransactinType Ds_Merchant_MerchantName Ds_Merchant_UrlKO (Url destin en cas de n realizarse el pag cn éxit) Ds_Merchant_UrlOK (Url destin en cas de realizarse el pag cn éxit) Ds_Merchant_MerchantSignature Ds_Merchant_CnsumerLanguage Ds_Merchant_PayMethds Entrn: Atribut Actin del frmulari. b) Fase de elabración del pedid, en el que se rellenan ls camps que bedecen a: Ds_Merchant_Order (Nº de pedid) Ds_Merchant_Amunt (Ttal del pedid) Ds_Merchant_Titular (Nmbre del titular) Ds_Merchant_PrductDescriptin Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 8
Guía de integración Redsys en WCmmerce 5. Lgs El módul de REDSYS genera un ficher cn la actividad realizada mediante el módul de pag. Dich ficher se encuentra en la siguiente ruta: http://yur_dmain/wrdpress/wp-cntent/uplads/wclgs/redsys-xxx.txt Redsys C/ Francisc Sancha, 12 28034 Madrid ESPAÑA Versión: 2.6 9