Creating a Klarna payment

  1. Use all the fields of the table below to create your payment form.
    The fields presented below are mandatory independently of the form to be sent.
    Table 1. Field list
    Field name Description Format Value
    vads_site_id Shop ID n8 E.g.: 12345678
    vads_ctx_mode Operating mode string (enum) TEST or PRODUCTION
    vads_trans_id Transaction number n6 E.g.: 123456
    vads_trans_date Date and time (in UTC format) of the payment form n14 E.g.: 20150901130025
    vads_amount Payment amount, charges included (in the smallest currency unit) n..12 E.g.: 3000 for 30 Euros
    vads_currency Code of the payment currency n3 E.g.: 978 for Euro
    vads_action_mode Acquisition mode for credit card data string (enum) INTERACTIVE
    vads_page_action Action to perform string (enum) PAYMENT
    vads_version Version of the exchange protocol string (enum) V2
    vads_payment_config Payment type string (enum) SINGLE
    vads_capture_delay Delay before capture

    The delay must take into account the availability and the delivery of the products in the order.

    n..3

    empty or 0 to 7 days

    vads_validation_mode Validation mode.

    Klarna recommends the Manual validation mode.

    string (enum) 1 (manual)
  2. Use all the fields of the table below to create your payment form.
    These fields apply specifically to the implementation of the Klarna payment method.
    Note:
    The buyer's country determines the list of mandatory fields.
    Table 2. Fields required for invoicing
    Field name Description Format AT DK FI DE NL NO SE
    vads_cust_national_id National identifier (e.g.: social security number). Specific to each country. ans..255   x x     x x
    vads_birth_day Buyer's day of birth. n..2 x     x x    
    vads_birth_month Buyer's month of birth. n..2 x     x x    
    vads_birth_year Buyer's year of birth. n4 x     x x    
    vads_cust_title Buyer's civil status.

    The possible values are:

    For a woman:

    • MM
    • MS
    • MISS
    • MISTRESS
    • MADAME
    • FRAU
    • FEMELLE

    For a man:

    • MR
    • MISTER
    • HERR
    • MALE

    These values are not case-sensitive. Lower and uppercase letters can be used.

    an..63 x     x x    
    vads_cust_first_name Buyer's first name. an..63 x x x x x x x
    vads_cust_last_name Buyer's last name. an..63 x x x x x x x
    vads_cust_address_number Buyer's street name. an..55       x x    
    vads_cust_address Buyer's postal address. ans..255 x x x x x x x
    vads_cust_zip Buyer's postal code. an..64 x x x x x x x
    vads_cust_city Buyer's city. an..128 x x x x x x x
    vads_cust_country Buyer's country code in the ISO 3166 format. a2 x x x x x x x
    vads_cust_phone Buyer's phone number. an..32 vads_cust_phone et vads_cust_cell_phone are optional. However, it is mandatory to fill in at least one phone number.
    vads_cust_cell_phone Buyer's cell phone number an..32
    vads_cust_email Buyer's e-mail address ans..150 x x x x x x x
    Caption to identify countries:
    AT : Austria DE : Germany DK : Denmark
    FI : Finland NL : The Netherlands NO : Norway
    SE : Switzerland    
  3. Use all the fields of the table below to provide the cart details.
    Table 3. Field list - Cart details
    Field name Format Description Required
    vads_order_id an..32 Order ID. x
    vads_nb_products n..12 Number of products in the cart. x
    vads_product_labelN an..255 Label of each article in the cart.

    N corresponds to the reference of the article.

    (0 for the first one, 1 for the second one, etc.)

    x
    vads_product_amountN n..12 Amounts, including all charges, of different articles in the cart.

    N corresponds to the reference of the article.

    (0 for the first one, 1 for the second one, etc.)

    The amount is presented in the smallest unit of the currency.

    x
    vads_product_refN an..64 Reference of each article in the cart.

    N corresponds to the reference of the article.

    (0 for the first one, 1 for the second one, etc.)

    x
    vads_product_qtyN n..12 Amount of each article in the cart.

    N corresponds to the reference of the article.

    (0 for the first one, 1 for the second one, etc.)

    x
    vads_product_vatN n..12 Tax amount of each article in the cart.

    N corresponds to the reference of the article.

    (0 for the first one, 1 for the second one, etc.)

    This field must be populated with a decimal value (e.g.: 10.0). If the field is not populated, the default VAT on product sales defined at the shop is applied.

     
  4. Add optional fields depending on your requirements (see chapter Using additional functions).
  5. Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature).