Haz fiables los eventos de conversión y reembolso

Antes de empezar

Recibir un evento no demuestra que la comisión sea correcta. Un mensaje puede repetirse, un reembolso llegar antes de terminar el procesamiento y un servicio responder aunque falle el registro comercial. Este método ayuda a programa e integración a definir pruebas verificables. Confirma las propiedades del transporte en la documentación de tu proveedor; Stripe se utiliza como ejemplo técnico documentado, sin generalizar sus garantías a otras plataformas.

Distingue tres identificadores

Separa el identificador del mensaje, el de la operación comercial y el del socio. El primero reconoce entregas repetidas; el segundo relaciona pedido, factura, cancelación y exportación; el tercero sostiene la atribución. Añade tipo de evento, versión y fecha comercial a las pruebas. No construyas una referencia de pedido a partir de importe y dirección del cliente.

Verifica antes de procesar

Aplica el mecanismo de autenticidad documentado por el proveedor, incluida la firma cuando esté disponible. Define qué registrar ante una firma inválida sin divulgar datos personales. No modifiques secretos durante una prueba editorial. Una respuesta HTTP satisfactoria no prueba ni autenticidad ni éxito comercial; separa recepción, persistencia y procesamiento en el registro de diagnóstico.

Evita efectos dobles en los reintentos

Cuando vuelve un evento, recupera el resultado existente en vez de crear otra comisión. Conserva la prueba del procesamiento vinculada a la operación comercial. Las claves de idempotencia de una API y la deduplicación de eventos entrantes resuelven problemas distintos. Comprueba cada camino por separado; no presupongas que una protección cubre automáticamente el otro.

Gestiona eventos fuera de orden

Describe qué ocurre si llega un reembolso antes de disponer del pedido localmente. Según las capacidades del proveedor, prepara una espera controlada o recupera información del sistema de origen. Una actualización antigua no debe sobrescribir un estado más reciente sin una regla explícita. Guarda hora de ocurrencia y de recepción para poder explicar la secuencia.

Prueba fallo y recuperación

En un entorno autorizado, simula indisponibilidad, respuesta tardía y recepción repetida. Comprueba límites y tiempos de reintento del proveedor. Una repetición manual puede coexistir con la automática. Define quién puede repetir una operación, qué evidencia necesita y qué comprobar después. El objetivo es un único efecto comercial, no solamente un mensaje marcado como recibido.

Concilia con los registros comerciales

Compara pedidos y facturas de origen con las operaciones elegibles de la plataforma. Distingue retraso normal, rechazo documentado y pérdida real. Contrasta cantidades y número de operaciones por moneda: un total puede ocultar duplicados compensados por ausencias. Conserva referencias de extremo a extremo para compras, devoluciones parciales y cancelaciones.

Prepara evidencia útil en un incidente

Reúne referencia comercial, tipo, fechas, versión, estado esperado y observado sin exponer secretos. Identifica el primer paso divergente, asigna responsable y plazo de resolución. Tras la corrección, repite el caso y otros próximos: arreglar reembolsos no debe duplicar compras. Guarda la conclusión para que la misma incidencia pueda detectarse antes.

Respuestas prácticas

Preguntas para decidir