Payment Method Properties

With Pay Now Standalone, instead of selecting from the various Klarna payment options available, customers skip the payment selection step and proceed directly with Pay Now by Bank.

Transaction Flow

1. The consumer selects to pay with Klarna in the merchant checkout.
2. The merchant creates a payment request to your system.
3. Your system forwards the payment request to PPRO.
4. PPRO creates an order session at Klarna to create the Klarna HPP.
5. After Klarna responds, PPRO forwards you the response.
6. The merchant redirects the consumer to a Klarna HPP page where they continue with the payment.
7. After confirming the payment, the consumer is redirected to the merchant’s success page.

Klarna Pay Now Standalone Integration

Specific input parameters for the TRANSACTION call

For standard input parameters, see Input parameters for the TRANSACTION call.

Specific output parameters for the TRANSACTION call

For standard output parameters, see Output parameters for the TRANSACTION call.

TRANSACTION call input

tag=klarnapns
txtype=TRANSACTION
countrycode=DE
currency=EUR
amount=40000
merchanttxid=RfxeZyceEj2v
preferredlanguage=en
login=johndoe
password=wXBrpVporFVjGO4R
contractid=JOHNDOE
channel=testchannel
merchantredirecturl=https%3A%2F%2Fmyurl.com%2Fwork%2Fppro2%2Flanding.php
notificationurl=https%3A%2F%2Fmyurl.com%2Fwork%2Fppro2%2Fnotification.php
accountholdername=John+Doe
specin.taxamount=3636
transientin.orderitems=%5B%7B%22name%22%3A%22BatteryPowerPack%22%2C%22quantity%22%3A1%2C%22tax_rate%22%3A1000%2C%22total_amount%22%3A10000%2C%22total_discount_amount%22%3A550%2C%22total_tax_amount%22%3A909%2C%22unit_price%22%3A10550%7D%2C%7B%22name%22%3A%22BatteryPowerPack%22%2C%22quantity%22%3A1%2C%22tax_rate%22%3A1000%2C%22total_amount%22%3A10000%2C%22total_discount_amount%22%3A550%2C%22total_tax_amount%22%3A909%2C%22unit_price%22%3A10550%7D%2C%7B%22name%22%3A%22BatteryPowerPack%22%2C%22quantity%22%3A1%2C%22tax_rate%22%3A1000%2C%22total_amount%22%3A10000%2C%22total_discount_amount%22%3A550%2C%22total_tax_amount%22%3A909%2C%22unit_price%22%3A10550%7D%2C%7B%22name%22%3A%22BatteryPowerPack%22%2C%22quantity%22%3A1%2C%22tax_rate%22%3A1000%2C%22total_amount%22%3A10000%2C%22total_discount_amount%22%3A550%2C%22total_tax_amount%22%3A909%2C%22unit_price%22%3A10550%7D%5D
transientin.billingaddress=%7B%22city%22%3A%22Munich%22%2C%22country%22%3A%22DE%22%2C%22email%22%3A%22test.customer%40mpay.int%22%2C%22phone%22%3A%2207792555555%22%2C%22region%22%3A%22Scotland%22%2C%22family_name%22%3A%22Doe%22%2C%22given_name%22%3A%22John%2BDoe%22%2C%22organization_name%22%3A%22MPGS%22%2C%22postal_code%22%3A%22EH12%2B3AB%22%2C%22street_address%22%3A%22Ocean%2BPoint%22%2C%22street_address2%22%3A%22Ocean%2BDrive%22%7D
transientin.shippingaddress=
transientin.emd=
transientin.hpptitle=
transientin.purchasetype=
transientin.logourl=
returnmode=urlencodeext

TRANSACTION call output

REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=754422312
&ERRMSG=
&CHANNEL=testchannel
&TAG=klarnapns
&PAYMENTGUARANTEE=NONE
&REDIRECTSECRET=gDVEXOCBLYdj5miWcjuBF0odCE5JKcmU
&SPECOUT_AUTHORIZEDPAYMENTMETHOD=invoice
&SPECOUT_BILLINGCATEGORY=PAY_NOW_STANDALONE 
&SPECOUT_SCHEMEORDERID=b5a2be9c-14fb-29b8-943b-47052e37c1dd

Additional Information

Supported Industries

• Financial Services (MCC Codes: 6012, 6050, 6211, 6529, 6530, 6531, 6532, 6533, 6534, 6535, 7778, 4829, 6010, 6011, 6540)
• Crypto-related activities (MCC Code: 6051)
• Digital Services & Goods (MCC Codes: 7995, 9754, 7800, 7801, 7802, 9211, 9222, 9223)
• Erotic Services (MCC Codes: 5967, 7273)
• Other industries are supported via the regular Klarna one product, following these ethical guidelines.

Before you go live

• Access Klarna's Demo Store to try out Klarna payments in a country of your choice.
• Before you accept live payments, test your integration using the test details provided by Klarna.
• Make sure to use the following country-specific sample data.
• Consider Klarna's T&Cs based on your commercial agreement with PPRO.
• Follow the Klarna guidelines on how to display Klarna in the checkout.
• Ensure order lines and VAT are transmitted correctly to Klarna and displayed accurately on the Klarna pages.
• If a consumer gets rejected by Klarna, offer them another payment method but not the same Klarna method.
• Make sure you use Klarna's phone number format standards. To see the expected phone number format standards for every Klarna-supported country, go to this page.
• Stay up-to-date with the information required for every country.

Testing and integration

If you wish to give your merchants access to run a live test in the production environment, follow the recommendations below:

• Provide real consumer data: real name, personal email, personal mobile, and home and billing address. Using test data interferes with the credit/risk checks that Klarna performs on each transaction.
• Don't provide a company address as a billing address.
• Choose an item with a reasonable amount that meets Klarna's minimum requirements. Klarna can reject a request if the product is too expensive, and they do not have enough transaction history for the consumer.
• Don't perform multiple tests in a short period from the same device or IP address. Doing this will trigger velocity rule checks, which will lead to a rejected transaction due to the scheme blocking the merchant's Klarna ID.
• Klarna test data (relevant only on PPRO test) can be found at the following Klarna website.
• Redirecting the consumer: In case you get a PENDING response that contains a REDIRECTURL, redirect the consumer to that URL. Store the REDIRECTSECRET in the session or persistent storage to be able to verify the response later (see Redirect to MerchantRedirectURL - shared secret). This redirect can be performed by HTTP GET (302 redirect).

Klarna Merchant Portal Information

You'll get access to the Klarna Merchant Portal. You'll receive an activation email at the address that you provide during onboarding.

In the Klarna Merchant Portal, you'll have access to the following Klarna Apps:

• Users App: You'll get one user created when creating the account, but you can add users to the Klarna Merchant Portal and manage their permissions.
• Orders App: View and manage Klarna orders.
• Branding App: Manage how to display your brand assets on Klarna’s customer touchpoints.
• On-Site Messaging App: Manage how you communicate the different Klarna payment options to your customer.

🚧

Important

PPRO does not validate extra merchant data. Make sure you send the correct information.

Branding Guidelines

For information regarding branding, see the Klarna official website.

Disclaimer

Please note that this documentation is subject to change as we are in the process of finalizing the production rollout. For more details, please reach out to your account manager.