Pasarela Ecommerce. Arquitectura del Sistema

Transcripción

1 Pasarela Ecommerce Puede hacer uso de nuestra tienda virtual ( Pasarela Ecommerce ) a partir de cualquier plan de Alojamiento. Nuestra tienda virtual ya le proporciona acceso al pago con tarjeta (TPV virtual) y además, no necesitaría un certificado de seguridad para su dominio, ya que las transacciones se realizan de forma segura a través de nuestra pasarela, que se encuentra fuera del espacio en disco de su dominio. Arquitectura del Sistema Este es el esqueleto básico sobre el que se basa el sistema de ecommerce de iddover-hosting

2 (PCR001) Envio del formulario, flujo Cliente -> Pasarela El flujo de la aplicación es el siguiente. A través de un formulario en formato POST se va a recoger toda a información que la Pasarela Ecommerce va a necesitar. Este formulario puede ser rellenado a mano por el afiliado (en el caso de cobros directos) o puede ser generado por la aplicación PHP del Servidor del afiliado (en el caso que se requiera). El tener un lenguaje de programación instalado en el servidor del afiliado hará posible la comprobación de cobros automática y su posterior verificación automática, teniendo asi un sistema seguro que autónomamente se encargue de gestionar y administrar toda la información relativa al cobro sin intervención humana. Una vez se disponga de toda la información para proceder a la gestión del cobro la Pasarela Ecommerce se va a encargar de almacenar y vincular inequívocamente esta información al cliente. Quedará por lo tanto almacenada (finalice o no el pago satisfactoriamente) el la base de datos para el posterior análisis o gestión de estadística. Ver ANEXO II y III para conocer el formato del formulario POST y ver un ejemplo de código para incluir en su web. A continuación se redimirá al cliente al siguiente paso para realizar el pago, dependiendo si se han seleccionado varios o un método de pago se redirigirá al cliente a la página de selección de método de pago (PRC200) o a la de explicación del pago respectivamente (PRC300).

3 Paginas que participan: pay-pasarela.htm PRE BODY POST Check de payreferer, si no existe PRC001 Check de la firma, si firma incorrecta PRC003 Check del payorder, si payorder ya procesado PRC002 Crea y almacena el pedido bajo la referencia orderid = payorde r Si paytype contiene un diversos métodos de pago, el cliente es redirigido a paymethod.htm (PRC200) Si paytype contiene un único valor, se redirige al cliente a pay-form.htm, inticando el método de pago como parámetro el type (PRC300) Posibles errores: PRC001 PRC002 PRC003 Error en el envío de parámetros. El código payreferer no se corresponde con ningún cliente Pedido Duplicado. El código del pedido payorder ya se ha procesado con anterioridad Firma Incorrecta Este error se produce si la verificación de la firma no resulta satisfactoria.

4 (PCR200) Selección del Método de Pago Esta página mostrará las opciones de pago que se has permitido en paymethod al cliente, para que éste puede escoger la que mas se ajuste a sus necesidades. Una vez que el cliente haya seleccionado el método de pago (pulsando sobre los iconos) será redirigido a la página de información sobre el método de pago (PRC300) --- pay-method.htm PRE Trata de recoger la información del pedido a través del orderid, de lo contrario PRC004 $order contiene toda la información relativa al pedido que identificamos con orderid POST Se redirige al cliente a pay-form.htm, inticando el método de pago como parámetro el type (PRC300) que el cliente ha seleccionado

5 (PCR300) Información sobre el Método de Pago El cliente visiona una página intermedia entre la Pasarela Ecommerce y el método de pago seleccionado. Ésta página muestra la información relativa al tipo de pago que va realizar. --- pay-form.htm PRE Trata de recoger la información del pedido a través del orderid, de lo contrario PRC004 $order contiene toda la información relativa al pedido que identificamos con orderid Para los tipos de pago que la Pasarela Ecommerce maneja internamente (transferencia y contra reembolso) POST Se genera y almacena una transferencia en $transfer para e pedido que está en curso Se activa el proceso de Envio de notificaciones (PRC100) Se redirige al usuario a la página de Confirmación del pedido pay-wait.htm a la que se le pasan los parámetros de orderid y type (PRC500)

6 (PRC400) Comunicación con las Entidades Procesadoras de Pago El siguiente esquema muestra los flujos de Comunicaciones que se producen para la comunicación con otras Entidades Procesadoras de Pago

7 La comunicación con las entidades que procesarán el pago y son del tipo estándar se describe con los siguientes acciones: 1. Notificación al la Entidad de Procesamiento del Pago (pay-process-xxxxx.htm) Se recoge la información relativa al pedido y se traduce para que la entidad a través de la que se procesará el pago (la caixa, TPV, Micropagos,...) pueda procesar correctamente y de forma segura el pago. Si no se ha producido ningún error se procede al envío del formulario en formato POST a la Entidad de Proceso del Pago. 2. Gestión de las Notificaciones (pay-notif-xxxxx.htm) La Pasarela Ecommerce gestiona automáticamente las notificaciones internas de las Entidades de Proceso de Pago teniendo en Cuenta los Siguientes Puntos: - El Comercio Afiliado recibirá una única notificación de la Pasarela Ecommerce en el formato Estándar descrito en el Envio de Notificaciones PRC Confirmación del Pedido (pay-wait.htm) La Pasarela Ecommerce se encarga de la gestión de la Confirmación del Pedido tal y como se describe en PRC500

