• Author / Uploaded
• Juan Manuel H

• Categories
• Contraseña
• Visa Inc.
• Correo electrónico
• Localizador Uniforme de Recursos
• Autenticación

Citation preview

Guía de Bienvenida Hosted Payment Page e-Comm

INDICE Contenido Descripción del Producto Flujo de la transacción Comenzar la integración de Hosted Payment Page “Integración Básica” Campos Obligatorios Comenzar la integración de Hosted Payment Page “Integración Regreso a URL” Reporting API Descripción del Producto La integración de Hosted Payment Page le permite recibir pagos a través de una página web segura que cumple con certificación PCI. Con este modelo de integración, nunca se ve ni se administran los detalles del pago directamente, porque dichos detalles se ingresan en la página de pago segura de Banamex Hosted Payment Page se puede implementar a través de:  

Light box: Un cuadro de diálogo sobre el sitio del negocio Hosted Payment Page: Página de pago de Banamex.

El negocio deberá elegir cuál de estas dos vistas quiere utilizar al momento de que el tarjetahabiente realice el pago. A continuación podrá encontrar ejemplo de las pantallas de cada una de estas vistas: Light box

Hosted Payment Page

Existen dos tipos de integración para Hosted Payment Page:

Flujo de la transacción Integración Básica

1. El tarjetahabiente ingresa al sitio del negocio y da click en Pagar. 2. Se redirecciona al tarjetahabiente al sitio seguro de Banamex en donde ingresará los datos de la tarjeta para realizar la compra. Ésta página puede tener un nivel básico de personalización. 3. El tarjetahabiente se redirecciona al sitio seguro de autenticación de Visa (Verified by Visa) o MasterCard (MasterCard Secure Code) en donde se le pedirán algunos datos de confirmación elegidos por cada emisor para identificar al tarjetahabiente. 4. Una vez realizado el pago Banamex mostrará el resultado de la transacción (Recibo), en la página segura de Banamex. NOTA: para obtener status de la respuesta de la transacción, se deben configurar “Notificaciones” o ingresar al “Merchant Administrator” Integración “Regreso a URL”

1. El tarjetahabiente ingresa al sitio del negocio y da click en pagar 2. Se redirecciona al tarjetahabiente al sitio seguro de Banamex en donde ingresará los datos de la tarjeta para realizar la compra. Ésta página puede tener un nivel básico de personalización. 3. El tarjetahabiente se redirecciona al sitio seguro de autenticación de Visa (Verified by Visa) o MasterCard (MasterCard Secure Code) en donde se le pedirán algunos datos de confirmación elegidos por cada emisor para identificar al tarjetahabiente. 4. Una vez realizado el pago, el tarjetahabiente regresará a la página del negocio en donde éste último mostrará el resultado de la transacción (Recibo).

Comenzar la integración de Hosted Payment Page “Integración Básica” Para comenzar la integración usted deberá ingresar a la siguiente liga: https://secure.na.tnspayments.com/api/documentation/integrationGuide lines/hostedPaymentPage/integrationModelHostedCheckout.html en donde encontrará la documentación de Hosted Checkout Le aparecerá la siguiente página en donde usted podrá ver los pasos para la integración

Para realizar esta integración debe seguir los siguientes 3 pasos:

1. Consulte el archivo checkout.js en los servidores del gateway. 2. Llame al método Checkout.configure(), usando un objeto JSON con las especificaciones de pago, configuración de interfaz e interacción del usuario. 3. Inicie el proceso de pago llamando a uno de los siguientes métodos: 

Para mostrar las páginas de interacción con el tarjetahabiente de Lightbox: o Checkout.showLightbox()



Para mostrar las páginas de interacción con el tarjetahabiente de Hosted Payment Page: o Checkout.showPaymentPage()

Para la integración más sencilla puede incluir solamente los “campos obligatorios” los cuales se presentan en el siguiente ejemplo, teniendo cuidado de modificar los campos resaltados en amarillo con la información relativa a su negocio: html>



...

...

Deberá dejar los campos marcados en gris si quiere utilizar las páginas de interacción con el tarjetahabiente de Lightbox y deberá quitar el campo resaltado en rojo.

En caso que quiera utilizar las páginas de interacción con el tarjetahabiente de Hosted Payment Page deberá utilizar el campo marcado en gris y quitar el marcado en rojo

Para cambiar el nombre del botón que aparecerá en la página únicamente deberá reemplazar "Pay with Lightbox" o "Pay with Payment Page". Por ejemplo:



Descripción Campos Obligatorios 

merchant: Es su número de afiliación.



