Skip to main content
Français Italiano Português

HiPay Enterprise – Klarna

logo_Klarna.png

Service endpoints

There are two endpoints (base URLs) to which you can make your API calls:

  • Stage, if you are testing your integration,
  • and Production, when you have finished testing and want your application to go live.

Environment

Endpoint

Stage

https://stage-secure-gateway.hipay-tpp.com/rest/v1/hpayment

https://stage-secure-gateway.hipay-tpp.com/rest/v1/order

Production

https://secure-gateway.hipay-tpp.com/rest/v1/hpayment

https://secure-gateway.hipay-tpp.com/rest/v1/order

 

Request parameters

To create a Klarna transaction on the HiPay Enterprise Payment Gateway, you must send these mandatory/complementary parameters in your transaction creation call.

(For further details, please refer to the technical documentation.)

 

Format abbreviation

Description

AN

Alphanumeric characters (a-z, A-Z, 0-9)

A

Alphabetic characters only (a-z, A-Z)

N

Numeric characters only

JSON

JavaScript Object Notation

 

Field name

Format

Req.

Description

operation

A

M

 Choose the value: “authorization”

payment_product

AN

M

Payment product

In the case of Klarna: “klarnainvoice”

basket

JSON

M

Shopping cart details

Please refer to “HiPay Enterprise – Payment Gateway – Shopping cart management” technical documentation.

language

AN

M

Locale code of your customer

Klarna invoice is only available in Germany through HiPay.

Therefore, the value must be “de_DE”.

country

A

M

Country code of the customer

This two-letter country code complies with ISO 3166-1 (alpha 2). Klarna invoice is only available in Germany through HiPay.

Therefore, the value must be “DE”.

gender

A

M

Gender of the customer

(M = male, F = female)

birthdate

N

M

Date of birth of the customer (YYYYMMDD)

Example: 19771215

firstname

AN

M

Customer’s first name

lastname

AN

M

Customer’s last name

streetaddress

AN

M

Street name of the customer’s address

Example: Hellersbergstraße

house_number

N

M

House number of the customer’s address
Example: 14

zipcode

N

M

Zip or postal code of the customer,

5 numbers max. Example: 41460

city

AN

M

Customer’s city

msisdn

N

M

Customer’s phone number,

15 numbers max.

Example: 0152211335

email

AN

M

Customer’s email address

ipaddr

AN

M

IPv4 address of the purchasing customer

 

 Example

{
"email": "john.doe@hipay.com",
  "eci": "7",
  "gender": "M",
  "firstname": "john",
  "lastname": "doe",
  "birthdate": "19771215",
  "streetaddress": "Hellersbergstraße",
  "zipcode": "41460",
  "city": "Neuss",
  "house_number": 14,
  "msisdn": "0152211335",
  "description": "This is the description of my order",
  "ipaddr": "77.156.225.124",
  "currency": "EUR",
  "payment_product": "klarnainvoice",
  "orderid": "578cdb0fda266",
  "language": "de_DE",
  "country": "DE",
  "amount": "52.99",
  "basket": [
    {
      "european_article_numbering": "4711892728946",
      "product_reference": "NF-a1690",
      "name": "My first product",
      "type": "good",
      "quantity": 1,
      "unit_price": 8.99,
      "discount": 0,
      "tax_rate": "8.20",
      "total_amount": 8.99
    },
    {
      "european_article_numbering": "4713716322385",
      "product_reference": "NF-a0351",
      "name": "My second product",
      "type": "good",
      "quantity": 4,
      "unit_price": 10.5,
      "discount": -2.5,
      "tax_rate": "20",
      "total_amount": 39.5
    },
    {
      "product_reference": "SHIP-e23a6",
      "name": "Shippingfees",
      "type": "fee",
      "quantity": 1,
      "unit_price": 10,
      "discount": 0,
      "tax_rate": "0",
      "total_amount": 10
   },
    {
      "product_reference": "DISC-00f5a",
      "name": "Birthdaygift",
      "type": "discount",
      "quantity": 1,
      "unit_price": 0,
      "discount": -5.5,
      "tax_rate": "0",
      "total_amount": -5.5
    }
  ]
}

Related articles