{"title":"Klarna raw acquirer responses","category":"default","creationDate":1776961628,"content":"<p>These are the most common raw acquirer responses from Klarna for successful, refused, failed or cancelled transactions.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Last journal type<\/th>\n<th style=\"text-align: left;\">Raw acquirer response<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><\/td>\n<td style=\"text-align: left;\">PENDING<\/td>\n<td style=\"text-align: left;\">This is an expected response for <a href=\"\/pt\/payment-methods\/klarna\/api-only\">Klarna Widget<\/a> integrations.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Authorised<\/td>\n<td style=\"text-align: left;\">ACCEPTED<\/td>\n<td style=\"text-align: left;\">The payment was authorised.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">Internal error<\/td>\n<td style=\"text-align: left;\">Generic API response from Klarna. Check your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> for additional information.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : locale<\/td>\n<td style=\"text-align: left;\">The locale in your payment request is not compatible. Refer to our <a href=\"\/pt\/payment-methods\/klarna\/api-only#make-a-payment\">Klarna documentation<\/a> for compatible combinations.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : order_lines[X].tax_rate<\/td>\n<td style=\"text-align: left;\">Error message on the validation criteria for the tax calculation. Refer to our <a href=\"\/pt\/payment-methods\/klarna\/invoice-lines\">Klarna documentation<\/a> for more information about the tax calculation.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : order_lines[X].total_tax_amount<\/td>\n<td style=\"text-align: left;\">There is an error in the tax amounts for order line [X]. Tax amounts should add up over all order lines. Klarna validates this on their end. Refer to our <a href=\"\/pt\/payment-methods\/klarna\/invoice-lines\">Klarna documentation<\/a> to see how to send in tax amounts in your payment request.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : order_tax_amount<\/td>\n<td style=\"text-align: left;\">There is an error in the tax amounts. Tax amounts should add up over all order lines. Klarna validates this on their end. Refer to our <a href=\"\/pt\/payment-methods\/klarna\/invoice-lines\">Klarna documentation<\/a> to see how to send in tax amounts in your payment request.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : purchase_currency<\/td>\n<td style=\"text-align: left;\">The <code>amount.currency<\/code> in your payment request not formatted correctly or doesn't apply for a certain locale. Refer to our <a href=\"\/pt\/payment-methods\/klarna\/api-only#make-a-payment\">Klarna documentation<\/a> for compatible combinations.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : billing_address.postal_code, shipping_address.postal_code or BAD_VALUE : shipping_address.postal_code, billing_address.postal_code<\/td>\n<td style=\"text-align: left;\">The postal code in the <code>billingAddress<\/code> or the <code>deliveryAddress<\/code> in your payment request is not formatted correctly. Refer to our <a href=\"\/pt\/payment-methods\/klarna\/\">Klarna documentation<\/a> to see how to format the shopper's address.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : attachment.attachment<\/td>\n<td style=\"text-align: left;\">The data sent in the <code>additionalData.openinvoicedata.merchantData<\/code> in your payment request does not follow Klarna's requirements. Refer to <a href=\"https:\/\/docs.klarna.com\/api\/payments\/#operation\/createCreditSession\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Klarna's documentation<\/a> to see how to format the merchant data.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : billing_address.phone, shipping_address.phone or BAD_VALUE : shipping_address.phone, billing_address.phone<\/td>\n<td style=\"text-align: left;\">The <code>telephoneNumber<\/code> in your payment request is not formatted correctly. Refer to our <a href=\"\/pt\/payment-methods\/klarna\/\">Klarna documentation<\/a> to see how to format the telephone number.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">BAD_VALUE : billing_address.given_name, billing_address.family_name, or BAD_VALUE : shipping_address.given_name, shipping_address.family_name<\/td>\n<td style=\"text-align: left;\">Your request contains invalid characters. Make sure that you only submit UTF-8 encoded values when creating a Klarna payment.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">Payment method not available (contact Klarna)<\/td>\n<td style=\"text-align: left;\">The payment method defined in the payment request is not configured correctly on Klarna's end. Verify that you have enabled Klarna in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">Allowed category list is empty<\/td>\n<td style=\"text-align: left;\">Edit your payment request. Your payment request does not follow the guidelines defined in our <a href=\"\/pt\/payment-methods\/klarna\">Klarna documentation<\/a>. For example, make sure that the country code and billing address are for the same location.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">Missing returnUrl<\/td>\n<td style=\"text-align: left;\">Your payment request is missing the <code>returnUrl<\/code> parameter.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Error<\/td>\n<td style=\"text-align: left;\">No InvoiceLines provided<\/td>\n<td style=\"text-align: left;\">Your payment request did not include invoice lines. Refer to our <a href=\"\/pt\/payment-methods\/klarna\/invoice-lines\">Klarna documentation<\/a> to see how to send in invoice lines in your payment request.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">OfferCancelled<\/td>\n<td style=\"text-align: left;\">NOT_FOUND : Invalid session id<\/td>\n<td style=\"text-align: left;\">The shopper has tried to make a payment for an offer that has expired. We recommend that you ask the shopper to retry the transaction.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Not linked to a payment status, check logs.<\/td>\n<td style=\"text-align: left;\">ReadSessionResponse does not have valid authorisation token<\/td>\n<td style=\"text-align: left;\">Klarna sends this error when: <ul> <li markdown=\"1\">The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\/details\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments\/details<\/a> call to Adyen is made before the shopper received an authorisation from Klarna.<\/li> <li markdown=\"1\">The shopper's authorisation token from Klarna has expired after 60 minutes.<\/li> <\/ul> There could be multiple reasons for this to happen.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refused<\/td>\n<td style=\"text-align: left;\">REFUSED<\/td>\n<td style=\"text-align: left;\">Klarna's internal risk engine refused the payment. A possible reason is that the shopper has an unpaid balance towards Klarna.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Refused<\/td>\n<td style=\"text-align: left;\">UNAVAILABLE_PAYMENT_METHOD or PAYMENT_METHOD_FAILED : Purchase for payment method failed<\/td>\n<td style=\"text-align: left;\">Klarna's internal risk engine refused the payment. A possible reason is that the shopper has an unpaid balance towards Klarna.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>","url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/klarna\/raw-responses","articleFields":{"parameters":{"payment_method":"Klarna"},"section_icon":"payment-methods.svg","id":"24216679","type":"page"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/klarna\/raw-responses","title":"Klarna raw acquirer responses","content":"These are the most common raw acquirer responses from Klarna for successful, refused, failed or cancelled transactions.\n\n\n\nLast journal type\nRaw acquirer response\nDescription\n\n\n\n\n\nPENDING\nThis is an expected response for Klarna Widget integrations.\n\n\nAuthorised\nACCEPTED\nThe payment was authorised.\n\n\nError\nInternal error\nGeneric API response from Klarna. Check your Customer Area for additional information.\n\n\nError\nBAD_VALUE : locale\nThe locale in your payment request is not compatible. Refer to our Klarna documentation for compatible combinations.\n\n\nError\nBAD_VALUE : order_lines[X].tax_rate\nError message on the validation criteria for the tax calculation. Refer to our Klarna documentation for more information about the tax calculation.\n\n\nError\nBAD_VALUE : order_lines[X].total_tax_amount\nThere is an error in the tax amounts for order line [X]. Tax amounts should add up over all order lines. Klarna validates this on their end. Refer to our Klarna documentation to see how to send in tax amounts in your payment request.\n\n\nError\nBAD_VALUE : order_tax_amount\nThere is an error in the tax amounts. Tax amounts should add up over all order lines. Klarna validates this on their end. Refer to our Klarna documentation to see how to send in tax amounts in your payment request.\n\n\nError\nBAD_VALUE : purchase_currency\nThe amount.currency in your payment request not formatted correctly or doesn't apply for a certain locale. Refer to our Klarna documentation for compatible combinations.\n\n\nError\nBAD_VALUE : billing_address.postal_code, shipping_address.postal_code or BAD_VALUE : shipping_address.postal_code, billing_address.postal_code\nThe postal code in the billingAddress or the deliveryAddress in your payment request is not formatted correctly. Refer to our Klarna documentation to see how to format the shopper's address.\n\n\nError\nBAD_VALUE : attachment.attachment\nThe data sent in the additionalData.openinvoicedata.merchantData in your payment request does not follow Klarna's requirements. Refer to Klarna's documentation to see how to format the merchant data.\n\n\nError\nBAD_VALUE : billing_address.phone, shipping_address.phone or BAD_VALUE : shipping_address.phone, billing_address.phone\nThe telephoneNumber in your payment request is not formatted correctly. Refer to our Klarna documentation to see how to format the telephone number.\n\n\nError\nBAD_VALUE : billing_address.given_name, billing_address.family_name, or BAD_VALUE : shipping_address.given_name, shipping_address.family_name\nYour request contains invalid characters. Make sure that you only submit UTF-8 encoded values when creating a Klarna payment.\n\n\nError\nPayment method not available (contact Klarna)\nThe payment method defined in the payment request is not configured correctly on Klarna's end. Verify that you have enabled Klarna in your Customer Area.\n\n\nError\nAllowed category list is empty\nEdit your payment request. Your payment request does not follow the guidelines defined in our Klarna documentation. For example, make sure that the country code and billing address are for the same location.\n\n\nError\nMissing returnUrl\nYour payment request is missing the returnUrl parameter.\n\n\nError\nNo InvoiceLines provided\nYour payment request did not include invoice lines. Refer to our Klarna documentation to see how to send in invoice lines in your payment request.\n\n\nOfferCancelled\nNOT_FOUND : Invalid session id\nThe shopper has tried to make a payment for an offer that has expired. We recommend that you ask the shopper to retry the transaction.\n\n\nNot linked to a payment status, check logs.\nReadSessionResponse does not have valid authorisation token\nKlarna sends this error when:  The  \/payments\/details call to Adyen is made before the shopper received an authorisation from Klarna. The shopper's authorisation token from Klarna has expired after 60 minutes.  There could be multiple reasons for this to happen.\n\n\nRefused\nREFUSED\nKlarna's internal risk engine refused the payment. A possible reason is that the shopper has an unpaid balance towards Klarna.\n\n\nRefused\nUNAVAILABLE_PAYMENT_METHOD or PAYMENT_METHOD_FAILED : Purchase for payment method failed\nKlarna's internal risk engine refused the payment. A possible reason is that the shopper has an unpaid balance towards Klarna.\n\n\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Klarna","lvl3":"Klarna raw acquirer responses"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/klarna","lvl3":"\/pt\/payment-methods\/klarna\/raw-responses"},"levels":4,"category":"Payment method","category_color":"green","tags":["Klarna","acquirer","responses"]}}
