@kenyaemr/esm-billing-app 5.3.10-pre.1650 → 5.3.10-pre.1652

package/dist/routes.json

@@ -1 +1 @@
-{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemr":"^19.0.0"},"pages":[{"component":"billableServicesHome","route":"billable-services"},{"component":"requirePaymentModal","routeRegex":"^patient/.+/chart","online":true,"offline":false}],"extensions":[{"component":"billingDashboardLink","name":"billing-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"billing","title":"billing","slot":"billing-dashboard-slot"}},{"component":"benefitsPackageDashboardLink","name":"benefits-package-dashboard-link","slot":"patient-chart-dashboard-slot","meta":{"name":"benefits-package","slot":"patient-chart-benefits-dashboard-slot","path":"insurance-benefits","columns":1,"columnSpan":1},"featureFlag":"healthInformationExchange"},{"component":"benefitsPackage","name":"benefits-package","slot":"patient-chart-benefits-dashboard-slot"},{"component":"root","name":"billing-dashboard-root","slot":"billing-dashboard-slot"},{"component":"benefitsEligibilyRequestForm","name":"benefits-eligibility-request-form"},{"component":"benefitsPreAuthForm","name":"benefits-pre-auth-form"},{"name":"billing-patient-summary","component":"billingPatientSummary","slot":"patient-chart-billing-dashboard-slot","order":10,"meta":{"columnSpan":4}},{"name":"billing-summary-dashboard-link","component":"billingSummaryDashboardLink","slot":"patient-chart-dashboard-slot","order":11,"meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-billing-dashboard-slot","path":"Billing","layoutMode":"anchored"}},{"name":"billing-check-in-form","slot":"extra-visit-attribute-slot","component":"billingCheckInForm"},{"name":"require-billing-modal","component":"requirePaymentModal"},{"name":"patient-banner-billing-tags","component":"visitAttributeTags","slot":"patient-banner-tags-slot","order":2},{"name":"initiate-payment-modal","component":"initiatePaymentDialog"},{"name":"delete-billableservice-modal","component":"deleteBillableServiceModal"},{"name":"refund-bill-modal","component":"refundBillModal"},{"name":"delete-bill-modal","component":"deleteBillModal"},{"name":"lab-order-billable-item","component":"labOrder","slot":"top-of-lab-order-form-slot"},{"name":"procedure-order-billable-item","component":"procedureOrder","slot":"top-of-procedure-order-form-slot"},{"name":"imaging-order-billable-item","component":"imagingOrder","slot":"top-of-imaging-order-form-slot"},{"name":"price-info-order","component":"priceInfoOrder"},{"name":"drug-order-billable-item","component":"drugOrder","slot":"medication-info-slot"},{"name":"billing-test-order-action","component":"testOrderAction","slot":"tests-ordered-actions-slot","order":0},{"component":"billingOverviewLink","name":"billing-overview-link","slot":"billing-dashboard-link-slot"},{"component":"paymentHistoryLink","name":"payment-history-link","slot":"billing-dashboard-link-slot"},{"component":"paymentPointsLink","name":"payment-points-link","slot":"billing-dashboard-link-slot"},{"component":"paymentModesLink","name":"payment-modes-link","slot":"billing-dashboard-link-slot"},{"component":"billManagerLink","name":"bill-manager-link","slot":"billing-dashboard-link-slot"},{"component":"chargeableItemsLink","name":"chargeable-items-link","slot":"billing-dashboard-link-slot"},{"component":"billableExemptionsLink","name":"billable-exemptions-link","slot":"billing-dashboard-link-slot"},{"component":"claimsManagementSideNavGroup","name":"claims-management-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"claims-management","title":"Claims management Overview","slot":"case-management-slot"},"featureFlag":"healthInformationExchange"},{"component":"claimsManagementOverviewDashboardLink","name":"claims-management-overview-link","slot":"claims-management-dashboard-link-slot"},{"component":"preAuthRequestsDashboardLink","name":"preauthrequest-overview-link","slot":"claims-management-dashboard-link-slot"},{"component":"claimsOverview","name":"claims-overview-dashboard-link","slot":"claims-management-overview-slot"},{"component":"waiveBillActionButton","name":"waive-bill-action-button","slot":"bill-actions-slot"},{"component":"deleteBillActionButton","name":"delete-bill-action-button","slot":"bill-actions-slot"},{"component":"refundLineItem","name":"refund-line-item","slot":"bill-actions-overflow-menu-slot"},{"name":"edit-line-item","component":"editLineItem","slot":"bill-actions-overflow-menu-slot"},{"name":"cancel-line-item","component":"cancelLineItem","slot":"bill-actions-overflow-menu-slot"}],"workspaces":[{"name":"waive-bill-form","component":"waiveBillForm","title":"Waive Bill Form","type":"other-form"},{"name":"edit-bill-form","component":"editBillForm","title":"Edit Bill Form","type":"other-form"},{"name":"billable-service-form","component":"addServiceForm","title":"Create Charge Item Form","type":"other-form"},{"name":"commodity-form","component":"addCommodityForm","title":"Create Charge Item Form","type":"other-form"},{"name":"billing-form","component":"billingForm","title":"Billing Form","type":"other-form","width":"extra-wide"},{"name":"payment-mode-workspace","component":"paymentModeWorkspace","title":"Payment Mode Workspace","type":"other-form"},{"name":"cancel-bill-workspace","component":"cancelBillWorkspace","title":"Cancel Bill Workspace","type":"other-form"}],"modals":[{"name":"create-payment-point","component":"createPaymentPoint"},{"name":"clock-in-modal","component":"clockIn"},{"name":"clock-out-modal","component":"clockOut"},{"name":"bulk-import-billable-services-modal","component":"bulkImportBillableServicesModal"},{"name":"delete-payment-mode-modal","component":"deletePaymentModeModal"},{"name":"retry-claim-request-modal","component":"retryClaimRequestModal"},{"name":"paid-bill-receipt-print-preview-modal","component":"paidBillReceiptPrintPreviewModal"}],"version":"5.3.10-pre.1650"}
+{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemr":"^19.0.0"},"pages":[{"component":"billableServicesHome","route":"billable-services"},{"component":"requirePaymentModal","routeRegex":"^patient/.+/chart","online":true,"offline":false}],"extensions":[{"component":"billingDashboardLink","name":"billing-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"billing","title":"billing","slot":"billing-dashboard-slot"}},{"component":"benefitsPackageDashboardLink","name":"benefits-package-dashboard-link","slot":"patient-chart-dashboard-slot","meta":{"name":"benefits-package","slot":"patient-chart-benefits-dashboard-slot","path":"insurance-benefits","columns":1,"columnSpan":1},"featureFlag":"healthInformationExchange"},{"component":"benefitsPackage","name":"benefits-package","slot":"patient-chart-benefits-dashboard-slot"},{"component":"root","name":"billing-dashboard-root","slot":"billing-dashboard-slot"},{"component":"benefitsEligibilyRequestForm","name":"benefits-eligibility-request-form"},{"component":"benefitsPreAuthForm","name":"benefits-pre-auth-form"},{"name":"billing-patient-summary","component":"billingPatientSummary","slot":"patient-chart-billing-dashboard-slot","order":10,"meta":{"columnSpan":4}},{"name":"billing-summary-dashboard-link","component":"billingSummaryDashboardLink","slot":"patient-chart-dashboard-slot","order":11,"meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-billing-dashboard-slot","path":"Billing","layoutMode":"anchored"}},{"name":"billing-check-in-form","slot":"extra-visit-attribute-slot","component":"billingCheckInForm"},{"name":"require-billing-modal","component":"requirePaymentModal"},{"name":"patient-banner-billing-tags","component":"visitAttributeTags","slot":"patient-banner-tags-slot","order":2},{"name":"initiate-payment-modal","component":"initiatePaymentDialog"},{"name":"delete-billableservice-modal","component":"deleteBillableServiceModal"},{"name":"refund-bill-modal","component":"refundBillModal"},{"name":"delete-bill-modal","component":"deleteBillModal"},{"name":"lab-order-billable-item","component":"labOrder","slot":"top-of-lab-order-form-slot"},{"name":"procedure-order-billable-item","component":"procedureOrder","slot":"top-of-procedure-order-form-slot"},{"name":"imaging-order-billable-item","component":"imagingOrder","slot":"top-of-imaging-order-form-slot"},{"name":"price-info-order","component":"priceInfoOrder"},{"name":"drug-order-billable-item","component":"drugOrder","slot":"medication-info-slot"},{"name":"billing-test-order-action","component":"testOrderAction","slot":"tests-ordered-actions-slot","order":0},{"component":"billingOverviewLink","name":"billing-overview-link","slot":"billing-dashboard-link-slot"},{"component":"paymentHistoryLink","name":"payment-history-link","slot":"billing-dashboard-link-slot"},{"component":"paymentPointsLink","name":"payment-points-link","slot":"billing-dashboard-link-slot"},{"component":"paymentModesLink","name":"payment-modes-link","slot":"billing-dashboard-link-slot"},{"component":"billManagerLink","name":"bill-manager-link","slot":"billing-dashboard-link-slot"},{"component":"chargeableItemsLink","name":"chargeable-items-link","slot":"billing-dashboard-link-slot"},{"component":"billableExemptionsLink","name":"billable-exemptions-link","slot":"billing-dashboard-link-slot"},{"component":"claimsManagementSideNavGroup","name":"claims-management-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"claims-management","title":"Claims management Overview","slot":"case-management-slot"},"featureFlag":"healthInformationExchange"},{"component":"claimsManagementOverviewDashboardLink","name":"claims-management-overview-link","slot":"claims-management-dashboard-link-slot"},{"component":"preAuthRequestsDashboardLink","name":"preauthrequest-overview-link","slot":"claims-management-dashboard-link-slot"},{"component":"claimsOverview","name":"claims-overview-dashboard-link","slot":"claims-management-overview-slot"},{"component":"waiveBillActionButton","name":"waive-bill-action-button","slot":"bill-actions-slot"},{"component":"deleteBillActionButton","name":"delete-bill-action-button","slot":"bill-actions-slot"},{"component":"refundLineItem","name":"refund-line-item","slot":"bill-actions-overflow-menu-slot"},{"name":"edit-line-item","component":"editLineItem","slot":"bill-actions-overflow-menu-slot"},{"name":"cancel-line-item","component":"cancelLineItem","slot":"bill-actions-overflow-menu-slot"}],"workspaces":[{"name":"waive-bill-form","component":"waiveBillForm","title":"Waive Bill Form","type":"other-form"},{"name":"edit-bill-form","component":"editBillForm","title":"Edit Bill Form","type":"other-form"},{"name":"billable-service-form","component":"addServiceForm","title":"Create Charge Item Form","type":"other-form"},{"name":"commodity-form","component":"addCommodityForm","title":"Create Charge Item Form","type":"other-form"},{"name":"billing-form","component":"billingForm","title":"Billing Form","type":"other-form","width":"extra-wide"},{"name":"payment-mode-workspace","component":"paymentModeWorkspace","title":"Payment Mode Workspace","type":"other-form"},{"name":"cancel-bill-workspace","component":"cancelBillWorkspace","title":"Cancel Bill Workspace","type":"other-form"}],"modals":[{"name":"create-payment-point","component":"createPaymentPoint"},{"name":"clock-in-modal","component":"clockIn"},{"name":"clock-out-modal","component":"clockOut"},{"name":"bulk-import-billable-services-modal","component":"bulkImportBillableServicesModal"},{"name":"delete-payment-mode-modal","component":"deletePaymentModeModal"},{"name":"retry-claim-request-modal","component":"retryClaimRequestModal"},{"name":"paid-bill-receipt-print-preview-modal","component":"paidBillReceiptPrintPreviewModal"}],"version":"5.3.10-pre.1652"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenyaemr/esm-billing-app",
-  "version": "5.3.10-pre.1650",
+  "version": "5.3.10-pre.1652",
   "description": "Billing app for KenyaEMR",
   "browser": "dist/kenyaemr-esm-billing-app.js",
   "main": "src/index.ts",

package/src/billable-services/payment-history/payment-history-table.component.tsx

@@ -59,7 +59,10 @@ export const PaymentHistoryTable = ({
     return {
       ...row,
       totalAmount: convertToCurrency(row.payments.reduce((acc, payment) => acc + payment.amountTendered, 0)),
-      referenceCodes: row.payments.map(({ attributes }) => attributes.map(({ value }) => value).join(' ')).join(', '),
+      referenceCodes: row.payments
+        .map(({ attributes }) => attributes.map(({ value }) => value).join(', '))
+        .filter((code) => code !== '')
+        .join(', '),
     };
   });
 
@@ -83,6 +86,7 @@ export const PaymentHistoryTable = ({
         'Total Amount Paid': row.payments.reduce((acc, payment) => acc + payment.amountTendered, 0),
         'Reason/Reference': row.payments
           .map(({ attributes }) => attributes.map(({ value }) => value).join(' '))
+          .filter((code) => code !== '')
           .join(', '),
       };
     });

