Skip to content

TASK: Expose internal transfer workflow HTTP API #165

Closed
1 of 1 issue completed
Closed

Description

@ramioooz

Type: Task
Epic: Ledger and Financial Posting
Slice: Slice 5 - Internal Transfer
Service: transaction-service
Priority: P0

Parent story: #53

Objective

Expose the existing transfer process-manager capability through an internal versioned HTTP adapter while preserving the ledger-driven saga boundary.

Scope

  • Add an endpoint to create/request an internal transfer.
  • Add an endpoint to retrieve transfer workflow state by transfer identifier.
  • Map HTTP requests to application commands and application results to stable DTOs.
  • Document pending, completed, failed, reversed, conflict, validation, and not-found responses.
  • Add focused web-layer tests and repeatable API verification instructions.

Boundaries

  • Do not directly mutate account balances from the controller.
  • Do not bypass account reservations, ledger posting, inbox deduplication, or compensating actions.
  • Do not add Kafka transport code in this task; the existing application ports remain the integration boundary.
  • Keep the transfer API internal until authentication and authorization policies are implemented.

Definition of Done

  • The adapter delegates all workflow decisions to the application layer.
  • Success, conflict, validation, not-found, and workflow-state responses are tested.
  • ./mvnw verify, Helm validation, and container smoke verification pass.
  • README and Insomnia documentation are updated.
  • The PR links this task, parent story STORY: Implement internal transfer with account reservation and ledger posting #53, and the transfer saga foundation PRs and is opened ready for review.

Activity

  1. self-assigned this
    on Aug 30, 2026
  2. added theissue type on Aug 30, 2026
  3. ramioooz commented on Aug 30, 2026

    @ramioooz
    MemberAuthor

    Transfer workflow HTTP implementation PR is ready for review. PR: digital-bank-java/transaction-service#8

  4. ramioooz commented on Sep 1, 2026

    @ramioooz
    MemberAuthor

    Completed by merged Transaction Service PRs #8 and #9. The internal transfer HTTP adapter and authorization hardening are implemented; child task #169 is closed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions