sfcc-dev-mcp 1.0.0

package/docs/dw_extensions.paymentrequest/PaymentRequestHookResult.md

@@ -0,0 +1,159 @@
+## Package: dw.extensions.paymentrequest
+
+# Class PaymentRequestHookResult
+
+## Inheritance Hierarchy
+
+- Object
+  - dw.extensions.paymentrequest.PaymentRequestHookResult
+
+## Description
+
+Result of a hook handling a Payment Request request
+
+## Properties
+
+### eventDetail
+
+**Type:** Object (Read Only)
+
+Detail to the JS custom event to dispatch in response to this result.
+
+### eventName
+
+**Type:** String (Read Only)
+
+Name of the JS custom event to dispatch in response to this result.
+
+### redirect
+
+**Type:** URL (Read Only)
+
+URL to navigate to in response to this result.
+
+### status
+
+**Type:** Status (Read Only)
+
+Status describing the outcome of this result.
+
+## Constructor Summary
+
+PaymentRequestHookResult(status : Status, redirect : URL) Constructs a result with the given outcome information.
+
+## Method Summary
+
+### getEventDetail
+
+**Signature:** `getEventDetail() : Object`
+
+Detail to the JS custom event to dispatch in response to this result.
+
+### getEventName
+
+**Signature:** `getEventName() : String`
+
+Name of the JS custom event to dispatch in response to this result.
+
+### getRedirect
+
+**Signature:** `getRedirect() : URL`
+
+URL to navigate to in response to this result.
+
+### getStatus
+
+**Signature:** `getStatus() : Status`
+
+Status describing the outcome of this result.
+
+### setEvent
+
+**Signature:** `setEvent(name : String) : void`
+
+Sets the name of the JS custom event to dispatch in response to this result.
+
+### setEvent
+
+**Signature:** `setEvent(name : String, detail : Object) : void`
+
+Sets the name and detail of the JS custom event to dispatch in response to this result.
+
+## Constructor Detail
+
+## Method Detail
+
+## Method Details
+
+### getEventDetail
+
+**Signature:** `getEventDetail() : Object`
+
+**Description:** Detail to the JS custom event to dispatch in response to this result.
+
+**Returns:**
+
+event detail
+
+---
+
+### getEventName
+
+**Signature:** `getEventName() : String`
+
+**Description:** Name of the JS custom event to dispatch in response to this result.
+
+**Returns:**
+
+event name
+
+---
+
+### getRedirect
+
+**Signature:** `getRedirect() : URL`
+
+**Description:** URL to navigate to in response to this result.
+
+**Returns:**
+
+redirect URL
+
+---
+
+### getStatus
+
+**Signature:** `getStatus() : Status`
+
+**Description:** Status describing the outcome of this result.
+
+**Returns:**
+
+status of this result
+
+---
+
+### setEvent
+
+**Signature:** `setEvent(name : String) : void`
+
+**Description:** Sets the name of the JS custom event to dispatch in response to this result.
+
+**Parameters:**
+
+- `name`: JS custom event name
+
+---
+
+### setEvent
+
+**Signature:** `setEvent(name : String, detail : Object) : void`
+
+**Description:** Sets the name and detail of the JS custom event to dispatch in response to this result.
+
+**Parameters:**
+
+- `name`: JS custom event name
+- `detail`: JS custom event detail
+
+---

package/docs/dw_extensions.paymentrequest/PaymentRequestHooks.md

