Integración de pagos web vía API Pagadito: Parte II

PagaditoEn 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

Integración de pagos web vía API Pagadito: Parte I

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.

Conoce las diferentes integraciones de los servicios de pagos en línea de Pagadito

Como ya lo sabes, durante el mes de Julio, Pagadito quiere resaltar la importante labor del Developer en nuestra acelerada era digital y es por eso que queremos dedicar varios de nuestros contenidos a ellos.

En este artículo te mostraremos brevemente las diferentes formas de integración que ofrece Pagadito, para que tus pagos en línea sean procesados efectiva y eficientemente y, por supuesto, de la manera más segura.

  1. Integración de pagos web vía API: Esta forma de integración es nuestra integración estándar, es la manera más amigable en la que cualquier sitio, sea a través de la web o de una aplicación mobile, puede procesar pagos en línea. Lo que hace, básicamente, es una redirección desde el sitio del comercio o vendedor hacia el sitio de Pagadito, Allí el usuario (Quien está realizando el pago) completa la transacción o transferencia de dinero parar luego ser regresado al sitio o comercio donde inició su proceso de compra. En Pagadito contamos tanto con una API para lenguaje PHP como con una para lenguaje Java.
  1. Integración de pagos web vía Web Service: Esta forma de integración es parecida a la integración vía API. Es un proceso sencillo y práctico para que cualquier sitio web o aplicación mobile pueda procesar sus pagos. Al igual que la integración API, realiza una redirección desde el sitio web del comercio al sitio web de Pagadito. El Web Service que ofrecemos es SOAP y puede ser consumido desde cualquier tecnología como PHP, JAVA, .NET y desde las aplicaciones mobile.
  1. Integración de pagos web vía Plugins para carritos de compra: Esta forma de integración se caracteriza por su simplicidad ya que requiere poco o nada de desarrollo de software. Es ideal para los comercios que integran en su sitio web un carrito de compra para procesar sus pagos en línea. Al igual que las otras dos integraciones, se realiza una redirección desde el comercio a la página de Pagadito. Este plugin de pasarela de pago lo podrás encontrar disponible para los siguientes carritos de compra: Woocommerce de WordPress, Prestashop, Opencart, Magento, Virtuemart de Joomla, OsCommerce, así como para las membresías PaidMembershipsPro de WordPress.
  1. Integración de pagos web vía API RESTFULL: Esta forma de integración ofrece todo el control del flujo de pago al sitio web del comercio, ya que el proceso, de principio a fin, se lleva acabo allí y a diferencia de las integraciones antes mencionadas no se redirecciona al cliente (Comprador) a la página de Pagadito. El proceso, aunque diferente, es sumamente práctico, el comercio se encarga de recibir o colectar lo datos de tarjeta del usuario comprador y luego los envía a Pagadito para que la transacción sea procesada. La API RESTFULL de Pagadito cuenta con dos opciones para completar el proceso de pago: En una se realiza el procesamiento de pagos en la primera compra, y aquí se reciben los datos de tarjeta del cliente y pagadito devuelve un identificador de los datos de pago del usuario comprador además de la respuesta del procesamiento del pago. En la otra se permite el envío de pagos a procesar sin utilizar los datos de tarjeta y el proceso de pago se finaliza únicamente enviando el identificar de los datos de tarjeta del cliente.

Como ves, nuestras opciones de integración son cómodas y versátiles, además de que sea cual sea la que escojas, de acuerdo a tus preferencias, tamaño de negocio o mercado en el que te desenvuelvas siempre contarás con el respaldo de que los pagos procesados en línea serán pagos 100% seguros.

Si tienes alguna duda adicional, no dudes en contactarnos a través de nuestra página web o nuestras redes sociales para brindarte asesoría personalizada.