@paydock/client-sdk 1.140.1 → 1.141.0-beta

package/README.md

@@ -1977,6 +1977,7 @@ Class ZipmoneyCheckoutButton is wrapper of CheckoutButton transform usual button
     * [new ZipmoneyCheckoutButton(selector, publicKey, [gatewayId], [gatewayId])](#user-content-cb_new_ZipmoneyCheckoutButton_new)
     * [.setSuspendedRedirectUri(string)](#user-content-cb_ZipmoneyCheckoutButton+setSuspendedRedirectUri)
     * [.setRedirectUrl(string)](#user-content-cb_ZipmoneyCheckoutButton+setRedirectUrl)
+    * [.onClick(handler)](#user-content-cb_ZipmoneyCheckoutButton+onClick)
     * [.on(eventName, cb)](#user-content-cb_CheckoutButton+on)
     * [.close()](#user-content-cb_CheckoutButton+close)
     * [.onFinishInsert(selector, dataType)](#user-content-cb_CheckoutButton+onFinishInsert)
@@ -2035,6 +2036,27 @@ The merchant's customer would be automatically redirected to this URL after the
 | --- | --- | --- |
 | string | <code>url</code> | URL for redirect |
 
+<a name="cb_ZipmoneyCheckoutButton+onClick" id="cb_ZipmoneyCheckoutButton+onClick" href="#user-content-cb_ZipmoneyCheckoutButton+onClick">&nbsp;</a>
+
+### zipmoneyCheckoutButton.onClick(handler)
+Subscribe to the click event with an async handler.
+The checkout flow will wait for the async handler to complete before proceeding.
+If the handler resolves to `false`, the checkout flow will be cancelled.
+
+**Kind**: instance method of [<code>ZipmoneyCheckoutButton</code>](#user-content-cb_ZipmoneyCheckoutButton)  
+
+| Param | Description |
+| --- | --- |
+| handler | Async function to be called when the button is clicked |
+
+**Example**  
+
+```javascript
+button.onClick(async () => {
+    const isValid = await fetchDataFromServer();
+    return isValid; // return false to stop checkout
+});
+```
 <a name="cb_CheckoutButton+on" id="cb_CheckoutButton+on" href="#user-content-cb_CheckoutButton+on">&nbsp;</a>
 
 ### zipmoneyCheckoutButton.on(eventName, cb)