package/src/hooks/usePaymentSchema.tsx

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { type MappedBill } from '../types';
+
+export function usePaymentSchema(bill: MappedBill) {
+  const paymentSchema = z
+    .object({
+      method: z
+        .object({
+          uuid: z.string(),
+          name: z.string(),
+          attributeTypes: z.array(
+            z.object({
+              uuid: z.string(),
+              description: z.string(),
+              required: z.boolean(),
+            }),
+          ),
+        })
+        .nullable()
+        .refine((val) => val !== null, { message: 'Payment method is required' }),
+      amount: z.number().refine((value) => {
+        const amountDue = Number(bill.totalAmount) - (Number(bill.tenderedAmount) + Number(value));
+        return amountDue >= 0 && value > 0;
+      }, 'Amount paid should not be greater than amount due'),
+      referenceCode: z.string(),
+    })
+    .refine(
+      (data) => {
+        const hasRequiredAttribute = data.method?.attributeTypes.some((attr) => attr.required === true);
+        if (hasRequiredAttribute) {
+          return data.referenceCode.trim().length > 0;
+        }
+        return true;
+      },
+      {
+        message: 'Reference code is required for this payment method',
+        path: ['referenceCode'],
+      },
+    );
+
+  return paymentSchema;
+}

package/src/invoice/payments/payment-form/payment-form.component.tsx

