v1

latestOpenAPI 3.0.12026-08-0643087.3 KB

Session management API

Creates a new session

post/pps/api/v1/session

Headers

Idempotency-Keystring

Optional ID generated by client to uniquely identify the request. It is highly recommended to use a UUID version 4. Do not reuse an idempotency key for different calls. See Idempotency in HPP for further details.

Request body

Example request

{
  "order_data": {
    "buyer": {
      "billing_address": {
        "city": "Berlin",
        "country_code": "DE",
        "street": "Schönhauser Allee",
        "street_addition": "Seitenflügel, 2. HH",
        "street_number": "84",
        "zip_code": "10439"
      }
    },
    "delivery": {
      "address": {
        "city": "Berlin",
        "country_code": "DE",
        "street": "Schönhauser Allee",
        "street_addition": "Seitenflügel, 2. HH",
        "street_number": "84",
        "zip_code": "10439"
      }
    },
    "payment_method": {
      "payment_option": "OPEN_INVOICE",
      "transfer_type": "BANK_TRANSFER"
    }
  }
}

Response

Session created successfully

session_idstring

landing_pagestring required