@paydock/client-sdk 1.112.0 → 1.113.2-beta

package/docs/click-to-pay-examples.md

@@ -229,3 +229,39 @@ src.setStyles({
     font_family: 'Arial',
 });
 ```
+
+## Recognition token
+
+In order to store user information for further payments, click to pay provides a recognition token that is used to load user information.
+If you already have a recognitionToken stored, you can use it in meta to load the user information.
+
+### Storage suggestions
+Merchant can store the tokens by dropping the token as a 1st party cookie in the browser, and must ensure to manage all the security aspects around dropping/storing the cookie by following the security standards:
+
+- `Expiration Date=` cookie should be set to expire at a max 180 days
+- `Secure` flag
+- `httpOnly` flag
+- `sameSite=` strict
+- `Value=` recognition token JWT
+
+### Example code
+
+```javascript
+var src = new paydock.ClickToPay(
+    "#checkoutIframe",
+    "service_id",
+    "paydock_public_key",
+    {
+        "recognition_token": "eyJraWQiOiIy...",
+    },
+);
+src.on('recognitionTokenRequested', (data) => {
+    console.log('Recognition token was found: ' + data.data.recognitionToken);
+    // Add recognition token to your store
+});
+
+src.on('recognitionTokenDropped', () => {
+    console.log('Recognition token was droped');
+    // Delete recognition token from your store
+});
+```

package/docs/click-to-pay.md

@@ -78,6 +78,7 @@ Interface of data used for the Mastercard Checkout. For further information refe
 | [customer.phone.country_code] | <code>string</code> | Customer phone country code (example "1" for US). |
 | [customer.phone.phone] | <code>string</code> | Customer phone number. |
 | [unaccepted_card_type] | <code>string</code> | Used to block a specific card type. Options are 'CREDIT', 'DEBIT'. |
+| [recognition_token] | <code>string</code> | Used for Click to Pay to load user information and preferences. |
 
 <a name="EventData" id="EventData" href="#EventData">&nbsp;</a>
 
@@ -320,6 +321,8 @@ List of available event's name in the Click To Pay checkout lifecycle
 | CHECKOUT_POPUP_CLOSE | <code>string</code> | <code>&quot;checkoutPopupClose&quot;</code> | Event sent when Click To Pay checkout flow is closed, regardless of embedded or windowed mode. |
 | CHECKOUT_COMPLETED | <code>string</code> | <code>&quot;checkoutCompleted&quot;</code> | Event sent on successful checkout by customer. Check [data](#EventDataCheckoutCompletedData) for more information. |
 | CHECKOUT_ERROR | <code>string</code> | <code>&quot;checkoutError&quot;</code> | Event sent on error checkout by customer. Check [data](#EventData) for more information. |
+| RECOGNITION_TOKEN_REQUESTED | <code>string</code> | <code>&quot;recognitionTokenRequested&quot;</code> | Event sent when a recognition token was found on the mastercard SDK response. |
+| RECOGNITION_TOKEN_DROPPED | <code>string</code> | <code>&quot;recognitionTokenDropped&quot;</code> | Event sent when a recognition token needs to be dropped for user be no longer remembered. |
 
 <a name="EVENT_DATA_TYPE" id="EVENT_DATA_TYPE" href="#EVENT_DATA_TYPE">&nbsp;</a>
 

package/package.json

@@ -104,7 +104,7 @@
     }
   },
   "name": "@paydock/client-sdk",
-  "version": "1.112.0",
+  "version": "1.113.2-beta",
   "scripts": {
     "build:doc": "node docs/html/marked.js",
     "build:js": "rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",

package/slate.md

@@ -1922,3 +1922,39 @@ src.setStyles({
     font_family: 'Arial',
 });
 ```
+
+## Recognition token
+
+In order to store user information for further payments, click to pay provides a recognition token that is used to load user information.
+If you already have a recognitionToken stored, you can use it in meta to load the user information.
+
+### Storage suggestions
+Merchant can store the tokens by dropping the token as a 1st party cookie in the browser, and must ensure to manage all the security aspects around dropping/storing the cookie by following the security standards:
+
+- `Expiration Date=` cookie should be set to expire at a max 180 days
+- `Secure` flag
+- `httpOnly` flag
+- `sameSite=` strict
+- `Value=` recognition token JWT
+
+### Example code
+
+```javascript
+var src = new paydock.ClickToPay(
+    "#checkoutIframe",
+    "service_id",
+    "paydock_public_key",
+    {
+        "recognition_token": "eyJraWQiOiIy...",
+    },
+);
+src.on('recognitionTokenRequested', (data) => {
+    console.log('Recognition token was found: ' + data.data.recognitionToken);
+    // Add recognition token to your store
+});
+
+src.on('recognitionTokenDropped', () => {
+    console.log('Recognition token was droped');
+    // Delete recognition token from your store
+});
+```