amount: El monto total del pedido, que se muestra al tarjetahabiente en la página de pago. Si usted agrega cualquier línea de detalles del artículo o alguno de los montos del subtotal (order.itemAmount, order.shippingAndHandlingAmount) además de order.amount, entonces el total del pedido debe ser igual a la suma de esos valores. o Este campo debe conformarse por números del 0-9 y “.” y representar un número decimal válido. o Debe ser un número mayor a 0 o La longitud del campo debe ser mayor o igual a 1 pero menor o igual a 14.



currency: La moneda que el tarjetahabiente eligió para el pago, que debe expresarse en el código alfa ISO 4217 ej. USD, MXN. o Este campo es de texto deben ser mayúsculas A-Z o La longitud del campo debe ser igual a 3



description: Es una descripción corta del contenido del pedido que se muestra al tarjetahabiente en la página de pago. o Puede contener cualquier tipo de caracteres o La longitud del campo debe ser mayor o igual a 1 pero menor o igual a 127



Id: Número de identificación de la transacción: o order.id: Un identificador único para distinguir las órdenes creadas. Este valor debe ser único para cada orden. Es un valor opcional.

o Puede contener cualquier tipo de carácter. o



La longitud del campo debe ser mayor o igual a 1 pero menor o igual a 40

Merchant name: El nombre de su negocio que se mostrará al tarjetahabiente en la página de pago. o Puede contener cualquier tipo de carácter o La longitud del campo debe ser mayor o igual a 0 pero menor o igual a 40



Merchant address: Dirección del negocio

Usted podrá elegir si quiere solicitar o no la información de facturación al tarjetahabiente al momento de realizar el pago y podrá elegir entre los campos de la siguiente URL para personalizar la página de pago: https://secure.na.tnspayments.com/api/documentation/apiDocumentati on/checkout/version/latest/function/configure.html? locale=en_US#x_request_interaction Para mayor personalización de la página de pago, en la que el negocio podrá agregar el logo (únicamente aparecerá en la integración que muestra la página de pago de Hosted Payment Page, Lightbox no muestra logo), dirección del negocio, etc. El negocio podrá utilizar el siguiente código para agregar estos elementos cambiando únicamente los campos marcados en amarillo con la información de su negocio: Checkout.configure({ merchant : '', order

:{

amount

: function () { //Dynamic calculation of amount

return 80 + 20 }, currency : 'MXN', description: 'Ordered goods', id: '' },

billing

:{

address: { street city

: '123 Customer Street', : 'Metropolis',

postcodeZip : '99999', stateProvince: 'NY', country

: 'USA'

} }, interaction: { merchant

:{

name : 'Your merchant name', address: { line1: '200 Sample St', line2: '1234 Example Town' }, email : '[email protected]', phone : '+1 123 456 789 012', logo : 'https://imageURL' }, locale theme

: 'es_MX', : 'default',

displayControl: { billingAddress : 'OPTIONAL',

customerEmail : 'OPTIONAL', orderSummary

: 'READ_ONLY',

shippingAddress : 'HIDE' } } });

Para mayor información consultar Personalizar la experiencia de pago en la siguiente URL:

https://secure.na.tnspayments.com/api/documentation/integrationGuide lines/hostedPaymentPage/integrationModelHostedCheckout.html

Si usted opta por no regresar al tarjetahabiente a su sitio, se recomienda que, antes de enviar los productos o servicios al tarjetahabiente, utilice un método alternativo para asegurarse de que los datos del pedido, en concreto el monto del pedido, son correctos. Para este tipo de integración se recomienda que opte por el servicio de Notificaciones para poder recibir notificaciones (correo electrónico) si el pago se realiza correctamente. También puede enviar notificaciones por correo electrónico al tarjetahabiente como recibo del pago. Para configurar las notificaciones vía correo electrónico favor de consultar la Guía de Notificaciones. Comenzar la integración de Hosted Payment Page “Regreso a URL” Una vez que se completa el intento de pago, puede regresar al tarjetahabiente su página web y:  Presentar su propia página de recibo al tarjetahabiente.  Actualizar su sistema de compras con los detalles del pago. Para este tipo de integración usted deberá utilizar los campos obligatorios de la integración básica y seguir los siguientes pasos:

1. Solicite una sesión mediante la operación Crear sesión de pago. La solicitud debe incluir datos de pago y de interacción, así como instrucciones de término. A continuación se muestra un fragmento curl de ejemplo para la operación Crear sesión de pago. En este paso también deberá obtener el API password (deberá ingresarlo en el campo marcado en amarillo), para ello favor de consultar la guía de obtención de API password.

