SAP Digital Payments Integration

Note: Spartacus 4.x is no longer maintained. Please upgrade to the latest version.

Note: Spartacus 4.x was tested with SAP Commerce Cloud versions 1905 to 2205. Spartacus 4.x has not been verified to work with (and is not guaranteed to work with) SAP Commerce Cloud 2211 or later releases.

Note: This feature is introduced with version 4.1 of the Spartacus libraries.

SAP Digital Payments integration is an out-of-the-box alternative to current custom payment service provider (PSP) integrations. This integration uses SAP Digital Payments with ready-to-use PSP connectivity.

For more information, see SAP Digital Payments Integration on the SAP Help Portal.


Table of Contents


Requirements

To integrate SAP Digital Payments with Spartacus, you must have one of the following:

  • SAP Commerce Cloud 2105, along with SAP Commerce Cloud, Integration Extension Pack 2108 or later
  • SAP Commerce Cloud 2011, along with SAP Commerce Cloud, Integration Extension Pack 2102 or later

Enabling SAP Digital Payment Integration in Spartacus

To enable SAP Digital Payments Integration in Spartacus, you need to configure both the Commerce Cloud back end, and the Spartacus front end.

Configuring the Back End for SAP Digital Payments Integration

The following steps describe how to configure the Commerce Cloud back end for integration with SAP Digital Payments.

  1. Follow the steps for Installing SAP Commerce Cloud for use with Spartacus.
  2. Enable the SAP Digital Payments Extensions. For more information, see SAP Digital Payments Integration on the SAP Help Portal.
  3. Build and update the system so that the new functionality provided by the SAP Digital Payments integration extensions is available. This step also creates sample CMS data for the electronics-spaContentCatalog content catalog.

Configuring Spartacus for SAP Digital Payments Integration

Perform the following steps after you have set up your Spartacus Storefront. For more information, see Building the Spartacus Storefront From Libraries.

  1. Install the SAP Digital Payments integration library by running the following command from within the root directory of your storefront application:

    ng add @spartacus/digital-payments
    

    When you run this command, the schematics create a module for the Digital Payments integration that includes all of the required imports and configuration.

    Note: To install the Digital Payments integration library using schematics, your app structure needs to match the Spartacus reference app structure. For more information, see Reference App Structure.

    Alternatively, you can create the module manually and import it into your application, as shown in the following example:

    import { NgModule } from '@angular/core';
    import { I18nConfig, provideConfig } from "@spartacus/core";
    import { DigitalPaymentsModule, dpTranslationChunksConfig, dpTranslations } from "@spartacus/digital-payments";
       
    @NgModule({
      declarations: [],
      imports: [
        DigitalPaymentsModule
      ],
      providers: [provideConfig(<I18nConfig>{
        i18n: {
          resources: dpTranslations,
          chunks: dpTranslationChunksConfig,
        },
      })]
    })
    export class DigitalPaymentsFeatureModule { }
    
  2. Build and start the storefront app to verify your changes.