Manual de Integración. Neopago. Versión

Transcripción

1 Manual de Integración Manual de Integración Versión

2 Manual de Integración Acerca de este manual Nuestra herramienta de venta debe ser integrada de la siguiente forma: Generando el código HTML a través de la opción de menú Botones de Pago que poseen los usuarios Comercio. Este botón de pago se instala en el sitio web del vendedor, al finalizar la compra este envía los datos de la transacción a para su procesamiento. En este manual se explica cómo generar el código HTML para integrar las siguientes herramientas configurando los valores y las variables involucradas en el proceso de pago: Botón de pago Carrito de compras Link seguro Integración Estándar Botón de pago Flujo de Compra El flujo de compra del botón de pago es el siguiente: 1. El comprador selecciona el producto que desea y hace clic en el botón Comprar ubicado en el sitio del vendedor.

3 Manual de Integración 2. El comprador es redirigido al proceso de compra (checkout) del sitio web del vendedor. Selecciona a como medio de pago. 2.1 Según el tipo de carrito y su programación podrá aparecer la siguiente imagen o irá directo a la página de. En el ejemplo en particular anexo el usuario deberá hacer clic en el botón, esto nos llevara a la página de acceso y pago del sistema, como veremos en el punto 3.

4 Manual de Integración 3. Al hacer clic sobre el botón de pago de será redirigido al sitio web de. Allí el comprador deberá colocar su correo electrónico y su clave para el inicio de sesión en. 4. Si el inicio de sesión es correcto, se desplegarán todos los datos de la compra.

5 Manual de Integración 5. Si todos los datos de la operación concuerdan y el monto disponible del cliente es suficiente, va contra el proceso de validación IPN (Instant Process Notification ). En caso de que la operación sea exitosa el sitio es redirigido a la página de éxito configurada en el botón de pago. Si la operación es rechazada el sitio es redirigido a la página de fracaso configurada en el botón e pago. 6. Cuando una operación finaliza exitosamente NEOPAGO devuelve en formato POST los siguientes elementos:

6 Manual de Integración Variable Valor Descripción totalpago Total pago hecho por el cliente estatusoperacion 1- Correcto 0- Incorrecto Estatus de la operación numeroconfirmacion idcompra mediopago cliente rif ciudad estado direccion correo SN- Saldo TC- Tarjeta de Crédito TV-Tarjeta Virtual Número de transacción Número transacción del sitio web del vendedor Medio de pago utilizado Nombre del Cliente RIF/Cédula del Cliente Ciudad del Cliente Estado del cliente Dirección del cliente Correo Electrónico del cliente Ejemplo de código del botón de pago El Botón de Pago redirige siempre al usuario a la página compras de para completar el flujo de compra, por lo que los datos deben enviarse a la URL: El ejemplo a continuación incluye todas las variables que el checkout de espera recibir para realizar una operación. Estas variables son parámetros string para ser transmitidos por método POST.

7 Manual de Integración ANEXO 1 <? //La llave es propia por cada usuario $llave=' '; //Algortimo de encriptamiento para los parametros id_compra y monto $iv = mcrypt_create_iv(mcrypt_get_iv_size(mcrypt_rijndael_256, MCRYPT_MODE_ECB), MCRYPT_RAND); // $id_orden Es el id de la factura u orden de compra generado. Es introducido por el personal del sitio web del vendedor //$monto Es el monto total de la compra con impuesto, flete y cualquier adicional incluido. Es introducido por el personal del sitio web del vendedor cuando es variable. Si el botón de compra se definió para un solo producto con monto fijo no es necesario. $passcrypt = trim(mcrypt_encrypt(mcrypt_rijndael_256, $llave, trim($id_orden), MCRYPT_MODE_ECB, $iv)); $id_cifrado = base64_encode($passcrypt); $passcrypt = trim(mcrypt_encrypt(mcrypt_rijndael_256, $llave, trim($monto), MCRYPT_MODE_ECB, $iv)); $monto_cifrado = base64_encode($passcrypt);?> <form action=" method="post" target="_blank" > <input type="image" src=" border="0" name="submit" alt="neopago - la forma más segura de comprar"> <input name="id1" type="hidden" id="id1" value="cp8uklkpuk7zjnsoe3etf5lz"> <input name="id2" type="hidden" id="id2" value="cv8iwlkpuk4pe2ysl4i="> <input name="id3" type="hidden" id="id3" value="df/ajvkpuk6xga/wr9g="> <input name="id4" type="hidden" id="id4" value="d/9e6lkpuk6lejgxctu9vg=="> <input name="id5" type="hidden" id="id5" value="ev9m11kpuk7erx2gwjupw9evdmflfchastb1e7fkj5faerbujjb1u1k4hkj53ivkxoy7aur8g3rr W2x1IQ=="> <input name="id6" type="hidden" id="id6" value="f//gklkpuk4="> <input name="id7" type="hidden" id="id7" value="gp/s4vkpuk5pswroogukmscz0i1s91m7qszyssi9f0fvwdi8gxhbqx+eyyj9pk8lyfwlkcip11vfe TLFPg=="> <input name="id8" type="hidden" id="id8" value="hv/cglkpuk6e7/7wwvxpomydce1a1kdqprkssdtuvpvdvkmjl2qtk+imiy4qp3lq2dgokvmg+79 WPQiLmQ=="> <input name="id9" type="hidden" id="id9" value="<?=$id_cifrado;?>"> <input name="id10" type="hidden" id="id10" value="<?=$monto_cifrado;?>"> <input name="id11" type="hidden" id="id11" value="jp84mvkpuk7zenibtzpizcxju9dygfmz"> <input name="id12" type="hidden" id="id12" value="i/8eifkpuk4="> <input name="produc_list" type="hidden" id="produc_list" value=> </form>

