Repository navigation
Closed
Copy link
Description
Objective
Implement the first deterministic transfer-risk decision gate inside Transaction Service using the approved versioned risk/step-up contract.
Scope
- Normalize transfer intent fields before evaluation.
- Evaluate the configured local policy and return exactly one of
ALLOW,REQUIRE_STEP_UP, orDECLINE. - Support the initial transfer classifications
INTERNAL,DOMESTIC, andINTERNATIONAL. - Configure policy version, decision TTL, high-value threshold, and explicitly declined classifications through Config Server/SIT values; do not hard-code business thresholds in clients.
- Persist the decision binding with the transfer workflow so account reservation and ledger posting cannot start when step-up is required or the decision is expired.
- Make a decision request idempotent and reject reuse with a changed normalized intent.
- Keep OTP values, tokens, raw credentials, and unnecessary device data outside Transaction Service persistence and logs.
- Preserve the existing ledger-driven saga boundary. MFA challenge creation/verification remains a separate child task under Story STORY: Require MFA for high-value internal, domestic, and international transfers #56.
Acceptance Criteria
- Equivalent normalized intent retries return the same decision and transfer identity.
- A changed intent with the same decision request identifier returns
409 Conflict. ALLOWcontinues to the existing reservation action.REQUIRE_STEP_UPreturns a transfer-bound decision and emits no reservation or ledger action until assurance is recorded.DECLINEterminates the workflow without reservation or ledger posting.- Expired, replayed, or mismatched decisions fail closed.
- The API/OpenAPI contract, SIT configuration, and verification procedure document the behavior.
Dependencies
- Parent Story: STORY: Define transfer risk policy and step-up annotation #55
- Contract: https://github.com/digital-bank-java/.github/blob/main/docs/contracts/transfer-risk-step-up.md
- Follow-up MFA integration: STORY: Require MFA for high-value internal, domestic, and international transfers #56
This is local SIT implementation only. External policy engines, AWS deployment, and production threshold governance remain deferred.
Activity