Update order session
Update a session that was created with Create order session.
totalOrderAmount
, totalOrderVatAmount
and totalOrderAmountExclVat
are the only required fields.
If new order lines are provided then the corresponding new total amounts should also be provided, like in the example below.
If new order lines are provided, all order lines in the already existing order session will be deleted and replaced.
- Example Request
- Example Response
curl -X POST \
-H 'authorization: Bearer v4.public.eyJpc3MiOiJs...' \
-H 'content-type: application/json' \
-d '{
"orderLines": [
{
"description": "Coffee Machine X200",
"quantity": 10,
"reference": "111-222-333",
"totalAmount": 500000,
"totalVatAmount": 100000,
"type": "physical",
"unitDiscountAmount": 0,
"unitPrice": 50000,
"vat": 2500
},
{
"description": "Shipping fee",
"quantity": 1,
"reference": "444-555-666",
"totalAmount": 10000,
"totalVatAmount": 2000,
"type": "shippingFee",
"unitDiscountAmount": 0,
"unitPrice": 10000,
"vat": 2500
}
],
"totalOrderAmount": 510000,
"totalOrderAmountExclVat": 408000,
"totalOrderVatAmount": 102000
}'
https://api.sandbox.ledyer.com/v1/sessions/:sessionId
Path parameters
sessionId
The session ID string that was obtained when the session was created.
Request body
country
stringOptionalCountry code such as SE
, FI
etc (ISO 3166-1 alpha-2).
currency
stringOptionalExample SEK
, NOK
(ISO 4217 alpha).
locale
stringOptionalSpecify language for the checkout, sv-SE
, da-DK
etc (BCP 47).
metadata
objectOptionalMerchant may send a key/value object literal for internal use.
Example: { "property1": "value1", "property2": "value2" }
.
orderLines
array of orderlinesOptionalAn array of order lines.
reference
stringOptionalThis property can be used for merchant order reference and will be visible on the invoice. Maximum of 50 characters.
settings
objectOptionalAn object containing various setting possibilities.
settlementReference
stringOptionalMaximum of 50 characters.
totalOrderAmount
integerTotal order amount in minor units.
totalOrderAmountExclVat
integerTotal order amount excl. VAT in minor units.
totalOrderVatAmount
integerTotal order VAT amount in minor units.
{
"checkoutUrl": "https://www.example.com",
"expiresAt": "2021-09-01T11:25:32.805672147Z",
"orderId": "or_1xDXf4gwlsnyERFywD9VYZT0Tpp",
"sessionId": "se_1xDXf4JI3PJsGeVAvLE3hHqYS09"
}
Handling sessions
The sessionId
should be stored and re-used until the purchase has been completed or the expiresAt
time has been reached. The orderId
should only be used in Backend to Backend calls.