En nuestra entrada de hoy daremos continuidad al proceso de configuración de la API Pagadito como método de pago seguro. Como lo mencionábamos, sabemos que cada sitio web o aplicación es un universo diferente, sin embargo, diseñamos el siguiente paso a paso tratando de que se adapte a la mayoría de ellos.

Para poder iniciar deberás descargar la API PHP y ubicarla en tu proyecto, en la carpeta en donde manejes librerías externas. Hecho esto, debes agregar en tu proceso de compra, en la elección de método de pago: Pagadito, para que posteriormente, en flujo de compra, cuando el usuario selecciona Pagadito para realizar su pago se pueda hacer la conexión a nuestro servicio; antes de esto debes instanciar la clase de la API, habilitar el modo sandbox para esta etapa de pruebas y utilizar el método “connect()” que lleva como parámetros tus credenciales de conexión y que te da como respuesta el token para realizar la transacción, y luego utilizas el método “exec_trans()” (Si es exitoso tu cliente será redireccionado a la pantalla de pago de Pagadito) que lleva como parámetros la información de la transacción, acá debes tener muy presente el ERN (External Reference Number) el cual corresponde a la referencia de la transacción, si manejas facturas el ERN sería el número de factura o si manejas ordenes sería el número de orden. Este ERN importante como identificador para en tu sistema ya que Pagadito solo lo recibe y lo asocia en la transacción.

Veamos entonces como se dan los pasos una vez el usuario es direccionado al sitio web de Pagadito:

Paso 1: Una vez que el usuario realiza el pago en el sitio web de Pagadito, con cualquier tarjeta, VISA o MasterCard, o con su cuenta Pagadito, en caso de tenerla, tu sistema, por un periodo máximo de 10 minutos, no sabrá que está sucediendo con el pago.

Paso 2: Luego de finalizar el Pago en la página de Pagadito, el usuario será redireccionado a la URL de Retorno que seteaste en el Paso 3 del instructivo anterior con los parámetros de token y ERN en la URL, el parámetro token es el mismo token que se te devolvió en el “connect()” que realizaste en el paso anterior, y el ERN es el mimos que enviaste como parámetro en el método “exec_trans()”.

Para que puedas confirmar el estado del pago, de nuevo creas una instanciar la clase de la API, y habilitas el modo sandbox para etapa de pruebas, luego usas el método “connect()” que lleva como parámetros tus credenciales de conexión y que te da como respuesta el token de conexión para realizar la transacción, y por ultimo utilizas el método “get_status()” que lleva como parámetro el token de la transacción que quieres consultar que sería el que se te devolvió en la URL, este método te devuelve como respuesta un “TRUE” o un “FALSE” si la respuesta es TRUE puedes ocupar los siguientes métodos para saber la información de la transacción.

• Método “get_rs_status()”: Devuelve el estado de la transacción consultada, después de un “get_status()”.
• Método “get_rs_reference()”: Devuelve la referencia de la transacción consultada, después de un “get_status()”.
• Método “get_rs_date_tran()”: Devuelve la fecha y hora de la transacción consultada, después de un “get_status()”.

Con estos datos tienes toda la información de la transacción y puedes guardar en tu sistema para generar reportes. Puedes ver el listado completo de status de las transacciones y su significado en nuestra documentación para desarrolladores en la descripción del método “get_status()”.

Paso 3: Lo más recomendable es presentar al usuario un mensaje del pago realizado con la referencia de pago correspondiente. Este dato Pagadito lo muestra al usuario pagador y al comercio como identificador único de la transacción. Otras opciones son enviarle una notificación por correo electrónico tanto al pagador como al administrador de tu sitio o encargado de las ventas. Pagadito les envía notificaciones por correo electrónico a ambos usuarios a los correos electrónicos que registran en nuestro sitio web.

En el Dashboard de comercio en Pagadito Sandbox, usando tu correo y contraseña, puedes revisar tu saldo y tu reporte de pagos recibidos para que veas en ellos la venta de prueba que realizamos.

Paso 4: Ahora que ya hemos realizado todo el desarrollo que requiere la integración estamos listos para el paso producción, primero necesitas crear o que tu cliente, si eres un desarrollador o empresa de desarrollo, cree un comercio Pagadito en ambiente Live, esto tiene un costo y requiere una tarjeta real para realizar el cobro. El comercio debe realizar el proceso de activación entregando los documentos requeridos y en el caso del desarrollador debe realizar el proceso de llenado del formulario de certificación técnica que lleva un pequeño grupo de transacciones realizadas en Pagadito Sandbox.

