@paydock/client-sdk 1.138.1 → 1.139.0-beta

package/README.md

@@ -3565,7 +3565,7 @@ Registers a callback function to be invoked when the wallet button gets clicked.
 There are two operational modes supported, Synchronous and Asynchronous.
 When asynchronous operations need to occur on the callback handler, attaching the Promise via `attachResult` is required to have the wallet wait for a result.
 When synchronous operations occur on the callback handler, attaching a boolean result via `attachResult` is optional to control the execution flow.
-Note this is supported for Paypal, GooglePay and ApplePay wallet buttons at the moment.
+Note this is supported for Paypal, GooglePay, ApplePay, Afterpay and FlypayV2 wallet buttons at the moment.
 
 **Kind**: instance method of [<code>WalletButtons</code>](#WalletButtons)  
 
@@ -6655,7 +6655,7 @@ Widget that collect browser-based data to help reduce fraud. Upon checkout, thes
 The general flow to use the widgets is:
 1. Initialize the PayPal Data Collector Widget, providing a Source Website Identifier (Flow ID), plus optional config parameters for the widget. The general format is:
 ```js
-vat paypalDataCollector = new paydock.PayPalDataCollector(
+var paypalDataCollector = new paydock.PayPalDataCollector(
     sourceWebsiteIdentifier,
     widgetConfigParams,
 );
@@ -6666,7 +6666,7 @@ const collectedDeviceData = await paypalDataCollector.collectDeviceData();
 const correlationId = collectedDeviceData.correlation_id;
 ```
 3. Use freely the correlation_id value as is needed.
-4. Handle the `onError` callback.
+4. Handle the `onError` callback. The error handler is set up before scripts are loaded to prevent race conditions where script load failures occur before the promise rejection handler is assigned.
 5. If you are using Content Security Policy (CSP), you must allowlist the paypal fraudnet script URL: `https://c.paypal.com`. See reference [here](https://developer.paypal.com/limited-release/fraudnet/integrate/#link-contentsecuritypolicyintegration).
 
 ### PayPalDataCollector Widget example
@@ -6699,11 +6699,16 @@ A full description of the config parameters for [PayPalDataCollector](#PayPalDat
         console.log("On Error Callback", error);
     });
 
-    payPalDataCollector.collectDeviceData().then(function(collectedDeviceData) {
-      //Here when the promise is resolved, it should be able to see the correlation_id.
-      const correlationId = collectedDeviceData.correlation_id;
-      console.log("On Success", correlationId);
-    });
+    payPalDataCollector.collectDeviceData()
+        .then(function(collectedDeviceData) {
+            //Here when the promise is resolved, it should be able to see the correlation_id.
+            const correlationId = collectedDeviceData.correlation_id;
+            console.log("On Success", correlationId);
+        })
+        .catch(function(error) {
+            // Handle promise rejection if script loading fails
+            console.log("Promise rejected", error);
+        });
 </script>
 </html>
 ```
@@ -6805,12 +6810,22 @@ the correlation id used among the requests asynchronously.
 
 **Kind**: instance method of [<code>PayPalDataCollector</code>](#PayPalDataCollector)  
 **Returns**: [<code>Promise.&lt;CollectedDeviceData&gt;</code>](#CollectedDeviceData) - Promise when resolved, returns an object
-that contains the `correlation_id` key.  
+that contains the `correlation_id` key. The promise may be rejected if script loading fails.  
 **Example**  
 ```js
 const collectedDeviceData = await payPalDataCollectorWidget.collectDeviceData();
 console.log(collectedDeviceData.correlation_id)
 ```
+**Example**  
+```js
+payPalDataCollectorWidget.collectDeviceData()
+  .then((collectedDeviceData) => {
+    console.log(collectedDeviceData.correlation_id);
+  })
+  .catch((error) => {
+    console.error('Failed to collect device data', error);
+  });
+```
 <a name="PayPalDataCollector+onError" id="PayPalDataCollector+onError" href="#PayPalDataCollector+onError">&nbsp;</a>
 
 ### payPalDataCollector.onError([callback])