This section describes the customer data we require to place an order, depending on the purchase country.
Select the country for the customer data you want to check.
| Australia 🇦🇺 | Austria 🇦🇹 | Belgium 🇧🇪 |
| Canada 🇨🇦 | Czech Republic 🇨🇿 | Denmark 🇩🇰 |
| Finland 🇫🇮 | France 🇫🇷 | Germany 🇩🇪 |
| Greece 🇬🇷 | Ireland 🇮🇪 | Italy 🇮🇹 |
| Netherlands 🇳🇱 | Norway 🇳🇴 | Poland 🇵🇱 |
| Portugal 🇵🇹 | Spain 🇪🇸 | Sweden 🇸🇪 |
| Switzerland🇨🇭 | United Kingdom 🇬🇧 | United States 🇺🇸 |
As we offer credits to your customers, we need to have enough data to do a proper risk and fraud assessment. This is only possible if we have high-quality customer data in a standardized format.
Besides, we also need to manage customer data to ensure the best customer experience in the order management process.
Sending the customer information before getting authorization does not comply with GDPR data regulations.
Our Klarna payments API can handle both billing and shipping addresses separately. If you do not provide a shipping address, we duplicate the billing address and use it as the shipping address in our customer data.
During our assessment, the fraud risk might be higher if:
The customer data you send us in later calls after authorize() is merged with the data you entered previously.
If any mandatory field is still missing in the authorize() call, you get an error message. You then need to collect the missing data and attempt a new authorize() call to complete the purchase.
Depending on the data standards of each country, we require different information per country market. To ensure a friendly customer experience, you need to properly provide the customer details in the mandatory fields.
street_address2 is only to add extra details to the address, such as the floor and the apartment number. Send the main address information in the regular street_address field.
The following Unicode blocks are supported for all markets except Greek
BASIC_LATIN
LATIN_1_SUPPLEMENT
LATIN_EXTENDED_A
PHONETIC_EXTENSIONS
The following Unicode blocks are supported for the Greek market
BASIC_LATIN
GREEK
GREEK_EXTENDED
Additionally, characters are also matched against the following Unicode categories
Li (Lower case characters)
Lu (Upper case characters)
Nd (Decimal digit number characters)
Please note: Any characters that do not belong to the categories above are considered special characters. Which characters are allowed per field is specified in the market overviews below.
The following table shows the meaning of the symbols you can see in the customer.
| Symbol | Meaning |
|---|---|
| * | Mandatory |
| - | Optional |
| > | Derived |
| ! | See notes |
| ? | Depending on the payment method. Klarna will collect the details in purchase-flow, if not added. |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * postal_code | Validation according to Universal Postal Union addressing systems. |
| ? national_identification_number | Necessary for all credit payment methods and Pay Now. |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - care_of | To address the order to another recipient. B2C purchases only. |
| * city | The city. |
| * 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. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * 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 | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * city | City field according to the market. |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| > gender | Derived from title |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| - postal_code (eircode) | Validation according to Universal Postal Union addressing systems |
| ? date_of_birth | Necessary for all credit payment methods and Pay Now. |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * city | The city. |
| * region | County, E.G "Antrim". |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * postal_code | Validation according to Universal Postal Union addressing systems. |
| ? date_of_birth | Necessary for all credit payment methods. |
| - title | de:“Herr”, “Frau”; de_CH: “Herr, “Frau”; it_CH: “Sig.", “Sig.ra”; fr_CH: “M", “Mme” |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - care_of | To address the order to another recipient. B2C purchases only. |
| * city | The city. |
| - phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| > gender | Derived from title. |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * postal_code | Validation according to Universal Postal Union addressing systems. |
| ? date_of_birth | Necessary for all credit payment methods. |
| - title | nl: “Dhr.", “Mevr.”; nl_BE: “Dhr”, “Mevr”; fr_BE: “M", “Mme” |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - care_of | To address the order to another recipient. B2C purchases only. |
| * city | The city. |
| - phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| > gender | Derived from title. |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * 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 | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * city | The city. |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * 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 | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * city | The city. |
| * region | Province in 2 letter format e.g "AG". |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * 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 | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * city | City field according to the market. |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer Details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * postal_code | Validation according to Universal Postal Union addressing systems. |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * city | City field according to the market. |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer Details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * postal_code | Validation according to Universal Postal Union addressing systems. |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * city | City field according to the market. |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * postal_code | Validation according to Universal Postal Union addressing systems. |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Address line 2, apartment, suite e.g. apt 2. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * region | Use two-letter format, state for US: e.g. “CA” for California. Follows ISO 3166-1 alpha-2. Use full province for CA: e.g "ON" for Ontario. |
| * city | The city. |
| * phone | Follow the standards defined inhttps://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * postal_code | Validation according to Universal Postal Union addressing systems. |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * region | State. Use three-letter format e.g. “QLD” for Queensland. |
| * city | The Suburb. |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |
| Customer details | Comment |
|---|---|
| Must include @ and domain. Pattern: (?<local>^[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'+/=?^_`{|}~-]+)*)@(?<domain>(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+(?<tld>[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$)) | |
| * postal_code | Validation according to Universal Postal Union addressing systems. |
| ? date_of_birth | Necessary for all credit payment methods. |
| * given_name | Customers given name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * family_name | Customers family name in UTF-8 encoding. Cannot be only numbers, must be more than 1 character. Allowed special characters: -'’.°ºᵃª |
| * street_address | Street name and number. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| - street_address2 | Second address line. Allowed special characters: -'´`",.:;#&/()+@ °ºᵃª_ \ |
| * region | Suburb e.g "Avondale" |
| * city | The city. |
| * phone | Follow the standards defined in https://github.com/googlei18n/libphonenumber |