Integración · REST · gRPC · Pagos
APIs y Pasarelas de Pago
Hacer que dos sistemas se entiendan cuando uno de ellos no quiere. El trabajo que nadie quiere tomar — y que a mí me gusta.
El problema nunca es el camino feliz
La integración funciona bien en la prueba. El problema aparece cuando el proveedor responde distinto de lo documentado, cuando la llamada da timeout después de haber cobrado, cuando el webhook llega dos veces o fuera de orden. Una integración seria trata de lo que pasa cuando sale mal — porque va a salir mal.
Qué incluye
-
Cobros que no se duplican
Clave de idempotencia en cada operación. Un reintento del proveedor nunca se convierte en un segundo cargo en la tarjeta del cliente.
-
Webhooks confiables
Recepción, validación de firma, tolerancia a entregas repetidas y fuera de orden, y cola para reprocesar lo que falló.
-
Conciliación
Lo que la pasarela dice que pasó coincide con lo que tu sistema registró. Cuando no coincide, el informe lo muestra.
-
Reintentos con criterio
No todo fallo debe repetirse. Error de red sí; rechazo del banco no. La diferencia evita cobros indebidos.
-
APIs REST y gRPC propias
Cuando eres tú quien necesita exponer datos. Versionado, autenticación, límite de uso y documentación.
-
Conexión con ERP y legado
Incluso sistemas antiguos que solo hablan por archivo o base de datos. Ya vi de todo.
Por qué conmigo
Trabajo con APIs de retiro y depósito, pasarelas de pago, split, facturación y verificación de identidad en sistemas donde el dinero es de verdad. Idempotencia, log de auditoría y manejo de fallos parciales no son adorno en este contexto — son lo que evita pérdidas.
Preguntas frecuentes
¿Con qué pasarela trabajan?
Con la que tenga sentido para tu caso. Ya integré varias y el patrón es parecido; lo que cambia es la documentación y las particularidades de cada una.
¿Y si el proveedor no tiene buena documentación?
Pasa bastante. La salida es probar contra el entorno de homologación y mapear el comportamiento real, que a veces difiere del papel.
¿Se puede integrar un sistema antiguo sin API?
Casi siempre. Base de datos, archivo, correo automatizado o hasta la pantalla — hay camino. Algunos son feos, pero funcionan y son honestos sobre el costo de mantenimiento.
¿Quién se encarga cuando el proveedor cambia la API?
Si hay contrato de mantenimiento, yo. Si no, lo entrego documentado para que tu equipo pueda ajustarlo.
Cuéntame qué necesitas
Brief de dos minutos. Respondo en hasta un día hábil, personalmente.