@@ -6,12 +6,12 @@ import { Button, Dropdown, NumberInputSkeleton, TextInput, NumberInput } from '@
 import { ErrorState } from '@openmrs/esm-patient-common-lib';
 import styles from './payment-form.scss';
 import { usePaymentModes } from '../../../billing.resource';
-import { PaymentFormValue } from '../../../types';
+import { PaymentFormValue, PaymentMethod } from '../../../types';
 
 type PaymentFormProps = {
   disablePayment: boolean;
   amountDue: number;
-  append: (obj: { method: string; amount: number; referenceCode: string }) => void;
+  append: (obj: { method: PaymentMethod; amount: number; referenceCode: string }) => void;
   fields: FieldArrayWithId<PaymentFormValue, 'payment', 'id'>[];
   remove: UseFieldArrayRemove;
 };
@@ -22,12 +22,18 @@ const PaymentForm: React.FC<PaymentFormProps> = ({ disablePayment, amountDue, ap
     control,
     formState: { errors },
     setFocus,
+    getValues,
   } = useFormContext<PaymentFormValue>();
   const { paymentModes, isLoading, error } = usePaymentModes();
 
+  const shouldShowReferenceCode = (index: number) => {
+    const formValues = getValues();
+    return formValues?.payment?.[index]?.method?.attributeTypes?.some((attribute) => attribute.required);
+  };
+
   const handleAppendPaymentMode = useCallback(() => {
     {
-      append({ method: '', amount: 0, referenceCode: '' });
+      append({ method: null, amount: 0, referenceCode: '' });
       setFocus(`payment.${fields.length}.method`);
     }
   }, [append]);
@@ -59,7 +65,7 @@ const PaymentForm: React.FC<PaymentFormProps> = ({ disablePayment, amountDue, ap
                 id="paymentMethod"
                 onChange={({ selectedItem }) => {
                   setFocus(`payment.${index}.amount`);
-                  field.onChange(selectedItem?.uuid);
+                  field.onChange(selectedItem);
                 }}
                 titleText={t('paymentMethod', 'Payment method')}
                 label={t('selectPaymentMethod', 'Select payment method')}
@@ -85,19 +91,23 @@ const PaymentForm: React.FC<PaymentFormProps> = ({ disablePayment, amountDue, ap
               />
             )}
           />
-          <Controller
-            name={`payment.${index}.referenceCode`}
-            control={control}
-            render={({ field }) => (
-              <TextInput
-                {...field}
-                id="paymentReferenceCode"
-                labelText={t('referenceNumber', 'Reference number')}
-                placeholder={t('enterReferenceNumber', 'Enter ref. number')}
-                type="text"
-              />
-            )}
-          />
+          {shouldShowReferenceCode(index) && (
+            <Controller
+              name={`payment.${index}.referenceCode`}
+              control={control}
+              render={({ field }) => (
+                <TextInput
+                  {...field}
+                  id="paymentReferenceCode"
+                  labelText={t('referenceNumber', 'Reference number')}
+                  placeholder={t('enterReferenceNumber', 'Enter ref. number')}
+                  type="text"
+                  invalid={!!errors?.payment?.[index]?.referenceCode}
+                  invalidText={errors?.payment?.[index]?.referenceCode?.message}
+                />
+              )}
+            />
+          )}
           <div className={styles.removeButtonContainer}>
             <TrashCan onClick={() => handleRemovePaymentMode(index)} className={styles.removeButton} size={20} />
           </div>

package/src/invoice/payments/payments.component.tsx

@@ -1,8 +1,8 @@
+import React from 'react';
 import { Button, InlineNotification } from '@carbon/react';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { navigate, showSnackbar } from '@openmrs/esm-framework';
 import { CardHeader } from '@openmrs/esm-patient-common-lib';
-import React, { useState } from 'react';
 import { FormProvider, useFieldArray, useForm, useWatch } from 'react-hook-form';
 import { useTranslation } from 'react-i18next';
 import { mutate } from 'swr';
@@ -17,6 +17,7 @@ import PaymentForm from './payment-form/payment-form.component';
 import PaymentHistory from './payment-history/payment-history.component';
 import styles from './payments.scss';
 import { createPaymentPayload } from './utils';
+import { usePaymentSchema } from '../../hooks/usePaymentSchema';
 
 type PaymentProps = {
   bill: MappedBill;
@@ -25,18 +26,11 @@ type PaymentProps = {
 
 const Payments: React.FC<PaymentProps> = ({ bill, selectedLineItems }) => {
   const { t } = useTranslation();
-  const paymentSchema = z.object({
-    method: z.string().refine((value) => !!value, 'Payment method is required'),
-    amount: z.number().refine((value) => {
-      const amountDue = Number(bill.totalAmount) - (Number(bill.tenderedAmount) + Number(value));
-      return amountDue >= 0;
-    }, 'Amount paid should not be greater than amount due'),
-    referenceCode: z.union([z.number(), z.string()]).optional(),
-  });
+  const paymentSchema = usePaymentSchema(bill);
   const { globalActiveSheet } = useClockInStatus();
 
   const methods = useForm<PaymentFormValue>({
-    mode: 'all',
+    mode: 'onSubmit',
     defaultValues: { payment: [] },
     resolver: zodResolver(z.object({ payment: z.array(paymentSchema) })),
   });
@@ -46,7 +40,6 @@ const Payments: React.FC<PaymentProps> = ({ bill, selectedLineItems }) => {
     name: 'payment',
     control: methods.control,
   });
-  const [paymentSuccessful, setPaymentSuccessful] = useState(false);
 
   const totalWaivedAmount = computeWaivedAmount(bill);
   const totalAmountTendered = formValues?.reduce((curr: number, prev) => curr + Number(prev.amount), 0) ?? 0;
@@ -85,7 +78,6 @@ const Payments: React.FC<PaymentProps> = ({ bill, selectedLineItems }) => {
         });
         const url = `/ws/rest/v1/cashier/bill/${bill.uuid}`;
         mutate((key) => typeof key === 'string' && key.startsWith(url), undefined, { revalidate: true });
-        setPaymentSuccessful(true);
       },
       (error) => {
         showSnackbar({
@@ -123,7 +115,7 @@ const Payments: React.FC<PaymentProps> = ({ bill, selectedLineItems }) => {
               <InlineNotification
                 title={t('incompletePayment', 'Incomplete payment')}
                 subtitle={t(
-                  'paymentErrorSubtitle',
+                  'incompletePaymentSubtitle',
                   'Please ensure all selected line items are fully paid, Total amount expected is {{selectedLineItemsAmountDue}}',
                   {
                     selectedLineItemsAmountDue: convertToCurrency(selectedLineItemsAmountDue),
@@ -136,9 +128,9 @@ const Payments: React.FC<PaymentProps> = ({ bill, selectedLineItems }) => {
             )}
             {hasAmountPaidExceeded && (
               <InlineNotification
-                title={t('paymentError', 'Payment error')}
+                title={t('overPayment', 'Over payment')}
                 subtitle={t(
-                  'paymentErrorSubtitle',
+                  'overPaymentSubtitle',
                   'Amount paid {{totalAmountTendered}} should not be greater than amount due {{selectedLineItemsAmountDue}} for selected line items',
                   {
                     totalAmountTendered: convertToCurrency(totalAmountTendered),

package/src/invoice/payments/payments.test.tsx

@@ -116,7 +116,7 @@ describe('Payment', () => {
             voided: false,
           },
           {
-            billableService: null,
+            billableService: 'Hemoglobin',
             display: 'BillLineItem',
             item: 'Hemoglobin',
             lineItemOrder: 0,

package/src/invoice/payments/utils.ts

@@ -121,7 +121,10 @@ export const createPaymentPayload = (
   const existingPayments = payments.map((payment) => ({
     amount: payment.amount,
     amountTendered: payment.amountTendered,
-    attributes: [],
+    attributes: payment.attributes.map((attribute) => ({
+      attributeType: attribute.attributeType?.uuid,
+      value: attribute.value,
+    })),
     instanceType: payment.instanceType.uuid,
   }));
 
@@ -129,8 +132,11 @@ export const createPaymentPayload = (
   const currentPayments = paymentFormValues.map((formValue) => ({
     amount: parseFloat(totalAmount.toFixed(2)),
     amountTendered: parseFloat(Number(formValue.amount).toFixed(2)),
-    attributes: [],
-    instanceType: formValue.method,
+    attributes: formValue.method?.attributeTypes?.map((attribute) => ({
+      attributeType: attribute.uuid,
+      value: formValue.referenceCode,
+    })),
+    instanceType: formValue.method?.uuid,
   }));
 
   // Combine and calculate payments
@@ -163,13 +169,20 @@ export const createPaymentPayload = (
       : // If no items were selected, update payment status for all line items
         lineItems.map((lineItem) => ({
           ...lineItem,
-          billableService: extractServiceIdentifier(lineItem),
           item: extractServiceIdentifier(lineItem),
+          billableService: extractServiceIdentifier(lineItem),
           paymentStatus: isBillableItemFullyPaid(totalPaidAmount, lineItem),
         }));
 
   // Combine selected and remaining items into final processed list
-  const processedLineItems = [...processedSelectedBillableItems, ...remainingLineItems];
+  const processedLineItems = [
+    ...processedSelectedBillableItems,
+    ...remainingLineItems.map((item) => ({
+      ...item,
+      item: extractServiceIdentifier(item),
+      billableService: extractServiceIdentifier(item),
+    })),
+  ];
 
   // Determine final bill status
   const hasUnpaidItems = processedLineItems.some((item) => item.paymentStatus === PaymentStatus.PENDING);

package/src/payment-modes/payment-mode.workspace.test.tsx

@@ -86,11 +86,11 @@ describe('PaymentModeWorkspace', () => {
     // key in name, description and retired
     const nameInput = screen.getByRole('textbox', { name: /Payment mode name/i });
     const descriptionInput = screen.getByRole('textbox', { name: /Payment mode description/i });
-    const retiredToggle = screen.getByRole('switch', { name: /Retired/i });
+    const enablePaymentToggle = screen.getByRole('switch', { name: /Enable payment mode/i });
 
     await user.type(nameInput, 'Test Name');
     await user.type(descriptionInput, 'Test Description');
-    await user.click(retiredToggle);
+    await user.click(enablePaymentToggle);
 
     // Click to add attribute type
     const addAttributeTypeButton = screen.getByRole('button', { name: /Add attribute type/i });
@@ -102,7 +102,6 @@ describe('PaymentModeWorkspace', () => {
     const attributeRegExpInput = screen.getByRole('textbox', { name: /Enter regular expression/i });
     const attributeRetiredToggle = screen.getByRole('switch', { name: /Attribute retired/i });
     const attributeRequiredToggle = screen.getByRole('switch', { name: /Attribute required/i });
-    const attributeFormatDropdown = screen.getByRole('combobox', { name: /Attribute format/i });
 
     // Key in attribute type details
     await user.type(attributeTypeNameInput, 'Test Attribute Name');

package/src/payment-modes/payment-mode.workspace.tsx

@@ -167,7 +167,7 @@ const PaymentModeWorkspace: React.FC<PaymentModeWorkspaceProps> = ({
                 render={({ field }) => (
                   <Toggle
                     {...field}
-                    labelText={t('paymentModeRetired', 'Retired')}
+                    labelText={t('enablePaymentMode', 'Enable payment mode')}
                     labelA="Off"
                     labelB="On"
                     toggled={field.value}

package/src/types/index.ts

@@ -290,7 +290,7 @@ export interface Payment {
   resourceVersion: string;
 }
 
-export type FormPayment = { method: string; amount: string | number; referenceCode?: number | string };
+export type FormPayment = { method: PaymentMethod; amount: string | number; referenceCode?: number | string };
 
 export type PaymentFormValue = {
   payment: Array<FormPayment>;

package/translations/en.json

@@ -139,6 +139,7 @@
   "identifier": "Identifier",
   "inactive": "Inactive",
   "incompletePayment": "Incomplete payment",
+  "incompletePaymentSubtitle": "Please ensure all selected line items are fully paid, Total amount expected is {{selectedLineItemsAmountDue}}",
   "initiatePay": "Initiate Payment",
   "inputSampleSchema": "Input sample schema",
   "insuranceScheme": "Insurance scheme",
@@ -186,6 +187,8 @@
   "noTransactionHistorySubtitle": "No transaction history loaded for the selected filters",
   "notSearchedState": "Please search for a patient in the input above",
   "overflowMenu": "Overflow menu",
+  "overPayment": "Over payment",
+  "overPaymentSubtitle": "Amount paid {{totalAmountTendered}} should not be greater than amount due {{selectedLineItemsAmountDue}} for selected line items",
   "package": "Package",
   "packages": "Packages",
   "packagesOptions": "Choose packages",
@@ -199,8 +202,6 @@
   "patientMissingSHAId": "Patient missing SHA identification number",
   "patientMissingSHANumber": "Patient is missing SHA number, SHA validation cannot be done, Advise patient to visit registration desk",
   "patientName": "Patient Name",
-  "paymentError": "Payment error",
-  "paymentErrorSubtitle": "Amount paid {{totalAmountTendered}} should not be greater than amount due {{selectedLineItemsAmountDue}} for selected line items",
   "paymentHistory": "Payment History",
   "paymentMethod": "Payment method",
   "paymentMethodDescription": "Payment method {{methodName}}",