feat:ORV2-2857 BE Refund To Multiple Payment Methods

vehicles/src/common/helper/format-template-data.helper.ts

@@ -89,12 +89,15 @@ export const formatTemplateData = (
   template.clientNumber = companyInfo.clientNumber;
   template.companyAlternateName = companyInfo.alternateName;
 
-  // Format Fee Summary
   const transcation = permit.permitTransactions?.at(0)?.transaction;
 
+  // Format Fee Summary
   template.permitData.feeSummary = formatAmount(
     transcation.transactionTypeId,
-    permit.permitTransactions?.at(0)?.transactionAmount,
+    permit.permitTransactions?.reduce(
+      (accumulator, item) => accumulator + item.transactionAmount,
+      0,
+    ),
   ).toString();
 
   if (permit.revision > 0) {

vehicles/src/modules/permit-application-payment/payment/dto/common/payment-transaction.dto.ts

@@ -0,0 +1,67 @@
+import { AutoMap } from '@automapper/classes';
+import { ApiProperty } from '@nestjs/swagger';
+import {
+  IsEnum,
+  IsNumber,
+  IsOptional,
+  IsString,
+  Length,
+  MaxLength,
+  Min,
+} from 'class-validator';
+import { PaymentCardType } from '../../../../../common/enum/payment-card-type.enum';
+import { PaymentMethodType } from '../../../../../common/enum/payment-method-type.enum';
+
+export class PaymentTransactionDto {
+  @AutoMap()
+  @ApiProperty({
+    example: '10000148',
+    required: false,
+    description:
+      'Bambora-assigned eight-digit unique id number used to identify an individual transaction.',
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(20)
+  pgTransactionId: string;
+
+  @AutoMap()
+  @ApiProperty({
+    example: 'CC',
+    required: false,
+    description: 'Represents the payment method of a transaction.',
+  })
+  @IsOptional()
+  @IsString()
+  @Length(1, 2)
+  pgPaymentMethod: string;
+
+  @AutoMap()
+  @ApiProperty({
+    example: '30.00',
+    description: 'Represents the amount of the transaction.',
+  })
+  @IsNumber()
+  @Min(0)
+  transactionAmount: number;
+
+  @AutoMap()
+  @ApiProperty({
+    enum: PaymentMethodType,
+    example: PaymentMethodType.WEB,
+    description: 'The identifier of the user selected payment method.',
+  })
+  @IsEnum(PaymentMethodType)
+  paymentMethodTypeCode: PaymentMethodType;
+
+  @AutoMap()
+  @ApiProperty({
+    example: PaymentCardType.VISA,
+    enum: PaymentCardType,
+    description: 'The payment types.',
+    required: false,
+  })
+  @IsOptional()
+  @IsEnum(PaymentCardType)
+  paymentCardTypeCode?: PaymentCardType;
+}

vehicles/src/modules/permit-application-payment/payment/dto/request/create-refund-transaction.dto.ts

@@ -0,0 +1,35 @@
+import { AutoMap } from '@automapper/classes';
+import { ApiProperty } from '@nestjs/swagger';
+import {
+  ArrayMinSize,
+  IsArray,
+  IsNumberString,
+  MaxLength,
+  ValidateNested,
+} from 'class-validator';
+
+import { PaymentTransactionDto } from '../common/payment-transaction.dto';
+import { Type } from 'class-transformer';
+
+export class CreateRefundTransactionDto {
+  @AutoMap()
+  @ApiProperty({
+    description: 'Application/Permit Id.',
+    example: '1',
+  })
+  @IsNumberString()
+  @MaxLength(20)
+  applicationId: string;
+
+  @AutoMap()
+  @ApiProperty({
+    description: 'The transaction details specific to application/permit.',
+    required: true,
+    type: [PaymentTransactionDto],
+  })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @ArrayMinSize(1)
+  @Type(() => PaymentTransactionDto)
+  transactions: PaymentTransactionDto[];
+}

vehicles/src/modules/permit-application-payment/payment/entities/receipt.entity.ts

@@ -1,10 +1,5 @@
 import { ApiProperty } from '@nestjs/swagger';
-import {
-  Entity,
-  Column,
-  PrimaryGeneratedColumn,
-  OneToMany,
-} from 'typeorm';
+import { Entity, Column, PrimaryGeneratedColumn, OneToMany } from 'typeorm';
 import { AutoMap } from '@automapper/classes';
 import { Base } from '../../../common/entities/base.entity';
 import { Transaction } from './transaction.entity';

vehicles/src/modules/permit-application-payment/payment/payment.controller.ts

@@ -37,6 +37,7 @@ import {
   CLIENT_USER_ROLE_LIST,
   IDIRUserRole,
 } from '../../../common/enum/user-role.enum';
+import { CreateRefundTransactionDto } from './dto/request/create-refund-transaction.dto';
 
 @ApiBearerAuth()
 @ApiTags('Payment')
@@ -90,6 +91,34 @@ export class PaymentController {
     return paymentDetails;
   }
 
+  @ApiCreatedResponse({
+    description: 'The Transaction Resource',
+    isArray: true,
+    type: ReadTransactionDto,
+  })
+  @Permissions({
+    allowedIdirRoles: [
+      IDIRUserRole.PPC_CLERK,
+      IDIRUserRole.SYSTEM_ADMINISTRATOR,
+      IDIRUserRole.CTPO,
+    ],
+  })
+  @Post('refund')
+  async createRefundTransactionDetails(
+    @Req() request: Request,
+    @Body() { applicationId, transactions }: CreateRefundTransactionDto,
+  ): Promise<ReadTransactionDto[]> {
+    const currentUser = request.user as IUserJWT;
+
+    const paymentDetails = await this.paymentService.createRefundTransactions({
+      currentUser,
+      applicationId,
+      transactions,
+    });
+
+    return paymentDetails;
+  }
+
   @ApiOkResponse({
     description: 'The Payment Gateway Transaction Resource',
     type: UpdatePaymentGatewayTransactionDto,