support for paymentAttemptId (#52)

* remove idempotencyKey

* left deprecated method

Author: cesar-sosa-hol

android/src/main/kotlin/com/squareup/square_mobile_payments_sdk/modules/SettingsModule.kt

@@ -64,9 +64,8 @@ class SettingsModule {
             result.success(consentState.name)
         }
         @JvmStatic
-        @JvmStatic
         fun updateTrackingConsent(result: MethodChannel.Result, granted: Boolean) {
-            settingsManager.updateTrackingConsent(granted) // Assuming the method name is similar
+            settingsManager.updateTrackingConsent(granted)
             result.success(true)
         }
 

example/lib/donut_counter_screen.dart

@@ -21,15 +21,15 @@ class _DonutCounterScreenState extends State<DonutCounterScreen> {
 
   _onBuy(BuildContext context, int amount) async {
     try {
-      String idempotencyKey = uuid.v4();
+      String paymentAttemptId = uuid.v4();
 
       Payment payment = await _squareMobilePaymentsSdkPlugin.paymentManager
           .startPayment(
               PaymentParameters(
                 processingMode: 0,
                   amountMoney:
                       Money(amount: amount, currencyCode: CurrencyCode.eur),
-                  idempotencyKey: idempotencyKey),
+                  paymentAttemptId: paymentAttemptId),
               PromptParameters(
                   additionalPaymentMethods: List.empty(),
                   mode: PromptMode.defaultMode));

ios/Classes/Mappers/PaymentMapper.swift

@@ -20,7 +20,6 @@ public class PaymentMapper {
             let amountMoney = paymentParameters["amountMoney"] as? [String: Any],
             let amount = amountMoney["amount"] as? UInt,
             let currencyCode = amountMoney["currencyCode"] as? String,
-            let idempotencyKey = paymentParameters["idempotencyKey"] as? String,
             let processingMode = paymentParameters["processingMode"] as? Int
         else {
             fatalError("Error: Missing or invalid required payment parameters")
@@ -32,13 +31,26 @@ public class PaymentMapper {
         // Create the amountMoney object
         let money = Money(amount: amount, currency: currency)
 
-        // Initialize PaymentParameters with required fields
-        var paymentParams = PaymentParameters(
-            idempotencyKey: idempotencyKey,
-            amountMoney: money,
-            processingMode: ProcessingMode(rawValue: processingMode)!
-        )
+        var paymentParams: PaymentParameters? = nil
+        if let paymentAttemptID = paymentParameters["paymentAttemptId"] as? String{
+            paymentParams = PaymentParameters(
+                paymentAttemptID: paymentAttemptID,
+                amountMoney: money,
+                processingMode: ProcessingMode(rawValue: processingMode)!
+            )
+        }
+        else if let idempotencyKey = paymentParameters["idempotencyKey"] as? String {
+            paymentParams = PaymentParameters(
+                idempotencyKey: idempotencyKey,
+                amountMoney: money,
+                processingMode: ProcessingMode(rawValue: processingMode)!
+            )
+        }
 
+        guard let paymentParams
+        else {
+                fatalError("Error: Missing or invalid required payment parameters")
+        }
         // Optional: appFeeMoney
         if let appFeeMoney = paymentParameters["appFeeMoney"] as? [String: Any],
            let appFeeAmount = appFeeMoney["amount"] as? UInt,

lib/src/models/models.dart

@@ -191,27 +191,49 @@ class Payment with _$Payment {
       _$PaymentFromJson(json);
 }
 
-@freezed
+@Freezed(unionKey: 'type') // 👈 needed because we have two constructors
 class PaymentParameters with _$PaymentParameters {
+  /// ✅ Current / recommended constructor
+  @FreezedUnionValue('current')
   const factory PaymentParameters({
     int? acceptPartialAuthorization,
     required Money amountMoney,
-    Money? appFeeMoney, 
-    bool? autocomplete, 
-    String? customerId, 
-    DelayAction? delayAction, 
-    num? delayDuration, 
-    required num processingMode, 
-    String? idempotencyKey, 
-    String? paymentAttemptId, 
-    String? locationId, 
+    Money? appFeeMoney,
+    bool? autocomplete,
+    String? customerId,
+    DelayAction? delayAction,
+    num? delayDuration,
+    required num processingMode,
+    required String paymentAttemptId, 
+    String? locationId,
     String? note,
-    String? orderId, 
-    String? referenceId, 
-    String? teamMemberId, 
-    Money? tipMoney, 
+    String? orderId,
+    String? referenceId,
+    String? teamMemberId,
+    Money? tipMoney,
   }) = _PaymentParameters;
 
+  /// ⚠️ Deprecated constructor 
+  @Deprecated('Use the constructor with paymentAttemptId instead.')
+  @FreezedUnionValue('legacy')
+  const factory PaymentParameters.legacy({
+    int? acceptPartialAuthorization,
+    required Money amountMoney,
+    Money? appFeeMoney,
+    bool? autocomplete,
+    String? customerId,
+    DelayAction? delayAction,
+    num? delayDuration,
+    required num processingMode,
+    required String idempotencyKey, 
+    String? locationId,
+    String? note,
+    String? orderId,
+    String? referenceId,
+    String? teamMemberId,
+    Money? tipMoney,
+  }) = _LegacyPaymentParameters;
+
   factory PaymentParameters.fromJson(Map<String, Object?> json) =>
       _$PaymentParametersFromJson(json);
 }