8 (PRC100) Envío de Notificaciones, flujo Pasarela > Cliente Los flujos de las notificaciones de la pasarela ecommerce de iddover son los siguientes: Una vez se ha verificado que el pago se ha realizado satisfactoriamente o está en curso (en el caso de las transacciones o pedidos contra reembolso) la pasarela ecommerce siempre realiza las siguientes acciones: 4. Notificación al Servidor Cliente PHP (si se requiere) En el caso en que el parámetro paymerchanturl con una dirección web válida se realizará una petición en formato POST a tal indicando los siguientes parametros Verificación: Tipo estándar, con los parámetros siguientes. payorder = Número del Pedido payamount = Cantidad Total del Pago paycurrency = Tipo Moneda (897 EURO) paytype = Tipo de Pago seleccionedo (paypal, tpv, transacción, ) payresponse = Resultado de la operación paytime = Hora en que el pago se ha efectuado payreferer = Web para la que se ha realizado el pago paysignature = Firma DSA En caso de ERROR: PRC101 : Imposible realizar la notificación con el afiliado ( Administrador)

9 (PRC500) Confirmación del pedido Esta página es mostrada al cliente en el momento que la Pasarela Ecommerce ha confirmado el pago con las Entidades Procesadores de Pago (paypal, sms, bancos,...) pay-waiit.htm Contiene una factura preforma con el detalle de la factura y con un formato imprimible para el usuario. Adremás contiene la información sobre el pago y la información de cómo realizar el pago (si es preciso). Se muestran dos botones, uno para regresar a la tienda del Comercio Afiliado y otro para realizar la Impresión del pedido. Para los pagos tipo transferencia o contra reembolso está comprobación no se realiza y el cliente accede directamente a esta página tras haber conformado el pago

10 ANEXO 1 Ejemplo de formulario <html><body><form name=frmtransfer action= method=post style='border:0; padding: 0; margin: 0;'> <input type=hidden name=payreferer value='favshare.com'> <input type=hidden name=paymerchantname value='favshare'> <input type=hidden name=paylanguage value='es'> <input type=hidden name=payorder value=' aa2cd'> <input type=hidden name=payamount value=' '> <input type=hidden name=paycurrency value='978'> <input type=hidden name=paytype[] value='transfer'> <input type=hidden name=paytype[] value='paypal'> <input type=hidden name=paymerchanturl value='/shop/pay-notif.php'> <input type=hidden name=paymerchanturlok value=' <input type=hidden name=paymerchanturlkao value=' <input type=hidden name=payproductref[] value='suscripción Anual'> <input type=hidden name=payproductamount[] value=' '> <input type=hidden name=payproductqty[] value='1'> <input type=hidden name=payclientname value='aitor Garcia'> <input type=hidden name=payclient value='paypal@favshare.com'> <input type=hidden name=paysignature value='8b d5bdaf06d47af d57e447c1be'> <input type=hidden name=payclientname value='aitor Garcia'> <input type=hidden name=payclient value='paypal@favshare.com'> <input type=hidden name=payclientcif value=' w'> <input type=hidden name=payclientphone value=' '> <input type=hidden name=paybillingname value='aitor Garcia'> <input type=hidden name=paybillingphone value=' '> <input type=hidden name=paybillingaddress value='passatge Alcover, 1'> <input type=hidden name=paybillingcity value='barcelona'> <input type=hidden name=paybillingzipcode value='08720'></form></body></html>

11 ANEXO II Parámetros POST paymerchantname Nombre de Tienda/Afiliado a mostrar en la Pasarela Ecommerce paylanguage Selección del idioma (es, cat,...) payshipping Costes de Envio payreimbursement Costes de Reembolso payamount Coste Total = CS + CR + SP paycurrency Código de la moneda (978 = Euro) payorder Identificador edl Pedido paymerchanturl URL para la confirmación (Aplicaciones PHP) paymerchanturlok URL posterior a compra finalizada con éxito paymerchanturlkao; URL posterior a compra incompleta payreferer; Web del afiliaado paysignature; Firma SHA-1 Información del Cliente payclientname; payclientcif; payclientphone; payclientaddress; payclientcity; payclientzipcode; Información de Facturación payshippingname; payshippingphone; payshippingaddress; payshippingcity; payshippingzipcode; Sin Uso Posible ampliacion payshippingname; payshippingphone; payshippingaddress; payshippingcity; payshippingzipcode; Están marcados en amarillo los requisitos fiscales en españa

12 ANEXO III Codigos de Error PRC001 PRC002 PRC003 PRC004 Error en el envoi de parametros. El códifo payreferer no se corresponde con ningún cliente Pedido Duplicado. El código del pedidpo payorder ya se ha procesado con anterioridad Firma Incorrecta Este error se produce si la verificación de la firma no resulta satisfactoria. Pedido Perdido. No ha sido posible identificar el pedido que está realizando