@ljmarquezge2y/checkout-spartacus-translations

CheckoutSpartacusConnector

Checkout.com provides an end-to-end platform that helps you move faster, instead of holding you back. With flexible tools, granular data and deep insights, it’s the payments tech that unleashes your potential. So you can innovate, adapt to your markets, create outstanding customer experiences, and make smart decisions faster. The Connector for SAP Commerce Cloud (formerly Hybris) enables customers to implement a global payment strategy through a single integration in a secure, compliant and unified approach.

This Checkout.com library adds payments capabilities to the Spartacus Storefront for SAP Commerce Cloud.

Release Compatibility

This library is tailored to the Spartacus Storefront:

This release is compatible with:

• Spartacus: version 4.2
• Node module checkout-spartacus-translations v4.2.5
• SAP Commerce Cloud: version 2011/2105/2205/2211
• Angular CLI: Version 12.0.5 or later, < 13.
• Node.js: Version 14.15 is required. Version 12.x reached end-of-life on April 30, 2022, and is no longer supported by Spartacus. It is strongly recommended that you migrate any existing Spartacus storefronts to Node.js 14 as soon as possible. If there are any issues with Spartacus and Node.js 14, please upgrade to the latest releases. If you continue to experience issues with Node.js 14, create a support ticket with SAP.
• Yarn: Version 1.15 or later.

Installation

Install the Checkout.com SAP Commerce Cloud Connector.

Install checkout.com spartacus connector:

  yarn install @checkout.com/checkout-spartacus-connector

Install checkout.com spartacus connector:

  yarn install @checkout.com/checkout-spartacus-translations

Update the `spartacus-configuration-module` to include the following:

import {CmsConfig, FeaturesConfig, I18nConfig, OccConfig, provideConfig, SiteContextConfig} from '@spartacus/core'; import {CheckoutConfig} from '@spartacus/checkout/root'; import { checkoutComTranslationChunkConfig, checkoutComTranslations } from '@checkout.com/checkout-spartacus-translations';

@NgModule({ providers: [ ...., provideConfig({ featureModules: { CheckoutComComponentsModule: { module: () => import('@checkout.com/checkout-spartacus-connector').then(m => m.CheckoutComComponentsModule), cmsComponents: [ 'CheckoutPaymentDetails', 'CheckoutPlaceOrder', 'OrderConfirmationThankMessageComponent', 'OrderConfirmationOverviewComponent', 'OrderConfirmationItemsComponent', 'OrderConfirmationShippingComponent', 'OrderConfirmationTotalsComponent', 'OrderConfirmationContinueButtonComponent', 'CheckoutReviewOrder', 'AccountOrderDetailsItemsComponent', 'AccountOrderDetailsShippingComponent', 'GuestRegisterFormComponent', 'AccountPaymentDetailsComponent', ], } } } as CmsConfig), provideConfig({ i18n: { resources: checkoutComTranslations, chunks: checkoutComTranslationChunkConfig, fallbackLang: 'en' }, } as I18nConfig), provideConfig({ checkout: { guest: true // not required, but we support guest checkout } } as CheckoutConfig), ... ]

Being a feature module, the code will only be loaded the moment we enter the third step of the checkout (Payment Details). The translations can’t be be lazy loaded, so this is why it has been moved to separate node module.

At the bottom of the body of your index.html, you will have to add the Frames script. Frames will log customer behaviour while browsing the website.

```

Extending components

The source code of the connector can be found on

• GitHub SAP CX 2011
• GitHub SAP CX 2015
• GitHub SAP CX 2205
• GitHub SAP CX 2211

If you need to extend components, you can fork the repository so you are able to upgrade to future releases. In this fork, you can make your changes and import the library in your storefront.

If you don't want to fork, you can extend components, copy the template and the Angular Component into your project. This will mean that you have to be vigilant when a new release of the library is integrated.

Release notes

Release 4.2.5

• Included support for SAP CX 2211
• Fixed dependencies issues.

Release 4.2.4

• Included support for SAP CX 2205
• Included the following components in the list of components to be imported in the Spartacus configuration module:
  • GuestRegisterFormComponent.
  • AccountPaymentDetailsComponent.
• Included support for the following APMs:
  • Cartes Bancaires
  • Multiple Card Brands
• Update Dependencies:
  • CheckoutSpartacusTranslations to version 4.2.4

Release 4.2.3

Include binaries. Previous 4.2.x releases are missing binaries.

Release 4.2.2

Update readme

Release 4.2.0

Use this release if you are using Spartacus 4.2.x

• Upgrade to Spartacus 4.2
• Show first name + last name as the card account holder
• Fix for ApplePay transaction status

Release 1.0.2

• Source code now publicly available

Release 1.0.0

• Added support for SSR

Release 0.0.0

• Lazy loaded feature module
• Translations moved to separate node module
• APM’s
  • AliPay
  • ApplePay
  • Bancontact
  • Benefit Pay
  • EPS
  • Fawry
  • Giropay
  • GooglePay
  • iDeal
  • Klarna
  • KNet
  • Mada
  • Multibanco
  • Oxxo
  • PayPal
  • Poli
  • Przelewy24
  • QPay
  • Sepa
  • Sofort
• Credit card form placeholder localisation
• Display card payment icon
• Made OCC endpoints configurable
• Added support for 3DS2