refactor(payment): change payments structure to a single payment object

Author: mokhld

src/server/plugins/engine/outputFormatters/adapter/v1.test.ts

@@ -249,7 +249,6 @@ describe('Adapter v1 formatter', () => {
         exampleField: 'hello world',
         exampleField2: 'hello world'
       },
-      payments: {},
       repeaters: {
         exampleRepeat: [
           {

src/server/plugins/engine/outputFormatters/machine/v2.payment.test.ts

@@ -91,14 +91,12 @@ describe('getPersonalisation', () => {
         licenceLength: 365,
         fullName: 'John Smith'
       },
-      payments: {
-        paymentField: {
-          amount: 250,
-          createdAt: '2026-01-02T11:00:04+0000',
-          description: 'Payment desc',
-          paymentId: 'payment-id',
-          reference: 'payment-ref'
-        }
+      payment: {
+        amount: 250,
+        createdAt: '2026-01-02T11:00:04+0000',
+        description: 'Payment desc',
+        paymentId: 'payment-id',
+        reference: 'payment-ref'
       },
       repeaters: {},
       files: {}

src/server/plugins/engine/outputFormatters/machine/v2.test.ts

@@ -233,7 +233,6 @@ describe('getPersonalisation', () => {
         exampleField: 'hello world',
         exampleField2: 'hello world'
       },
-      payments: {},
       repeaters: {
         exampleRepeat: [
           {
@@ -292,7 +291,6 @@ describe('getPersonalisation', () => {
       main: {
         orderType: 'delivery'
       },
-      payments: {},
       repeaters: {
         pizza: [
           {

src/server/plugins/engine/outputFormatters/machine/v2.ts

@@ -106,8 +106,8 @@ export function categoriseData(items: DetailItem[]) {
       string,
       { fileId: string; fileName: string; userDownloadLink: string }[]
     >
-    payments: Record<string, PaymentOutput>
-  } = { main: {}, repeaters: {}, files: {}, payments: {} }
+    payment?: PaymentOutput
+  } = { main: {}, repeaters: {}, files: {} }
 
   items.forEach((item) => {
     const { name, state } = item
@@ -119,7 +119,7 @@ export function categoriseData(items: DetailItem[]) {
     } else if (isPaymentFieldItem(item)) {
       const payment = extractPayment(item)
       if (payment) {
-        output.payments[name] = payment
+        output.payment = payment
       }
     } else {
       output.main[name] = item.field.getFormValueFromState(state)

src/server/plugins/engine/types.ts

@@ -503,7 +503,7 @@ export interface FormAdapterSubmissionMessageData {
   main: Record<string, RichFormValue | null>
   repeaters: Record<string, Record<string, RichFormValue>[]>
   files: Record<string, FormAdapterFile[]>
-  payments: Record<string, FormAdapterPayment>
+  payment?: FormAdapterPayment
 }
 
 export interface FormAdapterSubmissionMessagePayload {

src/server/plugins/engine/types/schema.test.ts

@@ -56,8 +56,7 @@ describe('Schema validation', () => {
             'http://localhost:3005/file-download/489ecc1b-a145-4618-ba5a-b4a0d5ee2dbd'
         }
       ]
-    },
-    payments: {}
+    }
   }
 
   describe('formAdapterSubmissionMessageMetaSchema', () => {

src/server/plugins/engine/types/schema.ts

@@ -43,7 +43,15 @@ export const formAdapterSubmissionMessageDataSchema =
   Joi.object<FormAdapterSubmissionMessageData>().keys({
     main: Joi.object(),
     repeaters: Joi.object(),
-    payments: Joi.object(),
+    payment: Joi.object()
+      .keys({
+        paymentId: Joi.string().required(),
+        reference: Joi.string().required(),
+        amount: Joi.number().required(),
+        description: Joi.string().required(),
+        createdAt: Joi.string().required()
+      })
+      .optional(),
     files: Joi.object().pattern(
       Joi.string(),
       Joi.array().items(