Skip to main content

Reject Transaction

Overview

Reject a PENDING transaction in the approval workflow, transitioning it to CANCELLED state with categorized rejection reasons for compliance reporting.

Note: Full API implementation pending. Use the existing universal-transaction-management.md documentation for rejection workflows.


Endpoint

POST /api/bpm/cmd/RejectTransactionCommand

Request Body

FieldTypeRequiredDescription
transactionKeystringYesTransaction reference
rejectionReasonstringYesDetailed rejection reason
rejectionCategorystringNoCategory: FRAUD, COMPLIANCE, INSUFFICIENT_DOCUMENTATION, POLICY_VIOLATION, OTHER

Rejection Categories

CategoryDescriptionTriggers Reporting
FRAUDSuspected fraudulent activityYes (SAR to NFIU)
COMPLIANCEAML/KYC violationYes (Compliance report)
INSUFFICIENT_DOCUMENTATIONMissing/expired documentsNo
POLICY_VIOLATIONViolates bank policyNo
OTHEROther reasonsNo

State Transition

PENDING → CANCELLED (with categorization)
- Releases holds
- Generates compliance reports if needed
- Terminal state

For complete documentation, see Universal Transaction Management.