We care for two reasons really. The first is that we offer credit to consumers, this means that we need to have enough data to do a proper assessment of risk and fraud. This is only possible if we have consumer data of high quality and in a standardized format. The second reason is due to us also being a part of the order management-process.
Note: Please see that you can share the customer data in either create_session, load and authorize if you are using Klarna Payments. Validation will happen for all entered fields at each call step and added details in every step will be combined.
Best Practice: street_address2 should only be used to add extra details to the address, such as floor, apartment number etc. It should not be used to send in e.g. street number separately. This should be included in the regular street_address field.
Our API can handle both billing and shipping addresses separately. If no shipping address has been entered, we will duplicate the billing address and use that as shipping address in our customer data.
Please note that our risk assessment might differ if the billing and shipping are different addresses, as the fraud risk might be seen as higher.
Also note that if the customer of the billing and shipping address is different, this might also be seen as being a larger risk for fraud.
Klarna Payments can receive customer data for a purchase throughout the session. From create_session and up to the authorize call. Any customer data added throughout the session will be be merged and taken into account for the risk assessments that takes place at both load and authorize.
Any customer data in a later call will take precedence over customer data entered in a previous call. If new customer data is amended in subsequent call, this will be merged to the previously entered data.
If any mandatory customer data field (see section below for mandatory fields per market) is still missing at point of authorize, Klarna Payments will respond with an error message. You must collect these and attempt a new authorize to complete the purchase.
Note: There is also a validation being done during Place Order where the consumer data you send in the create_order call is validated against the customer data you sent in during the session.
Different markets have different standards when it comes to required input. This is mainly due to the internal standards in a country. E.g. are national identification numbers commonly used in Nordics, while not in other countries. In other countries, titles are important.
You need to provide customer details in the fields marked as Mandatory and Optional below for a good customer experience. If you e.g. provide vital aspects of the address in field street_address2 in markets where not marked as Optional this will not be used in all customer-centric systems.
| Symbol | Meaning |
|---|---|
| * | Mandatory |
| - | Optional |
| > | Derived |
| ! | See notes |
| ? | Depending on payment method. Klarna will collect in purchase-flow if not added. |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| ? national_identification_number | Necessary for all credit payment methods and Pay Now. |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| - care_of | |
| * city | |
| * region | |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| > gender - from PNO | |
| > date_of_birth - from PNO |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| - title | Mr, Ms |
| ? date_of_birth | Necessary for all credit payment methods and Pay Now. |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| - street_address2 | |
| * city | |
| * phone | Follow the standards defined inhttps://github.com/googlei18n/libphonenumber |
| > gender | Derived from title |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| - street_address2 | |
| * region | Use two-letter format, e.g. “CA” for California. Follows ISO 3166-1 alpha-2. |
| * city | |
| * phone | Follow the standards defined inhttps://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| ? date_of_birth | Necessary for all credit payment methods. |
| - title | “Herr”, “Frau” |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| - care_of | |
| * city | |
| - phone | Follow the standards defined inhttps://github.com/googlei18n/libphonenumber |
| > gender | Derived from title. |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| ? date_of_birth | Necessary for all credit payment methods. |
| - title | AT: “Herr, “Frau” de-CH: “Herr, “Frau” it-CH: “Sig.", “Sig.ra” fr-CH: “M", “Mme” BE: “Dhr.", “Mevr.” NL: “Dhr.", “Mevr.” |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| - care_of | |
| * city | |
| - phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| > gender | Derived from title. |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| - street_address2 | |
| * region | Use three-letter format, e.g. “QLD” for Queensland. |
| * city | |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| ? date_of_birth | Necessary for all credit payment methods. |
| ? place_of_birth | Necessary for all credit payment methods. |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| * city | |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| * city | |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| ? national_identification_number | Necessary for all credit payment methods |
| Customer details | Comment |
|---|---|
| Must include @ and domain. | |
| * postal_code | Validation according to Universal Postal Union addressing systems |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | |
| * family_name | |
| * street_address | Also includes street number. |
| * city | |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| ? national_identification_number | Could be required |