Expense Workflow Callback API

Summary

| Method | Path | Purpose |

Audience

API consumers, backend and frontend developers, QA, architects, implementation partners, and support.

Reference Content

Method	Path	Purpose
POST	/expense/workflow/callback	Apply an Approved/Completed or Rejected terminal Workflow decision

The request correlates a Workflow instance or Expense claim and supplies terminal decision plus optional rejection reason. The subject type is checked when provided. A duplicate callback for an already-terminal claim is acknowledged without replaying the decision. Optional live Workflow-state verification can detect a definitive mismatch.

Callback authentication, caller authorization, network trust, and replay governance Require confirmation. Detailed trust mechanics and deployment configuration are intentionally excluded.

Source References

• microservices/src/expense-service/Api/ExpenseEndpoints.cs
• microservices/src/expense-service/Application/WorkflowIntegration.cs

Related Articles

• Expense technical documentation
• Expense business documentation

See Also

• Expense module

Keywords

• Expense API
• Workflow Callbacks

Revision Information

• Status: Draft
• Last reviewed: 2026-07-16
• Review cycle: Quarterly