Pagos mediante API
Conecta depósitos, retiros y cambios de estado de transacciones con los servicios de pago elegidos.
Cómo funciona en la práctica
Un pago confiable no termina cuando la solicitud recibe una respuesta exitosa. Los sistemas deben coincidir en la identidad de la operación, su autorización, estado final y conciliación.
Requisitos técnicos principales
- Solicitudes de depósito y retiro, elección de método y redirecciones.
- Notificaciones firmadas, validación y protección contra eventos repetidos.
- Estados pendientes, rechazados, revertidos y completados.
- Historial, archivos de conciliación y trazabilidad para soporte.
Los métodos disponibles, las devoluciones, monedas y requisitos de cumplimiento dependen del procesador, el operador y el mercado.
Cómo planeamos esta conexión
Estas etapas muestran los puntos técnicos que deben resolverse. La implementación y los entregables dependen de los sistemas involucrados y del alcance acordado.
Definir quién controla la transacción
Acordamos dónde comienza el depósito o retiro, qué sistema lo aprueba y cómo se vincula la referencia externa al libro de movimientos de la billetera.
Unificar los estados
Tratamos pendiente, autorización, conclusión, rechazo, reverso y disputa como eventos separados cuando el método admite esos estados.
Preparar la conciliación
Definimos reportes o endpoints para comparar la liquidación del procesador, los movimientos en la billetera y el historial que ve el usuario.
Qué necesitamos revisar
- Métodos de pago, monedas y países previstos
- Billetera, servicios financieros y reportes existentes
- Documentación del procesador para callbacks, devoluciones y retiros
Escenarios de aceptación por planear
- Una notificación validada no abona dos veces la misma cantidad.
- Un retiro pendiente no aparece como liquidado antes de confirmarse.
- Un pago revertido conserva el vínculo con la transacción original.
Qué definir antes de implementar
¿Podemos integrar varios proveedores de pago?
Sí, si el enrutamiento, los estados de transacción y la responsabilidad de liquidación se diseñan de manera consistente.
¿Cómo evitamos depósitos duplicados?
Relacionando los ID externos e internos y validando callbacks repetidos o retrasados según el estado de la transacción.
¿La API incluye la apertura de una cuenta de comercio?
No. Describir una API no implica aprobación ni autorización para procesar pagos; eso se negocia por separado con el proveedor.
¿Cómo se verifican las firmas de pago?
Se sigue el protocolo de la pasarela, incluidos los campos firmados, la rotación de secretos y la protección contra repeticiones cuando esté disponible.