8 Manual de Integración Las variables en AZUL son los UNICOS ELEMENTOS MODIFICABLES por el USUARIO TECNICO del sitio web del vendedor. Todas las variables disponibles para enviar y sus definiciones pueden encontrarse en el Anexo 2 de este manual. El conjunto total de variables puede utilizarse para personalizar el proceso de compra mediante la modificación de: El diseño de la página del checkout. Montos y descripciones de la compra Otras opciones avanzadas. Carrito de compras Para integrar la plataforma de pagos de a tu propio Carrito de compras deberás tener en cuenta que: - Se podrá pagar con sólo cuando se hayan agregado al carrito todos los productos que se quieran comprar. - Al momento de pagar, lo único importante es que los datos sean estandarizados de acuerdo al formato y dirección establecidos por en el código HTML. - En el módulo de finalización de la orden de compra deberá colocar el código del anexo 1, ya sea por include o colocando el código directamente en su página, teniendo en cuenta que deberá modificar los parámetros comentados anteriormente. El botón de pago del carrito de compras debe indefectiblemente: - Tomar toda la información cargada en el carrito. - Enviar los datos que correspondan para cada campo a la URL del checkout de : El checkout de espera recibir los siguientes parámetros por string, por método POST. DEFINICION DEL BOTON DE COMPRA EN LA PLATAFORMA DE NEOPAGO Para el usuario comercio está disponible definir su botón de pago particular adaptado a sus necesidades. Los valores que se deben llenar son los siguientes: Variable Valores Descripción Tipo de Carrito de Compras - Estandar - Facebook - Joomla - Oscommerce - Cubecart Plataforma donde se montará el botón de pago. El tipo estándar se usa cuando son carritos de compra propios. El resto servirá para carritos de compras comercializados en el mercado. Tipo de Botón - Producto - General Tipo de botón de pago que se genera. Si es para un único producto no será necesaria manipular ningún variable desde el sitio web del vendedor. Si se espera que el botón permita pagar compras de n productos debe seleccionarse General

9 Manual de Integración Código del Producto Monto del Producto Descripción del Producto Dirección URL del comercio Dirección URL de validación IPN Dirección URL de éxito Dirección URL de fracaso Lenguaje de programación - PHP - JSP - ASP -.NET Código del producto cuando el botón de pago se genere para un producto único de venta. Si el botón de pago se usara para n producto se deja en blanco. Monto del producto cuando el botón de pago se genere para un producto único de venta. Si el botón de pago se usara para n producto se deja en blanco. Descripción del producto cuando el botón de pago se genere para un producto único de venta. Si el botón de pago se usara para n producto se deja en blanco. Dirección web del comercio del vendedor Dirección de la pagina validador IPN (Instant Payment Notificatión ó NIP Notificación Instantánea de Pagos). Ejemplo: Dirección de la pagina de éxito luego de completada la transacción de compra. Ejemplo: Dirección de la pagina de fracaso luego de terminada la transacción de compra. Ejemplo: Lenguaje de programación en el que está desarrollado el sitio web del vendedor Todos los parámetros incluidos en el html del botón de pago de están fuertemente encriptados con algoritmos validados por personal certificado en plataformas de seguridad y viajan mediante SSL/TLS.

10 Manual de Integración ANEXO 2 TABLA EXPLICATIVA DE LOS PARAMETROS DEL BOTON DE COMPRAS NEOPAGO Todos los parámetros vendrán encriptados, los únicos que podrá manipular el personal de la tienda del vendedor son: id_compra, monto. El monto solo será manipulable cuando el carrito de compras contenga varios productos, en caso de que el carrito solo oferte un producto el monto se especificara en la definición del botón de pago. VARIABLE LONGITUD OBLIGATORIO VALORES DESCRIPCION ID1 15 SI Rif del Vendedor ID2 17 NO Monto del producto cuando el botón de pago se defina para un producto en particular. ID3 15 NO Código del producto cuando el botón de pago se defina para un producto en particular. ID4 80 NO Descripción del producto cuando el botón de pago se defina para un producto en particular. ID5 120 SI Dirección URL del comercio del vendedor. ID6 120 SI Dirección URL del archivo IPN de validación. ID7 120 SI Dirección URL cuando sea éxito la operación. ID8 120 SI Dirección URLcuando sea fracaso la operación. ID9 10 SI ID de factura generado en el sitio web del vendedor. ES UNO DE LOS ELEMENTOS MANIPULABLES POR EL TECNICO DEL SITIO WEB DEL VENDEDOR. ID10 17 NO Monto total de la venta. Solo se ajusta cuando el carrito de compras sea usado para pagar por más de un producto. ES UNO DE LOS ELEMENTOS MANIPULABLES POR EL TECNICO DEL SITIO WEB DEL VENDEDOR. ID11 20 SI Código del botón en. ID12 25 SI Tipo de plataforma donde se montara el botón: Facebook, Joomla, Cubecart, Oscommerce, Magento, Particular. Product_list 50 NO Listado de productos para la

11 Manual de Integración venta. Llevan como separador un carácter especial & Link Seguro Todo es sitio web de utiliza un certificado SSL de 256 bits para el seguro traspaso de la información. La llave usada para el encriptamiento de los parámetros id_compra y monto es UNICA por cada cliente comercio de.