Cómo migrar de una API de on-ramp u off-ramp sin detener la aplicación
Plan de migración en cinco etapas
Mapea el contrato que utiliza tu producto
Lista la creación, las consultas, los webhooks, los reintentos, los comprobantes, los límites y la conciliación. Migra el comportamiento utilizado, no toda la documentación del proveedor anterior.
Crea un adaptador interno
Conserva tu interfaz de pagos y adáptala a Lunium. Así evitas dispersar los nombres de estados y campos del proveedor por todo el producto.
Reproduce los casos de fallo
En el sandbox de cash-out, prueba retrasos, fallos, vencimientos, límites y repeticiones del mismo identificador. Para cash-in, valida el catálogo, los límites, la vista previa y el webhook; un QR pagable requiere una clave de producción y una prueba piloto real controlada.
Ejecuta una prueba piloto controlada
Activa una parte definida de las nuevas operaciones. Registra qué proveedor recibió cada solicitud; nunca envíes el mismo pago a dos vías de procesamiento.
Haz el cambio y conserva la vía de reversión
Amplía después de conciliar la operación, el webhook y los movimientos. Desactiva el proveedor anterior solo cuando no haya órdenes pendientes ni reintentos dirigidos a él.
Mapa mínimo del adaptador
interface SettlementProvider {
preview(input): Promise<Quote>
create(input, externalId): Promise<Order>
get(orderId): Promise<Order>
verifyWebhook(headers, rawBody): Event
}
// guarda provider + externalId + orderId en la misma fila
// antes de habilitar reintentos, polling o cambios de ruta
Criterios para ampliar la prueba piloto
Contrato
Los estados y errores están mapeados sin transformar «pendiente» en «fallido».
Idempotencia
Un reintento idéntico devuelve la misma operación y un conflicto no crea una segunda.
Webhook
La firma se valida y el procesamiento tolera repeticiones y eventos fuera de orden.
Conciliación
Cada pedido interno apunta a un único proveedor y a una única operación.
Cuando Lunium no debe recibir tráfico
request_id, external_id, el webhook y la consulta de estado para saber qué ha ocurrido realmente.Trae tu flujo actual
La revisión técnica compara solo los endpoints que usa tu producto y devuelve un plan de prueba piloto y reversión. El sandbox y la clave de producción se obtienen en autoservicio.