@@ -0,0 +1,160 @@
+## Package: dw.extensions.paymentrequest
+
+# Class PaymentRequestHooks
+
+## Inheritance Hierarchy
+
+- dw.extensions.paymentrequest.PaymentRequestHooks
+
+## Description
+
+PaymentRequestHooks interface containing extension points for customizing Payment Requests. These hooks are executed in a transaction. The extension points (hook names), and the functions that are called by each extension point. A function must be defined inside a JavaScript source and must be exported. The script with the exported hook function must be located inside a site cartridge. Inside the site cartridge a 'package.json' file with a 'hooks' entry must exist. "hooks": "./hooks.json" The hooks entry links to a json file, relative to the 'package.json' file. This file lists all registered hooks inside the hooks property: "hooks": [ {"name": "dw.extensions.paymentrequest.getPaymentRequest", "script": "./paymentrequest.ds"} {"name": "dw.extensions.paymentrequest.shippingAddressChange", "script": "./paymentrequest.ds"} ] A hook entry has a 'name' and a 'script' property. The 'name' contains the extension point, the hook name. The 'script' contains the script relative to the hooks file, with the exported hook function.
+
+## Constants
+
+## Properties
+
+## Constructor Summary
+
+## Method Summary
+
+### abort
+
+**Signature:** `abort(basket : Basket) : PaymentRequestHookResult`
+
+Called after the Payment Request user interface was canceled.
+
+### authorizeOrderPayment
+
+**Signature:** `authorizeOrderPayment(order : Order, response : Object) : Status`
+
+Called after the shopper accepts the Payment Request payment for the given order.
+
+### getPaymentRequest
+
+**Signature:** `getPaymentRequest(basket : Basket, parameters : Object) : PaymentRequestHookResult`
+
+Called to get the PaymentRequest constructor parameters for the given basket.
+
+### placeOrder
+
+**Signature:** `placeOrder(order : Order) : PaymentRequestHookResult`
+
+Called after payment has been authorized and the given Payment Request order is ready to be placed.
+
+### shippingAddressChange
+
+**Signature:** `shippingAddressChange(basket : Basket, details : Object) : PaymentRequestHookResult`
+
+Called after handling the Payment Request shippingaddresschange event for the given basket.
+
+### shippingOptionChange
+
+**Signature:** `shippingOptionChange(basket : Basket, shippingMethod : ShippingMethod, details : Object) : PaymentRequestHookResult`
+
+Called after handling the Payment Request shippingoptionchange event for the given basket.
+
+## Method Detail
+
+## Method Details
+
+### abort
+
+**Signature:** `abort(basket : Basket) : PaymentRequestHookResult`
+
+**Description:** Called after the Payment Request user interface was canceled. The given basket is the one that was passed to other hooks earlier in the Payment Request checkout process. It is not guaranteed that this hook will be executed for all Payment Request user interfaces canceled by shoppers or otherwise ended without a successful order. Calls to this hook are provided on a best-effort basis. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if possible. It is not guaranteed that the response with the hook result will be handled in the shopper browser in all cases.
+
+**Parameters:**
+
+- `basket`: the basket that was being checked out using Payment Request
+
+**Returns:**
+
+a non-null result ends the hook execution
+
+---
+
+### authorizeOrderPayment
+
+**Signature:** `authorizeOrderPayment(order : Order, response : Object) : Status`
+
+**Description:** Called after the shopper accepts the Payment Request payment for the given order. Basket customer information, billing address, and/or shipping address for the default shipment will have already been updated to reflect the available contact information provided by Payment Request. Any preexisting payment instruments on the basket will have been removed, and a single DW_ANDROID_PAY payment instrument added for the total amount. The given order will have been created from this updated basket. The purpose of this hook is to authorize the Payment Request payment for the order. If a non-error status is returned that means that you have successfully authorized the payment with your payment service provider. Your hook implementation must set the necessary payment status and transaction identifier data on the order as returned by the provider. Return an error status to indicate a problem, including unsuccessful authorization. See the Payment Request API for more information.
+
+**Parameters:**
+
+- `order`: the order paid using Payment Request
+- `response`: response to the accepted PaymentRequest
+
+**Returns:**
+
+a non-null status ends the hook execution
+
+---
+
+### getPaymentRequest
+
+**Signature:** `getPaymentRequest(basket : Basket, parameters : Object) : PaymentRequestHookResult`
+
+**Description:** Called to get the PaymentRequest constructor parameters for the given basket. You can set properties in the given parameters object to extend or override default properties set automatically based on the Google Pay configuration for your site. The parameters object will contain the following properties by default: methodData - array containing payment methods the web site accepts details - information about the transaction that the user is being asked to complete options - information about what options the web page wishes to use from the payment request system Return a result with an error status to indicate a problem. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Payment Request user interaction is canceled. See the Payment Request API for more information.
+
+**Parameters:**
+
+- `basket`: the basket for the Payment Request request
+- `parameters`: object containing PaymentRequest constructor parameters
+
+**Returns:**
+
+a non-null result ends the hook execution
+
+---
+
+### placeOrder
+
+**Signature:** `placeOrder(order : Order) : PaymentRequestHookResult`
+
+**Description:** Called after payment has been authorized and the given Payment Request order is ready to be placed. The purpose of this hook is to place the order, or return a redirect URL that results in the order being placed when the shopper browser is navigated to it. The default implementation of this hook returns a redirect to COPlaceOrder-Submit with URL parameters order_id set to Order.getOrderNo() and order_token set to Order.getOrderToken() which corresponds to SiteGenesis-based implementations. Your hook implementation should return a result with a different redirect URL as necessary to place the order and show an order confirmation. Alternatively, your hook implementation itself can place the order and return a result with a redirect URL to an order confirmation page that does not place the order. This is inconsistent with SiteGenesis-based implementations so is not the default. Return an error status to indicate a problem. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Payment Request user interface is canceled.
+
+**Parameters:**
+
+- `order`: the order paid using PaymentRequest
+
+**Returns:**
+
+a non-null result ends the hook execution
+
+---
+
+### shippingAddressChange
+
+**Signature:** `shippingAddressChange(basket : Basket, details : Object) : PaymentRequestHookResult`
+
+**Description:** Called after handling the Payment Request shippingaddresschange event for the given basket. Basket customer information and/or shipping address for the default shipment will have already been updated to reflect the available shipping address information provided by Payment Request. The basket will have already been calculated before this hook is called. Return a result with an error status to indicate a problem. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Payment Request user interface is canceled. See the Payment Request API for more information.
+
+**Parameters:**
+
+- `basket`: the basket being checked out using Payment Request
+- `details`: updated PaymentRequest object details
+
+**Returns:**
+
+a non-null result ends the hook execution
+
+---
+
+### shippingOptionChange
+
+**Signature:** `shippingOptionChange(basket : Basket, shippingMethod : ShippingMethod, details : Object) : PaymentRequestHookResult`
+
+**Description:** Called after handling the Payment Request shippingoptionchange event for the given basket. The given shipping method will have already been set on the basket. The basket will have already been calculated before this hook is called. Return a result with an error status to indicate a problem. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Payment Request user interface is canceled. See the Payment Request API for more information.
+
+**Parameters:**
+
+- `basket`: the basket being checked out using Payment Request
+- `shippingMethod`: the shipping method that was selected
+- `details`: updated PaymentRequest object details
+
+**Returns:**
+
+a non-null result ends the hook execution
+
+---

