WEB-506 feat: add Remittance Module with 7-step payout wizard (#3200)

WEB-506 fix: address CodeRabbit review (security, validation)

WEB-506 fix: make API gateway header name configurable (MIFOS_REMITTANCE_API_HEADER)

WEB-506 fix: remove duplicate translation keys (Personal Information, Transaction Details)

src/app/remittances/remittances.service.ts

@@ -0,0 +1,152 @@
+/**
+ * Copyright since 2025 Mifos Initiative
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+import { Injectable, inject } from '@angular/core';
+import { HttpClient, HttpHeaders, HttpBackend } from '@angular/common/http';
+import { Observable } from 'rxjs';
+
+import { environment } from '../../environments/environment';
+import {
+  RemittanceTransaction,
+  RemittanceVendor,
+  PayoutAssignmentRequest,
+  PayoutAssignmentResponse,
+  PayoutConfirmationRequest,
+  PayoutConfirmationResponse
+} from './models/remittance.model';
+import { ValidateRecipientRequest, ValidatedRecipient } from './models/beneficiary.model';
+
+/**
+ * Remittances Service
+ *
+ * Handles all HTTP communication with the Mifos Remittance Microservice.
+ * Base URL pattern: {mifosRemittanceApiUrl}{mifosRemittanceApiProvider}{mifosRemittanceApiVersion}/remittances/:tenant/:vendor/...
+ *
+ * Auth: X-Gravitee-Api-Key header (injected server-side by the proxy)
+ */
+@Injectable({
+  providedIn: 'root'
+})
+export class RemittancesService {
+  private httpBackend = inject(HttpBackend);
+
+  /** Separate HttpClient that bypasses interceptors (avoids Fineract API prefix) */
+  private http = new HttpClient(this.httpBackend);
+
+  private get baseUrl(): string {
+    return `${environment.mifosRemittanceApiUrl}${environment.mifosRemittanceApiProvider}${environment.mifosRemittanceApiVersion}`;
+  }
+
+  private get tenant(): string {
+    return environment.fineractPlatformTenantId || 'default';
+  }
+
+  private getHeaders(): HttpHeaders {
+    return new HttpHeaders({ 'Content-Type': 'application/json' });
+  }
+
+  /**
+   * Endpoint 0: Get available remittance vendors for the tenant.
+   * GET /v1/remittances/:tenant/vendors
+   */
+  getVendors(): Observable<{ vendors: RemittanceVendor[] }> {
+    return this.http.get<{ vendors: RemittanceVendor[] }>(`${this.baseUrl}/remittances/${this.tenant}/vendors`, {
+      headers: this.getHeaders()
+    });
+  }
+
+  /**
+   * Endpoint 1: Find remittance by external ID / PIN.
+   * GET /v1/remittances/:tenant/:vendor/transactions/:id
+   */
+  findRemittance(vendor: string, externalId: string): Observable<RemittanceTransaction> {
+    return this.http.get<RemittanceTransaction>(
+      `${this.baseUrl}/remittances/${this.tenant}/${vendor}/transactions/${externalId}`,
+      { headers: this.getHeaders() }
+    );
+  }
+
+  /**
+   * Endpoint 2: Validate recipient for a transaction.
+   * POST /v1/remittances/:tenant/:vendor/transactions/:id/recipient
+   */
+  validateRecipient(
+    vendor: string,
+    transactionId: string,
+    data: ValidateRecipientRequest
+  ): Observable<ValidatedRecipient> {
+    return this.http.post<ValidatedRecipient>(
+      `${this.baseUrl}/remittances/${this.tenant}/${vendor}/transactions/${transactionId}/recipient`,
+      data,
+      { headers: this.getHeaders() }
+    );
+  }
+
+  /**
+   * Endpoint 3: Assign transaction ready to payout (lock for payout).
+   * POST /v1/remittances/:tenant/:vendor/transactions/:id/payout-assignment
+   */
+  assignPayout(
+    vendor: string,
+    transactionId: string,
+    body?: PayoutAssignmentRequest
+  ): Observable<PayoutAssignmentResponse> {
+    return this.http.post<PayoutAssignmentResponse>(
+      `${this.baseUrl}/remittances/${this.tenant}/${vendor}/transactions/${transactionId}/payout-assignment`,
+      body || {},
+      { headers: this.getHeaders() }
+    );
+  }
+
+  /**
+   * Endpoint 4: Confirm transaction payout.
+   * POST /v1/remittances/:tenant/:vendor/transactions/:id/payout-confirmation/:clientId
+   */
+  confirmPayout(
+    vendor: string,
+    transactionId: string,
+    clientId: number,
+    body?: PayoutConfirmationRequest
+  ): Observable<PayoutConfirmationResponse> {
+    return this.http.post<PayoutConfirmationResponse>(
+      `${this.baseUrl}/remittances/${this.tenant}/${vendor}/transactions/${transactionId}/payout-confirmation/${clientId}`,
+      body || {},
+      { headers: this.getHeaders() }
+    );
+  }
+
+  /**
+   * Unassign transaction from payout (state management).
+   * DELETE /v1/remittances/:tenant/:vendor/transactions/:id/payout-assignment
+   */
+  unassignPayout(vendor: string, transactionId: string, reason: string): Observable<any> {
+    return this.http.request(
+      'DELETE',
+      `${this.baseUrl}/remittances/${this.tenant}/${vendor}/transactions/${transactionId}/payout-assignment`,
+      {
+        headers: this.getHeaders(),
+        body: { reason }
+      }
+    );
+  }
+
+  /**
+   * Reverse payout confirmation (state management).
+   * DELETE /v1/remittances/:tenant/:vendor/transactions/:id/payout-confirmation
+   */
+  reversePayoutConfirmation(vendor: string, transactionId: string, reason: string): Observable<any> {
+    return this.http.request(
+      'DELETE',
+      `${this.baseUrl}/remittances/${this.tenant}/${vendor}/transactions/${transactionId}/payout-confirmation`,
+      {
+        headers: this.getHeaders(),
+        body: { reason }
+      }
+    );
+  }
+}