Botón de Pago Instapago versión 1.1 TECNOLOGÍA INSTAPAGO C.A.

Tamaño: px

Comenzar la demostración a partir de la página:

Download "Botón de Pago Instapago versión 1.1 TECNOLOGÍA INSTAPAGO C.A. www.instapago.com"

Julia Quiroga Martín
hace 8 años
Vistas:

1 Botón de Pago Instapago versión 1.1 TECNOLOGÍA INSTAPAGO C.A.

2 Histórico de Cambios Fecha Ver. Autor Descripción 06/06/ Enyert Viñas Creación del Documento 06/10/ Alex Istúriz Modificación y descripción de los procesos de validación del pago.

0 Enyert Viñas Creación del Documento 06/10/2014

3 Tabla de contenido Histórico de Cambios Introducción Formas de pago aceptadas Bancos afiliados Guía de Integración Requerimientos Uso del Botón de Pago Instapago Códigos de Respuesta Ejemplo de integración con el Botón de Pago Instapago Javascript

Requerimientos Uso del Botón de Pago Instapago Códigos de

Introducción Botón de Pago Instapago es una solución tecnológica pensada para el mercado de comercio electrónico (e-commerce) en Venezuela y Latinoamérica, con la intención de ofrecer un producto de

4 Introducción Botón de Pago Instapago es una solución tecnológica pensada para el mercado de comercio electrónico (e-commerce) en Venezuela y Latinoamérica, con la intención de ofrecer un producto de primera categoría, que permita a las personas y empresas apalancar sus capacidades de expansión, facilitando los mecanismos de pago para sus clientes, con una integración amigable a los sistemas que actualmente utilizan. Cualquier comercio que desee recibir pagos por internet desde su sitio web puede apoyarse en Boton de Pago Instapago y uno de los bancos afiliados para lograr sus objetivos. Esta Guía de Integración tiene el objeto de facilitar a los departamentos de tecnología de los comercios y a desarrolladores independientes la integración de sus soluciones web con el Botón de Pago Instapago. Formas de pago aceptadas Tarjetas de crédito de las siguientes marcas: Bancos afiliados

actualmente utilizan. Cualquier comercio que desee recibir pagos por internet desde su sitio web puede apoyarse en Boton de Pago Instapago y uno de los bancos afiliados para lograr sus objetivos.

5 Guía de Integración Una de las ventajas principales de Botón de Pago Instapago, es la forma de pago mediante comunicación directa con su Payment Gateway a través de un formulario personalizable desarrollado por nuestro equipo de desarrolladores. El usuario o cliente final realiza su compra en el sitio proporcionado por el comercio y luego es redirigido hacia el Botón de Pago Instapago. Ya en nuestro formulario, todos los datos correspondientes a la tarjeta de crédito son procesados de forma segura a través de nuestra plataforma. Finalmente, se retorna el resultado de la transacción al comercio afiliado. Entre los beneficios de utilizar el Botón de Pago Instapago, podemos citar los siguientes: Mejor experiencia de usuario Mayor rapidez en el proceso de compra Mayor control por parte del comercio dentro de sus procesos con sus clientes Requerimientos El Comercio debería cumplir con los siguientes requerimientos para poder recibir pagos a través de Instapago: Dominio propio Código fuente propio o acceso al mismo Alojamiento en servidor propio o terceros Botón de Pago Instapago es compatible con cualquier aplicación web. Entre los exploradores soportados por Botón de Pago Instapago están: Internet Explorer 9.0 o superior Opera 22.0 o superior Google Chrome 35.0 o superior Mozilla Firefox 27.0 o superior

Ya en nuestro formulario, todos los datos correspondientes a la tarjeta de crédito son procesados de forma segura a través de nuestra plataforma.

6 Uso del Botón de Pago Instapago Antes de proceder a la integración de botón de pago, debe notificar a Instapago cuáles serán las URL de origen y URL de respuesta para el botón de pago. La URL de origen comprende la dirección de donde será invocado el botón de pago, (Por ejemplo, la URL donde se encuentra ubicado el botón pagar de su sitio web), mientras que la URL de respuesta será la dirección a donde Instapago debe redirigir al usuario y notificar al comercio una vez se ha procesado el pago. Estas dos URL servirán como base para nuestros dos procesos, captura de datos y validación del pago. El proceso de captura consiste en obtener los datos del cliente para proceder con el pago a través de un portal en la plataforma de Instapago. Para invocar este portal, utilizaremos el siguiente método: URL: Para poder acceder a esta URL se debe realizar una petición HTTP de tipo POST que contenga los siguientes argumentos: KeyId (Requerido): Llave generada desde Instapago PublicKeyId (Requerido): Llave compartida enviada por correo al crear una cuenta en Instapago idfactura (Requerido): Número de factura o de orden de la compra que se va a procesar. Monto (Requerido): Monto de la compra a debitar. Se debe utilizar el punto como separador decimal. Por ejemplo: , donde 200 es la parte entera del monto y.00 su parte decimal. Descripción (Requerido): Tipo de operación que se está realizando. Después de realizar la petición, si todos los parámetros cumplen con nuestras validaciones de seguridad se presentará el siguiente formulario:

