Before you start, ensure:

• The klarnapaymentaddon is successfully installed.
• You have access to the SAP Commerce Backoffice.
• Credentials from the Klarna Merchant Portal, including API username, API password, and Public Key ID.

Step 1: Create a Klarna Payments configuration

1. Navigate to Klarna Payment Configuration: Go to SAP Commerce Backoffice → Klarna → Klarna Payments Config.

2. Create a new Klarna configuration: Select the option to create a new Klarna configuration.

3. Fill in mandatory fields:

• Code: A unique identifier for the configuration.
• Enable Klarna Payments: Toggle to enable the feature.
• Email for Failure Notifications: Email for receiving alerts.
• Click Next to proceed.

4. Provide additional details:

• Enable AutoCapture (optional).
• Enable Extra Merchant Data (EMD) (optional).
• Set Merchant Reference 2 and optional color customization for the Klarna interface.

Step 2: Create credential data

1. Navigate to Klarna Activation: In the Backoffice, go to Klarna → Klarna Activation.

2. Add a new credential: Click the + icon below the Klarna Activation section.

3. Fill in mandatory fields:

• Code: Identifier for the credentials.
• Client ID, API Username, and API Password: Retrieved from the Klarna Merchant Portal.

4. Provide additional details:

• Region (e.g., EUROPE, NORTH_AMERICA).
• Supported Markets.
• Enable VCN if applicable.
• Public Key ID: For encrypting VCN data.

Step 3: Map credentials and Klarna Payments configuration

1. Navigate to Klarna Common Configuration: Go to Klarna → Klarna Common Configuration.

2. Create a mapping:

• Click the + icon to create a new mapping.
• Fill in details such as Code, Active, and Environment (TEST or LIVE).

3. Link Klarna credentials and payment configuration:

• Select the Klarna credentials created in Step 2.
• Associate the Klarna Payments configuration created in Step 1.

Steps to Enable VCN

Step 1: Enable VCN in Klarna Configuration

1. Access Klarna Activation:
   
   • Navigate to SAP Commerce Backoffice → Klarna → Klarna Activation.
   
2. Enable VCN:
   
   • Select the Enable VCN option.
   

Step 2: Generate a 4096-bit RSA Key Pair

1. Open a terminal and run the following commands:

openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:4096
openssl rsa -pubout -in private_key.pem -out public_key.pem

2. This will create two files:

• private_key.pem (Private key)
• public_key.pem (Public key)

Step 3: Configure Klarna with RSA Keys

1. In Klarna Activation, set the Public Key ID using the contents of public_key.pem.
2. Example public_key.pem file contents:

-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAoNYG7l2G8nZa+22oBYZk
tV228lw3UE9WO4oxfknJtKEdHn84x55ULt8KQTh9NVtdeKC8nTfTgyvMt/GNCa18
xuZV/lGYDftKt85hbV5EjOum+StAIufEXvlBX7nMOMc1KyWm9kp2kbqd88mFIX63
KV94OoNEXcNatRDFYR+qz53+ifadDQtQ1slVNStdroCZDJ1+LxtBy9V+BdmsBK1E
RLsKh/JLXyWE24FJKV+z00s7TQkdWW/5ET12OGQYZsWo1yqgi9HplNvrisve8vWP
xaL4m8iZ3I/9yYdg7yANQbTxSJcbbRCgaaagPo30CNxeqU6qafY5g8vY3E52CoXH
DdO4UslX1qcuYIDhqaDzey6W+b8m755xLi+rqQyM4PBWL0J0dM3FVid8+4YKILex
3AKBFciqRCMHSOGaEeyrXKTjlAsghr9RS8PifvQRrL440cHzqw2vX0DvpjSWcmUJ
tW4wUq5RNSsobrxnVmoV6fj1z67Q/1P+l5Ie+oowdahR5ztVqJlO+2PNoX4I5VDs

Verifying VCN Data in Backoffice

1. Access the Order

• Navigate to Order in the SAP Commerce Backoffice.
• Search for the specific order number.

2. View Order Details

• Click the order number.
• Go to the Payment & Delivery section.
• Select Payment Information to view the VCN details.

Steps to Verify Klarna Orders

1. Log in to SAP Commerce Backoffice.
2. Navigate to Orders:
   
   • Click Orders in the left-side menu.
   
3. Search for a Specific Order:
   
   • Enter the order number in the search bar.
   
   • Open the order by clicking its entry in the results.
   

Viewing Klarna-Specific Details

1. Verify Klarna Order ID:

• Go to the Properties tab of the order.
• Locate and confirm the Klarna Order ID.

2. Check Payment Transactions:

• Go to the Administration tab.

• Look for the transaction type KLARNAORDER_PLACED to verify Klarna-specific transactions

The Extra Merchant Data (EMD) feature allows merchants to send additional customer information to Klarna, such as alternative delivery addresses and reservation details. By default, only logged-in customer information is sent.

Steps to Enable EMD in SAP Commerce Backoffice

1. Navigate to the Backoffice:
   
   • Open SAP Commerce Backoffice.
   
   • Go to Klarna → Klarna Payments Configuration.
   
2. Enable the EMD Option:
   
   • Locate the Enable EMD setting in the Klarna Payments configuration.
   
   • Toggle the option to enable it.
   

Configuring EMD in Code

To extend the EMD functionality beyond the default behavior:

1. Open the KPCreditSessionPopulator.java File: Locate the file in your SAP Commerce extension codebase.
2. Use the addAttachment Method:
   
   • This method is exposed for configuring EMD data.
   
   • Replace yourDataObject with the required data (e.g., customer preferences or reservation details).
   
   • Example usage: addAttachment("additionalData", yourDataObject);
   
3. Compile and Deploy the Changes: Build your extension and deploy it to the SAP Commerce environment.

Extension Model and Classes

Classes extended from OOB SAP (Hybris) Commerce platform

Klarna Payment Method Reference

KlarnapaymentAPI Method Reference