curl https://secure.na.tnspayments.com/api/page/version/27/pay \ -d "apiOperation=CREATE_CHECKOUT_SESSION" \ -d "apiPassword=$PWD" \ -d "apiUsername=merchant." \ -d "merchant=" \ -d "order.id=" \ -d "order.amount=100.00" \ -d "order.currency=MXN" Una respuesta correcta a esta operación contendrá parámetros de session.id y successIndicator. Guarde el valor devuelto en el parámetro successIndicator en el sistema de la tienda para verificar si el pago se realizó correctamente o no. 2. Incluya el session.id devuelto en la solicitud Checkout.configure() a TNSPay. Checkout.configure({ ... session: { id: "SESSION000292090496253818604576" }, ... });

El motor de pago envía el resultado del pago en el parámetro resultIndicator, que: o Se adjunta a la dirección URL utilizada para regresar al tarjetahabiente al sitio de la tienda. o Se proporciona como parámetros de entrada a la función complete en la devolución de llamada. Usted puede determinar si el pago se realizó correctamente o no al comparar los parámetros resultIndicator y successIndicator. Una coincidencia indica que el pago se realizó correctamente. 3. Si se realiza correctamente, deberá presentar un recibo de pago al tarjetahabiente en el sitio del negocio y deberá actualizar su sistema con los detalles del pago. Puede recuperar estos datos mediante la operación Recuperar pedido.

Para mayor información sobre esta integración favor de consultar en la URL en la sección de Obtener el resultado del pago y Retorno del pagador al sitio de la tienda:

https://secure.na.tnspayments.com/api/documentation/integrationGuide lines/hostedPaymentPage/integrationModelHostedCheckout.html? locale=es_MX

Para crear su sesión de pago en NVP consultar: https://secure.na.tnspayments.com/api/documentation/apiDocumentati on/nvp/version/latest/operation/Session%3a%20Create%20Checkout %20Session.html?locale=es_MX

Para crear la sesión de pago en REST consultar: https://secure.na.tnspayments.com/api/documentation/apiDocumentati on/rest-json/version/latest/operation/Session%3a%20Create %20Checkout%20Session.html?locale=es_MX

Reporting API

El Reporting API ofrece la posibilidad de programar y descargar reportes ajustados. Para la creación del Reporte API usted deberá crear una URL integrada por los siguientes datos: https://secure.na.tnspayments.com/history/version/1/merchant/999999 9/transaction?timeOfRecord.start=2014-0423T00:00:00&timeOfRecord.end=2014-06-24T00:00:00&csv.timeZone= %2B10:00&csv.timeFormat=iso8601-T&columns=DATOS QUE NECESITA CONTENGA EL REPORTE Dónde:   



https://secure.na.tnspayments.com: es la página de TNS de la que se obtendrá el reporte, esta página no debe cambiarla. 9999999: Número de afiliación, este lo deberá reemplazar por el número de afiliación otorgado por Banamex. transaction?timeOfRecord.start=2014-0423T00:00:00&timeOfRecord.end=2014-0624T00:00:00&csv.timeZone= %2B10:00&csv.timeFormat=iso8601: Se llena con el parámetro de tiempo que se requerirá el reporte, elemplo: 2014-0423T00:00:00 (De 23 de abril de 2014 a las 12am) a 204-0624T00:00:00 (Hasta el 24 de junio de 2014 a las 12am). Datos que necesita contenga el reporte: Los campos disponibles los puede encontrar en la siguiente liga: https://secure.na.tnspayments.com/api/documentation/apiDocum entation/rest-json/version/latest/operation/Transaction%3a %20%20Retrieve%20Transaction.html?locale=es_MX. Estos campos deberá ingresarlos tal cual aparecen en la liga, sin espacios y separados únicamente por comas. Por ejemplo: merchant,order.id,transaction.currency

Cuando el código se encuentre armado y se realice la solicitud de información solicitara contraseña y usuario:  

Nombre de usuario: merchant.default Contraseña: Deberá ingresar el API password obtenido en Merchant Administrator para Reporting API. Si tiene alguna duda de cómo obtener este password favor de consultar la Guía para la Configuración de Usuarios.

Una vez ingresados los datos le aparecerá la siguiente pantalla en donde usted deberá elegir si quiere Abrir o Guardar el archivo

Usted podrá elegir el lugar donde quiere guardar el archivo que se descargará en formato CSV (estos archivos se pueden abrir en Excel) y aparecerán los campos y las fechas que eligió. Para mayor información sobre este reporte y su automatización favor de ingresar a la siguiente URL: https://secure.na.tnspayments.com/api/documentation/integrationGuide lines/supportedFeatures/pickAdditionalFunctionality/reporting/reporting API.html?locale=es_MX