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
Pagadito - Pagos en línea 