Desarrollador Backend para Integración de Pasarela de Pago Yappy en Smartisp.us

Estamos buscando un desarrollador backend experimentado para integrar la pasarela de pago local Yappy de Panamá en nuestro sistema de gestión SmartISP.us. El objetivo principal es permitir a los clientes pagar sus facturas emitidas por SmartISP.us utilizando Yappy, asegurando que el estado del pago se refleje de inmediato en nuestro sistema. Esta integración es exclusiva para Yappy y no implica la conexión con otros sistemas ERP.

Alcance y Entregables del Proyecto:

1. Revisión y Diseño:
  Analizar la documentación de la API de SmartISP.us, disponible en api.smartisp.us.
  Estudiar a fondo la especificación de integración de la API de Yappy (la documentación será proporcionada al desarrollador seleccionado).
  Definir el flujo de pago completo, incluyendo la creación de transacciones, la obtención del enlace o botón de pago, y el manejo de los callbacks de Yappy.

2. Implementación Técnica:
  Desarrollar la autenticación con Yappy, ya sea mediante login/logout o tokens, según lo requiera su API.
  Crear un endpoint en SmartISP.us para generar transacciones de pago de Yappy, gestionando montos, números de factura y referencias.
  Devolver al cliente el URL o el componente embebido necesario para completar el proceso de pago.
  Implementar la recepción de webhooks de Yappy, exponiendo un endpoint específico como /webhook/yappy en SmartISP.us.
  Validar la firma HMAC-SHA256 de los webhooks utilizando el secreto proporcionado para asegurar la integridad de los datos.
  Actualizar el estado de la factura en la base de datos de SmartISP (pagada, rechazada, expirada, reversa) de forma inmediata tras la recepción del webhook.
  Asegurar la persistencia de datos, registrando cada transaction_id, estado y timestamps relevantes en la base de datos de SmartISP para un seguimiento completo.

3. Pruebas y Calidad:
  Proveer una colección Postman o ejemplos de comandos curl para facilitar las pruebas de la API, incluyendo la creación de transacciones de pago y la simulación de webhooks con diferentes estados.
  Realizar pruebas unitarias y de integración exhaustivas para garantizar la idempotencia de las operaciones y un manejo robusto de errores.

4. Documentación y Despliegue:
  Crear un archivo .env.example con todas las variables de entorno necesarias (API_KEY, SECRET_KEY, URLs de Yappy).
  Elaborar una guía breve de configuración y despliegue del módulo en entornos de cPanel o VPS.
  Proporcionar instrucciones claras para el monitoreo de logs y la resolución de posibles errores en producción.

Tecnologías y requisitos
    •    Usar el mismo stack de SmartISP.us (especificar PHP/Laravel, Node.js, Python, etc.).
    •    Experiencia previa integrando Yappy o pasarelas similares.
    •    Conocimiento de HMAC-SHA256 para validación de webhooks.
    •    Base de datos relacional (MySQL, PostgreSQL).
    •    Control de versiones con Git.

Cómo postular
    1.    Breve descripción de tu experiencia con Yappy o pasarelas de pago bancarias similar
    2.    Tecnologías que propones usar y justificación.
    3.    Cronograma detallado por fases/entregables.