Guía de integración del módulo de Redsys en Magento

Transcripción

1 Guía de integración del módul de Redsys en Magent Versión: /08/2015 Referencia RS.ED.IND.MAN.0035 Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 i

2 Guía de integración Redsys en Magent 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.2 Versión actualizada Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 ii

3 Guía de integración Redsys en Magent ÍNDICE DE CONTENIDO La prpiedad intelectual de este dcument pertenece a Redsys. Queda prhibida su reprducción, venta, cesión a tercers 1. Objetiv Sftware necesari Pass a seguir Códig generad Final del prces de pag... 9 Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 iii

4 Guía de integración Redsys en Magent 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 Magent versión y psterires. 2. Sftware necesari Para pder realizar el seguimient de esta guía es necesari tener instalad Magent versión psterir (Sistema de gestión de tiendas n-line). Además deberems tener descargad el módul de pag de REDSYS para Magent. Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 1

5 Guía de integración Redsys en Magent 3. Pass a seguir Una vez instalad el sistema de Magent se deben seguir ls siguientes pass: 1. Inicialmente se debe clcar el directri Excellenceredsys, incluid en el módul de pag de REDSYS, en el directri lcal del módul de Magent(en cas de que n exista, se debe crear): 2. A cntinuación se debe clcar el directri Template, incluid en el módul de pag de REDSYS, en el siguiente directri del módul de Magent: template 3. Se debe clcar el archiv Excellenceredsys_Redsys.xml, incluid en el módul de pag de REDSYS, en el siguiente directri del módul de Magent: _Redsys.xml 4. Se deben clcar ls fichers de la carpeta Surce, incluid en el módul de pag de REDSYS, en el siguiente directri del módul de Magent: Mdel/System/Cnfig/Surce 5. (OPCIONAL) Debid a 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 179 y 180 del ficher Excellenceredsys/Redsys/cntrllers/IndexCntrller.php, tal y cm se muestra en la siguiente imagen: Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 2

6 Guía de integración Redsys en Magent 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. 6. 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. 7. Una vez establecids ls fichers y directris dnde crrespnde, es necesari brrar la cache del sistema de Magent para pder visualizar el nuev módul de Redsys. Est se cnsigue eliminand tds ls directris (mage--0,mage--1, ) cntenids en la siguiente ruta: 8. En este punt ya está integrad el módul de REDSYS, sól falta realizar la cnfiguración del mism en el sistema de administración de Magent. Una vez situads en el sistema de administración, se debe acceder a la pestaña System y marcar la pción Cnfiguratin. Se debe visualizar el apartad Sales del menú lateral de la parte izquierda y pulsar la pestaña Payments Methds. Marcada la pción de Pag cn tarjeta Redsys, se btiene un frmulari de cnfiguración tal y cm se muestra en la siguiente imagen: Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 3

7 Guía de integración Redsys en Magent Es necesari realizar la cnfiguración de manera adecuada, en cas cntrari, tds ls pedids realizads pr ls usuaris se prcesarán cn falls. Una vez finalizada la cnfiguración se debe guardar pulsand el btón Save Cnfig de la cabecera que dispne Magent. Para cnfigurar crrectamente el módul de REDSYS se presentan cada un de ls parámetrs que intervienen: 1. Entrn de Redsys: Se seleccina el valr según crrespnda si estams en fase de pruebas, de integración, etc. 2. Nmbre del cmerci: Se indica el nmbre del cmerci. 3. Númer de cmerci (FUC): Se indica el númer de cmerci que nuestra entidad ns ha cmunicad. 4. 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. 5. Clave secreta de encriptación: Se indica la clave de encriptación que tenems. 6. Númer de terminal: Se indica el terminal del TPV. 7. Tip de firma: Se seleccina Ampliada. Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 4

8 Guía de integración Redsys en Magent 8. Tip de mneda: Se seleccina la mneda de nuestr terminal TPV (Nrmalmente Eurs). 9. Tip de transacción: Se indica el tip de transacción (Nrmalmente 0 ). 10. Ntificación HTTP: Se debe marcar cm activada. 11. Usar SSL: Se debe marcar cm desactivada. 12. En cas de errr permitir tr medi de pag: Se debe marcar cm activada. 13. Activar idimas TPV: Se debe marcar cm desactivada. 14. Activar crre electrónic: Se indica si se desea enviar un crre electrónic al cliente en ls pedids prcesads crrectamente. 15. Cntenid del mensaje al cliente: Se indica el cntenid del crre electrónic destinad al cliente en ls pedids prcesads crrectamente. Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 5

9 Guía de integración Redsys en Magent 4. Códig generad En este apartad se detalla el códig que la tienda n-line de Magent presenta al usuari, una vez se hayan realizad ls punts del anterir apartad (Apartad 3) de manera crrecta. En la siguiente imagen se muestra un ejempl del pas 4 del prces de un pedid (Payment Infrmatin), en el que se seleccinaría la pción de Pag cn tarjeta - Redsys : Una vez seleccinada la pción de Redsys, se finaliza el pedid en el siguiente pas (Pas 5: Order Review) pulsand el btón Place Order. Est permite trasladar al usuari al TPV-Virtual cn ls valres establecids en un frmulari cult cm el que se muestra a cntinuación: <frm actin=" methd="pst" id="redsys_frmulari class="hidden"> <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=" " /> <input type="hidden" name="ds_merchant_merchantcde" value="9999" /> <input type="hidden" name="ds_merchant_terminal" value="1" /> Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 6

10 Guía de integración Redsys en Magent </frm> <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=" der=41525" /> <input type="hidden" name="ds_merchant_urlko" value=" 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" /> 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. Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 7

11 Guía de integración Redsys en Magent 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, Madrid ESPAÑA Versión: 2.2 8

12 Guía de integración Redsys en Magent 5. Final del prces de pag Para terminar cn esta guía se hace referencia al final del prces de pag en su tienda Magent. Para ell ns centrarems en ls tres requisits que debe cumplir un pedid para que se cnsidere cm crrectamente prcesad: 1. Un pedid que se haya prcesad crrectamente quedará en estad Prcessing. Pr el cntrari un pedid que se prcese incrrectamente quedará cm Pending (Si n se finaliza el prces de pag) Canceled (Si existe un fall de autenticación). 2. Un pedid que se haya prcesad crrectamente mstrará en su infrmación asciada que ha quedad pagad. Est se cnsulta en la sección Order Ttals (Slicitar ttales) de la infrmación asciada a un pedid, cm se muestra en la siguiente imagen: Cm se puede bservar en la imagen el Ttal Due (Ttal de deuda) debe ser cer. 3. Pr últim y cm requisit fundamental, un pedid que se haya prcesad crrectamente debe generar una factura asciada a su identificadr de pedid. Dicha factura debe quedar cn el estad Pagad, cm muestra la siguiente imagen: El estad de facturas y pedids se puede cnsultar en la pestaña Sales (Ventas) del módul de administración de Magent. Redsys C/ Francisc Sancha, Madrid ESPAÑA Versión: 2.2 9