Nuestro equipo de validación revisa la integración y se da por activado el comercio para que puedas procesar pagos con Pagadito. Como desarrollador solo debes hacer dos cosas: Cambiar las credenciales UID y WSK de Sandbox por las de Live y eliminar el modo llamado a los métodos de activación de modo Sandbox en tu código. Una vez hechos estos cambios esta lista la integración con Pagadito y puedes comenzar a recibir pagos seguros en línea o que tu cliente comience a recibirlos.

Esto fue todo, pero sabemos que a veces puede haber dudas o dificultades, por ello contamos con un agente de soporte específico para desarrolladores que te ayudara con gusto en cualquier inconveniente para que puedas realizar tu integración adecuadamente y que puedes contactar a través de los siguientes medios:

Correo electrónico: developers@pagadito.com

Skype: developers@pagadito.com

WhatsApp: +503 7579 6562

Continuando con nuestro contenido de Julio, inspirado y dirigido a los Developers y su vital función en las empresas, queremos en esta oportunidad mostrarte, de una manera resumida y clara los pasos que debes seguir para completar la integración web vía API Pagadito, y que comiences a procesar tus pagos en línea de manera efectiva y segura.

Paso 1: Lo primero que debes hacer es crear una cuenta de Comercio en Pagadito Sandbox  Para que así puedas acceder al ambiente de pruebas con todas las funcionalidades de Pagadito y así estar seguro de que los procesos de la integración de la API están haciéndose correctamente. Solo debes hacer click en el enlace a continuación: Registrar y completar el proceso; recuerda que la creación de este tipo de cuenta no tiene ningún costo.

Es recomendable que revises nuestra documentación para Developers, en nuestro sitio Pagadito Developers. Para esta forma de integración en específico puedes revisar la información de la Biblioteca de Contenidos de la sección API PG.

Paso 2: Lo siguiente que vas a hacer es descargar la API PG que se adapta a tu tecnología, en el caso de nuestro ejemplo, vamos utilizar la API PHP versión 1.5.1 que la puedes descargar desde la sección de Descargas específicamente en la parte de APIs. Ya estando en esta área de descargas puedes aprovechar todo nuestro contenido como el manual de integración de la API PHP y el Demo API PHP versión 1.4.1 que te brindará una visión de proyecto pequeño integrado con la API PHP de Pagadito.

Paso 3: Una vez has descargado la API PG y tienes a la mano los manuales e información necesaria deberás ingresar a tu cuenta Comercio en Pagadito Sandbox con tu correo electrónico y contraseña. Allí te encontrarás con el Dashboard donde deberás ubicar la sección de Configuración Técnica y la opción de Parámetros de Integración, una vez en esta opción dirígete a la sección de Credenciales de Conexión y en ella encontraras tu UID (User ID) y WSK (Web Service Key) las cuales corresponden a tus credenciales de conexión para el uso de la API de Pagadito. Estas serán usadas en el código de tu sitio web o App.

Una vez tengas ubicadas las credenciales y en esta misma sección (Configuración técnica – Parámetros de integración) encontrarás una sub sección para el seteo de la URL de Retorno de tu comercio Pagadito, esta URL es a la que tus usuarios serán redireccionados después de finalizar el proceso de pago, ya sea un pago exitoso, un pago fallido o si al usuario se le termino el tiempo para realzar la transacción o decidió regresar a tu comercio desde la pantalla de pago de Pagadito. Por ejemplo, si tu dominio es vendosillas.com tu url de retorno sería  http://www.vendosillas.com/gracias-por-tu-pago/{value}/ern_value} esos dos parámetros finales son identificadores de la transacción y permiten que consumiendo un método de la API valides el estado de la transacción.

Por ahora eso es todo en cuanto a la configuración de Pagadito Sandbox para que comiences a realizar las diferentes integraciones necesarias con la API Pagadito y para este ya podrás comenzar a hacer lo que más te gusta: Desarrollar la integración.

Entendemos que cada sitio o aplicación es un mundo diferente, pero en Pagadito siempre estamos para asesorarte en cualquier duda que tengas realizando este proceso, además en una próxima entrada encontrarás un nuevo paso a paso donde profundizaremos en la configuración de la API Pagadito como método de Pago y te mostraremos los diferentes estados de las transacciones y sus significados.