Merge pull request #7 from cybersource-tpi/main

Release 23.3.0

Author: ohernandovisa

README.md

@@ -9,7 +9,7 @@ Please refer to the [official documentation](documentation/occ.md) to get all de
 ## Prerequisites
 
 - Yarn version: [1.22.4](https://classic.yarnpkg.com/en/docs/install/#mac-stable)
-- NodeJS version: 16.15.0, You could use [NVM](https://github.com/nvm-sh/nvm) to manage multiple versions locally
+- NodeJS version: 18.16.1, You could use [NVM](https://github.com/nvm-sh/nvm) to manage multiple versions locally
 
 
 ## Install dependencies

documentation/Oracle Commerce Cloud Installation Guide v23.2.0.pdf

@@ -27,8 +27,8 @@ Please pay attention to installation steps documented for both SSE and widgets (
 
 The following is required before going through installation steps:
 
-1. Yarn version: [1.22.18](https://classic.yarnpkg.com/en/docs/install/#mac-stable)
-2. NodeJS version: 16.15.0, You could use [NVM](https://github.com/nvm-sh/nvm) to manage multiple versions locally
+1. Yarn version: [1.22.4](https://classic.yarnpkg.com/en/docs/install/#mac-stable)
+2. NodeJS version: 18.16.1, You could use [NVM](https://github.com/nvm-sh/nvm) to manage multiple versions locally
 3. OCC environment
     - OCC Admin interface: https://asbx80c1dev-admin-{env}.oraclecloud.com/occs-admin/
     - OCC Storefront: https://asbx80c1dev-store-{env}.oraclecloud.com
@@ -44,9 +44,9 @@ You need to build all packages at once using `yarn build:prod` command from proj
 
 ### Configure gateway
 
-Before installing payment gateway you should decide whether you will support all payment methods or only some of it. There are two ways you can manage it:
+Before installing a payment gateway you should decide whether you will support all payment methods or only some. There are two ways it can be managed: 
 
-1. Disabling payment type from OCC Admin interface which will result in payment option not being rendered in UI (Payment Widget)
+1. Disabling payment type from OCC Admin interface which will result in the payment option not being rendered in UI (Payment Widget)
 2. Removing unrelated configuration properties from `packages/payment-gateway/gateway/isv-occ-gateway/config/config.json`
 
 ![Important](images/important.jpg) In most cases just disabling unsupported payment type from OCC Admin is preferable. Removing unsupported configuration properties can be done in case particular payment types (e.g. GooglePay) should be initially excluded from OCC Admin interface.
@@ -91,8 +91,8 @@ After successful deployment you will need to enable payment gateway:
 - Configure gateway settings by providing values (e.g. merchant credentials) for particular channel (Preview, Storefront, Agent)
 - Save Changes
 - Go back to the 'Payment Types' type
-- Select supported credit card types from the list
-- You might want  to also provide list of supported billing countries as well as default one
+- Select supported credit/debit card types from the list [Possible card types: VISA, MASTERCARD, AMEX, DISCOVER, DINERSCLUB, JCB, CARTESBANCAIRES, MAESTRO, CARNET, CUP] 
+- You might want to also provide list of supported billing countries as well as default one
 - Save Changes
 
 ## Configure Generic Webhooks
@@ -198,16 +198,16 @@ yarn occ deploy
 ### Add widget to the Checkout layout
 
 1. Go to the OCC admin design tab and replace the default checkout-continue-to-review-order-button component with the IsvCheckoutContinueToReviewOrderButton on the checkout-payment page
-![isf review order path](images/isv-review-order-path.png)
-Drag ![isf review order button](images/isv-review-order-button.png) from the Components tray into the layout container.
+![isv review order path](images/isv-review-order-path.png)
+Drag ![isv review order button](images/isv-review-order-button.png) from the Components tray into the layout container.
 
 2. Go to the OCC admin design tab and replace the default checkout-place-order-button component with the IsvCheckoutPlaceOrderButton on the checkout-review-order page
-![isf place order path](images/isv-place-order-path.png)
-Drag ![isf place order button](images/isv-place-order-button.png) from the Components tray into the layout container.
+![isv place order path](images/isv-place-order-path.png)
+Drag ![isv place order button](images/isv-place-order-button.png) from the Components tray into the layout container.
 
 3. Layout the IsvPaymentMethod component on the checkout payments container
-![isf payment method path](images/isv-payment-method-path.png)
-Remove the checkout-credit-card component from the layout and replace it with ![isf payment method](images/isv-payment-method.png).
+![isv payment method path](images/isv-payment-method-path.png)
+Remove the checkout-credit-card component from the layout and replace it with ![isv payment method](images/isv-payment-method.png).
 
 4. Publish all changes
 

documentation/Oracle Commerce Cloud Installation Guide.pdf

@@ -14,8 +14,9 @@ The custom payment plugin solution provides an integration layer between OCC and
         - Void (Authorization Reversal)
         - Capture
         - Refund
-    - Tokenized card payment based on FlexMicroform v0.11
+    - Tokenized card payment based on Microform v2
     - Payer authentication support (3D Secure)
+    - Network tokenization
     - Store tokenized credit card against user profile
         - Payments using stored credit cards
 2. Online Authorizations

documentation/Oracle Commerce Cloud- Cybersource User Installation Guide v23.2.0.pdf documentation/Oracle Commerce Cloud- Cybersource User Installation Guide.pdf

@@ -11,7 +11,7 @@
 | [Package Contents](package-contents.md)                        | Detailed explanation of each package included into solution. Documents available payment gateway settings                    |
 | [Installation](installation.md)                                | Go through installation steps to deploy and configure payment extensions to OCC                                              |
 | _Payment Services_                                             |                                                                                                                              |
-| [Credit Card](payment-services/credit-card.md)                 | Detailed information about credit card payment services, e.g. FlexMicroform integration, Payer Authentication (3DSecure) etc |
+| [Credit Card](payment-services/credit-card.md)                 | Detailed information about credit card payment services, e.g.Microform integration, Payer Authentication (3DSecure) etc |
 | [GooglePay](payment-services/googlepay.md)                     | Documents GooglePay integration and related technical details                                                                |
 | [ApplePay](payment-services/applepay.md)                       | Documents ApplePay integration and related technical details. Includes ApplePay setup steps                                  |
 | [Settlement and Refund](payment-services/settlement-refund.md) | Additional payment services to allow fulfillment processes to settle or refund particular transactions when needed           |
@@ -64,6 +64,8 @@ This document is written for merchants who want to use Payment and Value added B
 
 - Supplemental Technical Resource Guide for OCC ( [HTML](https://community.oracle.com/docs/DOC-1038707) )
 - Generic Payment Gateway Integration ( [HTML](https://docs.oracle.com/en/cloud/saas/cx-commerce/20c/ccdev/create-generic-payment-gateway-integration1.html) )
-- SSE Development Best Practices ( [HTML](https://community.oracle.com/customerconnect/discussion/630679/server-side-extension-development-best-practices) )
-- Developing OSF in OCC ( [HTML](https://docs.oracle.com/en/cloud/saas/cx-commerce/dosfa/index.html ) )
+- Payment Integration with OCC ( [HTML](https://community.oracle.com/docs/DOC-1032741) )
+- OCC Payment FAQ ( [HTML](https://community.oracle.com/docs/DOC-1032746) )
+- SSE Development Best Practices ( [HTML](https://community.oracle.com/groups/oracle-commerce-cloud-group/blog/2018/11/08/server-side-extension-development-best-practices) )
+- Developing Widgets in OCC ( [HTML](https://docs.oracle.com/en/cloud/saas/cx-commerce/20c/widge/create-widget1.html) )
 - Cybersource REST API Reference ( [HTML](https://developer.cybersource.com/api-reference-assets/index.html) )

documentation/Release Notes v23.2.0.docx

@@ -21,7 +21,7 @@ The CLI tool is a combined version of utilities shared in the following communit
 By running `yarn occ` you will get the list of supported commands
 
 ```bash
-yarn run v1.22.18
+yarn run v1.22.4
 $ node ./bin/index.js
 Usage: index [options] [command]
 
@@ -107,7 +107,8 @@ The following settings can be configured in gateway:
 | **Credit Card**                     |                                                                                                                                                                                                                                                                                                                   |
 | **payerAuthEnabled**                | Enables payer authentication for credit cards                                                                                                                                                                                                                                                                     |
 | **scaEnabled**                | If enabled card holder will be 3DS Challenged when saving a card                                                                                                                                                                                                                                                                      |
-| **flexSdkUrl**                      | Credit Card Flex SDK URL                                                                                                                                                                                                                                                                                          |
+| **networkTokenUpdates**                | Subscribe to Network Token Life cycle updates                                                                                                                                                                                                                                                                      |
+| **microformSdkUrl**                      | Credit Card Microform SDK URL                                                                                                                                                                                                                                                                                          |
 | **isCVVRequiredForSavedCards**      | Is the CVV required when using a saved card.                                                                                                                                                                                                                                                                      |
 | **isCVVRequiredForScheduledOrders** | Is the CVV required for a Scheduled Order                                                                                                                                                                                                                                                                         |
 |                                     |                                                                                                                                                                                                                                                                                                                   |
@@ -199,7 +200,8 @@ server-extension
  ┃ ┃ ┣ paymentMethods.ts
  ┃ ┃ ┣ paymentRefund.ts
  ┃ ┃ ┣ paymentRouter.js
- ┃ ┃ ┗ report.ts
+ ┃ ┃ ┣ report.ts
+ ┃ ┃ ┗ webhookRouter.ts
  ┃ ┣ errors
  ┃ ┃ ┣ handlers
  ┃ ┃ ┃ ┣ api400ResponseHandler.ts
@@ -294,7 +296,8 @@ server-extension
  ┃ ┃ ┃ ┃ ┃ ┣ captureEndpoint.ts
  ┃ ┃ ┃ ┃ ┃ ┣ common.ts
  ┃ ┃ ┃ ┃ ┃ ┣ index.ts
- ┃ ┃ ┃ ┃ ┃ ┗ refundEndpoint.ts
+ ┃ ┃ ┃ ┃ ┃ ┣ refundEndpoint.ts
+ ┃ ┃ ┃ ┃ ┃ ┗ subscribeApi.js
  ┃ ┃ ┃ ┃ ┗ common.ts
  ┃ ┃ ┃ ┣ paymentMethod
  ┃ ┃ ┃ ┃ ┣ configBuilder.ts
@@ -318,7 +321,8 @@ server-extension
  ┃ ┃ ┣ cacheService.ts
  ┃ ┃ ┣ cryptoService.ts
  ┃ ┃ ┣ jwtService.ts
- ┃ ┃ ┗ loggingService.ts
+ ┃ ┃ ┣ loggingService.ts
+ ┃ ┃ ┗ publicKeyApi.js
  ┃ ┣ types
  ┃ ┃ ┗ occ-sdk.d.ts
  ┃ ┣ app.ts
@@ -337,7 +341,7 @@ server-extension
 | **Endpoint**                                            | **Description**                                                                                                                 |
 |---------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------|
 | `/ccstorex/custom/isv-payment/v2/paymentMethods`        | Returns list of supported payment types. Consumer: Payment Widget                                                               |
-| `/ccstorex/custom/isv-payment/v2/keys`                  | Generates Flex public key (capture context). Consumer: Payment Widget                                                           |
+| `/ccstorex/custom/isv-payment/v2/keys`                  | Generates Microform public key (capture context). Consumer: Payment Widget                                                           |
 | `/ccstorex/custom/isv-payment/v2/payments`              | Generic Payments Webhook handler endpoint.  Consumer: Payment Widget                                                                |
 | `/ccstorex/custom/isv-payment/v2/applepay/validate`     | Validates ApplePay session. Consumer: Payment Widget                                                                            |
 | `/ccstorex/custom/isv-payment/v2/report/daily`          | Returns daily conversion report for a given date. Consumer: Fulfillment                                                         |
@@ -405,7 +409,7 @@ The table below lists available middleware components
 
 Additional configuration properties managed by 'nconf' library available in OCC environment are located at `packages/server-extension/config`. Please notice there are version for local and production (deployed) environments
 
-SSE communicates with PSP using client [NodeJS SDK v0.0.20](https://github.com/CyberSource/cybersource-rest-client-node). Typescript friendly SDK wrapper is located in the `packages/payment-sdk`. It declares TS type definition's for the PSP API. You can manage generated type definitions by tweaking `packages/payment-sdk/generator/cybersource-ts-template/api.mustache` template. In order to generate new types from the updated template run the following:
+SSE communicates with PSP using client [NodeJS SDK v0.0.43](https://github.com/CyberSource/cybersource-rest-client-node). Typescript friendly SDK wrapper is located in the `packages/payment-sdk`. It declares TS type definition's for the PSP API. You can manage generated type definitions by tweaking `packages/payment-sdk/generator/cybersource-ts-template/api.mustache` template. In order to generate new types from the updated template run the following:
 
 ```bash
 cd packages/payment-sdk