package/docs/dw_extensions.payments/SalesforceBancontactPaymentDetails.md

@@ -0,0 +1,79 @@
+## Package: dw.extensions.payments
+
+# Class SalesforceBancontactPaymentDetails
+
+## Inheritance Hierarchy
+
+- Object
+  - dw.extensions.payments.SalesforcePaymentDetails
+  - dw.extensions.payments.SalesforceBancontactPaymentDetails
+
+## Description
+
+Details to a Salesforce Payments payment of type SalesforcePaymentMethod.TYPE_BANCONTACT. See Salesforce Payments documentation for how to gain access and configure it for use on your sites.
+
+## Properties
+
+### bankName
+
+**Type:** String (Read Only)
+
+The bank name, or null if not known.
+
+### last4
+
+**Type:** String (Read Only)
+
+The last 4 digits of the account number, or null if not known.
+
+## Constructor Summary
+
+## Method Summary
+
+### getBankName
+
+**Signature:** `getBankName() : String`
+
+Returns the bank name, or null if not known.
+
+### getLast4
+
+**Signature:** `getLast4() : String`
+
+Returns the last 4 digits of the account number, or null if not known.
+
+## Method Detail
+
+## Method Details
+
+### getBankName
+
+**Signature:** `getBankName() : String`
+
+**Description:** Returns the bank name, or null if not known.
+
+**Returns:**
+
+bank name
+
+**See Also:**
+
+SalesforcePaymentMethod.getBankName()
+
+---
+
+### getLast4
+
+**Signature:** `getLast4() : String`
+
+**Description:** Returns the last 4 digits of the account number, or null if not known.
+
+**Returns:**
+
+last 4 digits of the account number
+
+**See Also:**
+
+SalesforcePaymentMethod.getLast4()
+
+---

package/docs/dw_extensions.payments/SalesforceCardPaymentDetails.md

@@ -0,0 +1,103 @@
+## Package: dw.extensions.payments
+
+# Class SalesforceCardPaymentDetails
+
+## Inheritance Hierarchy
+
+- Object
+  - dw.extensions.payments.SalesforcePaymentDetails
+  - dw.extensions.payments.SalesforceCardPaymentDetails
+
+## Description
+
+Details to a Salesforce Payments payment of type SalesforcePaymentMethod.TYPE_CARD. See Salesforce Payments documentation for how to gain access and configure it for use on your sites.
+
+## Properties
+
+### brand
+
+**Type:** String (Read Only)
+
+The card brand, or null if not known.
+
+### last4
+
+**Type:** String (Read Only)
+
+The last 4 digits of the card number, or null if not known.
+
+### walletType
+
+**Type:** String (Read Only)
+
+The type of wallet used to make the card payment, or null if not known.
+
+## Constructor Summary
+
+## Method Summary
+
+### getBrand
+
+**Signature:** `getBrand() : String`
+
+Returns the card brand, or null if not known.
+
+### getLast4
+
+**Signature:** `getLast4() : String`
+
+Returns the last 4 digits of the card number, or null if not known.
+
+### getWalletType
+
+**Signature:** `getWalletType() : String`
+
+Returns the type of wallet used to make the card payment, or null if not known.
+
+## Method Detail
+
+## Method Details
+
+### getBrand
+
+**Signature:** `getBrand() : String`
+
+**Description:** Returns the card brand, or null if not known.
+
+**Returns:**
+
+card brand
+
+**See Also:**
+
+SalesforcePaymentMethod.getBrand()
+
+---
+
+### getLast4
+
+**Signature:** `getLast4() : String`
+
+**Description:** Returns the last 4 digits of the card number, or null if not known.
+
+**Returns:**
+
+last 4 digits of the card number
+
+**See Also:**
+
+SalesforcePaymentMethod.getLast4()
+
+---
+
+### getWalletType
+
+**Signature:** `getWalletType() : String`
+
+**Description:** Returns the type of wallet used to make the card payment, or null if not known.
+
+**Returns:**
+
+wallet type
+
+---

