Huecos conocidos
Lo que un integrador razonablemente esperaría y hoy no existe. Sirve para planear y priorizar.
| Área | Hueco | Impacto | Estado |
|---|---|---|---|
| API | No hay API pública de pagos (crear, consultar, reembolsar). El pago nace en la página de pago. | Un tercero solo conoce el resultado por webhook. | Pendiente de decisión |
| API | Sin Idempotency-Key en la API pública. | Reintentar un POST puede duplicar. | Pendiente |
| API | Sin paginación en los listados. | Listados grandes. | Pendiente |
| API | Sin límite de peticiones para integradores. | Abuso involuntario. | Pendiente |
| API | Sin ejemplos en el OpenAPI y respuestas JSON:API genéricas (sin tipado por recurso). | Referencia menos precisa. | Parcial |
| Webhooks | Sin API para consultar las entregas ni reenviar un evento fallido. | Recuperación manual. | Pendiente |
| Webhooks | Espera fija de ~10 s entre reintentos (sin retroceso exponencial); 5 intentos. | Poca tolerancia a caídas largas. | Conocido |
| Webhooks | payment.failure_reason puede repetir el estado (p. ej. "APPROVED") en pagos aprobados confirmados por un proveedor de rail. | Dato engañoso para el comercio. | Defecto conocido, por corregir |
| Webhooks | Sin catálogo de eventos versionado ni GET que los liste. | Documentado solo aquí. | Parcial |
| Acceso | Sin autoservicio para obtener credenciales; sin roles o scopes finos por integrador. | El alta pasa por un administrador. | Pendiente |
| Ambientes | Sin sandbox hospedado para terceros. | Solo entorno local. | Pendiente |
| Ambientes | La API desplegada no sirve su OpenAPI (solo Development); el sitio usa un snapshot. | Hay que sincronizar el snapshot. | Por diseño |
| Documentación | Solo en español; sin versionado de docs. | — | Fase siguiente |
| Proveedores | Plantillas reales de Mo$i y Bre-B, vencimiento, firma y vocabulario de estados. | Ver decisiones abiertas. | Abierto |
| Medios | La tarjeta no se puede probar en el entorno local. | — | Conocido |