la dirección a donde Instapago debe redirigir al usuario y notificar al comercio una vez se ha procesado el pago.

7 En caso contrario recibirá un código de error 404 indicando que el host ha sido capaz de comunicarse con el servidor pero no existe el fichero solicitado. Una vez el cliente ha llenado todos los datos y continúe con el pago, Instapago verificará los datos de la transacción y redirigirá al usuario a la URL de respuesta, donde se incluirá como parámetros lo siguiente: Payment: Token del pago para su validación. ordernumber: Número de la orden o factura asociada al pago procesado Ejemplo: 45abcde&ordernumber=00012

Una vez el cliente ha llenado todos los datos y continúe con el pago, Instapago verificará los datos de la transacción y redirigirá al usuario

8 Validación de la respuesta del Botón de Pago Instapago Recibida la respuesta de Instapago a través de los parámetros de la URL de respuesta, el comercio deberá validar los datos del pago haciendo llamado un servicio API de tipo REST: URL: Método: GET formdata: KeyId (Requerido): Llave generada desde Instapago PublicKeyId (Requerido): Llave compartida Enviada por correo al crear una cuenta en Instapago PublicKeyId (Requerido): Llave compartida Enviada por correo al crear una cuenta en instapago Payment: Token del pago para su validación. Respuesta Tipo: application/json Valor: {"success": Indica si fue procesado el pago (true o false), "message": Descripción de la respuesta (Máx. 200 caracteres), "id": Código del pago (Máx. 8 caracteres), "code": Código del respuesta del pago (Máx. 3 caracteres), "ordernumber": Número de la orden o factura asociada al pago, "reference": Código de referencia bancaria (Máx. 6 caracteres), "voucher": HTML 1 que contiene el recibo del pago } 1 El HTML está representado en formato de presentación no ejecutable.

com/botonpago Método: GET formdata: KeyId (Requerido): Llave generada desde Instapago PublicKeyId (Requerido): Llave compartida Enviada por correo al crear una cuenta en Instapago PublicKeyId

9 Códigos de Respuesta Para todas las transacciones realizadas bajo el Boton de Pago Instapago, los códigos HTTP de respuestas corresponden a los siguientes estados: 201: Pago procesado con éxito 400: Error al validar los datos enviados (Adicionalmente se devuelve una cadena de caracteres con la descripción del error) 401: Error de autenticación, ha ocurrido un error con las llaves utilizadas 403: Pago Rechazado por el banco. 500: Ha Ocurrido un error interno en el servidor. 503: Ha Ocurrido un error al procesar los parámetros de entrada. Revise los datos enviados y vuelva a intentarlo. Importante: Si recibe un código de respuesta diferente a los descritos anteriormente deben ser tomados como errores de protocolo HTTP.

ocurrido un error con las llaves utilizadas 403: Pago Rechazado por el banco. 500: Ha Ocurrido un error interno en el servidor.

10 Ejemplo de integración con el Botón de Pago Instapago A continuación se incluyen algunos ejemplos de cómo realizar la integración del Botón de Pago Instapago con el sitio web de un comercio. Javascript Con este ejemplo, estamos utilizando el método sendpost para enviar una petición de tipo POST pasando los parámetros path(ruta de la petición), params (parámetros que se van a pasar en la petición) y method(método http por el que se va a enviar la petición, puede ser POST o GET ). Con el id instapago escuchamos el evento click para utilizar sendpost y acceder al Botón de Pago Instapago. Con el código presentado anteriormente bastaría con tener un elemento que contenga el monto de nuestra transacción para obtener el valor con JQuery o Javascript.

Javascript Con este ejemplo, estamos utilizando el método sendpost para enviar una petición de tipo POST pasando los parámetros path(ruta de la petición), params (parámetros que se van a

Documentos relacionados

Integración con ecommerce Bancard

Integración con ecommerce Bancard Compra Simple - versión 0.3 1- Introducción Flujo de compra Operaciones 2- Autenticación Token 3- Operaciones 3.1 - Operaciones de infonet-vpos 3.1.1 - Single Buy 3.1.2