package/docs/dw_extensions.payments/SalesforceEpsPaymentDetails.md

@@ -0,0 +1,51 @@
+## Package: dw.extensions.payments
+
+# Class SalesforceEpsPaymentDetails
+
+## Inheritance Hierarchy
+
+- Object
+  - dw.extensions.payments.SalesforcePaymentDetails
+  - dw.extensions.payments.SalesforceEpsPaymentDetails
+
+## Description
+
+Details to a Salesforce Payments payment of type SalesforcePaymentMethod.TYPE_EPS. See Salesforce Payments documentation for how to gain access and configure it for use on your sites.
+
+## Properties
+
+### bank
+
+**Type:** String (Read Only)
+
+The bank used for the payment, or null if not known.
+
+## Constructor Summary
+
+## Method Summary
+
+### getBank
+
+**Signature:** `getBank() : String`
+
+Returns the bank used for the payment, or null if not known.
+
+## Method Detail
+
+## Method Details
+
+### getBank
+
+**Signature:** `getBank() : String`
+
+**Description:** Returns the bank used for the payment, or null if not known.
+
+**Returns:**
+
+bank
+
+**See Also:**
+
+SalesforcePaymentMethod.getBank()
+
+---

package/docs/dw_extensions.payments/SalesforceIdealPaymentDetails.md

@@ -0,0 +1,51 @@
+## Package: dw.extensions.payments
+
+# Class SalesforceIdealPaymentDetails
+
+## Inheritance Hierarchy
+
+- Object
+  - dw.extensions.payments.SalesforcePaymentDetails
+  - dw.extensions.payments.SalesforceIdealPaymentDetails
+
+## Description
+
+Details to a Salesforce Payments payment of type SalesforcePaymentMethod.TYPE_IDEAL. See Salesforce Payments documentation for how to gain access and configure it for use on your sites.
+
+## Properties
+
+### bank
+
+**Type:** String (Read Only)
+
+The bank used for the payment, or null if not known.
+
+## Constructor Summary
+
+## Method Summary
+
+### getBank
+
+**Signature:** `getBank() : String`
+
+Returns the bank used for the payment, or null if not known.
+
+## Method Detail
+
+## Method Details
+
+### getBank
+
+**Signature:** `getBank() : String`
+
+**Description:** Returns the bank used for the payment, or null if not known.
+
+**Returns:**
+
+bank
+
+**See Also:**
+
+SalesforcePaymentMethod.getBank()
+
+---

package/docs/dw_extensions.payments/SalesforceKlarnaPaymentDetails.md

@@ -0,0 +1,51 @@
+## Package: dw.extensions.payments
+
+# Class SalesforceKlarnaPaymentDetails
+
+## Inheritance Hierarchy
+
+- Object
+  - dw.extensions.payments.SalesforcePaymentDetails
+  - dw.extensions.payments.SalesforceKlarnaPaymentDetails
+
+## Description
+
+Details to a Salesforce Payments payment of type SalesforcePaymentMethod.TYPE_KLARNA. See Salesforce Payments documentation for how to gain access and configure it for use on your sites.
+
+## Properties
+
+### paymentMethodCategory
+
+**Type:** String (Read Only)
+
+The payment method category used for the payment, or null if not known.
+
+## Constructor Summary
+
+## Method Summary
+
+### getPaymentMethodCategory
+
+**Signature:** `getPaymentMethodCategory() : String`
+
+Returns the payment method category used for the payment, or null if not known.
+
+## Method Detail
+
+## Method Details
+
+### getPaymentMethodCategory
+
+**Signature:** `getPaymentMethodCategory() : String`
+
+**Description:** Returns the payment method category used for the payment, or null if not known.
+
+**Returns:**
+
+payment method category
+
+**See Also:**
+
+SalesforcePaymentMethod.getPaymentMethodCategory()
+
+---