{"title":"Klarna Debit Risk for API only","category":"default","creationDate":1776961628,"content":"

You can add Klarna Debit Risk to your existing integration. The following instructions show only what you must add to your integration specifically for Klarna Debit Risk.<\/p>\n

If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nMake sure that you have an existing API-only integration<\/a>.<\/td>\n <\/td>\n<\/tr>\n
Redirect handling<\/strong><\/td>\nMake sure that your existing integration is set up to handle the redirect<\/a>.
action.type<\/code>: redirect<\/strong><\/span>.<\/td>\n		<\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\n Before you begin, add Klarna Debit Risk in your Customer Area<\/a>. <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n
    \n
  1. The shopper selects Klarna Debit Risk as the payment method.<\/li>\n
  2. The shopper enters their details in the payment form that you build<\/a>. (No details are required for this payment method.)<\/li>\n
  3. When you make the payment request, you include additional information about the shopper<\/a>.<\/li>\n
  4. Your existing integration setup will handle the redirect<\/a>.<\/li>\n<\/ol>\n

    Build your payment form<\/h2>\n

    Include Klarna Debit Risk in the list of available payment methods. There are no additional fields that you have to include in your form. However, make sure to pass the correct country code<\/a> of the shopper.<\/p>\n

    \n

    You can download the logo for Klarna Debit Risk<\/a> to use in your form.<\/p>\n<\/div>\n

    Get Klarna Debit Risk as an available payment method<\/h2>\n

    When you make the \/paymentMethods<\/a> to get available payment methods<\/a>, specify the following so that Klarna Debit Risk is included in the response.<\/p>\n\n\n\n\n\n\n
    Parameter<\/th>\nValues<\/th>\n<\/tr>\n<\/thead>\n
    countryCode<\/a><\/td>\nAT<\/strong>, BE<\/strong>, DE<\/strong>, NL<\/strong>, ES<\/strong>, CH<\/strong><\/span><\/td>\n<\/tr>\n
    amount.currency<\/a><\/td>\nEUR<\/strong>, CHF<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n <\/code-sample>\n<\/div>\n
    \n <\/code-sample>\n<\/div>\n

    Add additional parameters to your \/payments request<\/h2>\n

    You do not need to add any additional parameters when you make a payment<\/a>, but make sure to include the following parameters:<\/p>\n\n\n\n\n\n\n\n\n\n\n
    Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    paymentMethod.type<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nSet to directEbanking<\/strong>.<\/td>\n<\/tr>\n
    returnUrl<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nURL to where the shopper should be redirected back to after they complete the payment.<\/td>\n<\/tr>\n
    countryCode<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nThe shopper's country\/region in a two-letter country code format. Include this in the request to make sure the shopper can proceed in the Klarna flow.<\/td>\n<\/tr>\n
    shopperLocale<\/a><\/td>\n<\/td>\nThe language that the Klarna Debit Risk page should be rendered in. The page can be the local language (for example, nl-NL for the Netherlands) or in en-US.<\/td>\n<\/tr>\n
    shopperEmail<\/a><\/td>\n<\/td>\nThe email of the shopper. If included, Klarna will pre-fill it if the shopper does not have a Klarna account yet and needs to create one.<\/td>\n<\/tr>\n
    telephoneNumber<\/a><\/td>\n<\/td>\nThe phone number of the shopper. If included, Klarna will pre-fill it in the Klarna log-in screen.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    The following example shows how to make a payment request for 10 EUR for a shopper in Germany, with the Klarna Debit Risk page rendered in German.<\/p>\n

    \n <\/code-sample>\n<\/div>\n

    The response includes the action.type<\/code>: redirect<\/strong>.<\/p>\n

    \n <\/code-sample>\n<\/div>\n

    Handle the redirect<\/h2>\n
      \n
    1. \n

      To complete the payment, redirect the shopper to the action.url<\/code> returned in the \/payments<\/a> response, taking into account the following recommendations:<\/p>\n