UpdateReservation action

      UpdateReservation action


        Article summary

        Base JSON request

        Use the base request as instructed on this page

        UpdateReservation Request

        The UpdateReservation action can be used in three scenario's.
        The action represents the two separate processes of Klarna. UpdateCustomerAddress and SetNewOrderLinesAndAmount

        1. The consumer wants to change the order with a total amount same or lower then, update the order lines of the reservation.
        2. The consumer wants to change the delivery address, update the Klara shipping address of the reservation.
        3. The consumer wants to update the order and shipping, all update can be shared.

        In case of both the order details and the shipping address are updated. Buckaroo will first request the address change, followed by the order lines change.

        Customer UpdateReservation request

        {
            "Currency": "EUR",
            "Description": "Test KlarnaKP UpdateReservation",
            "Services": {
                "ServiceList": [
                    {
                        "Name": "KlarnaKP",
                        "Action": "UpdateReservation",
                        "Parameters": [
                            {
                                "Name": "ReservationNumber",
                                "Value": "d91f5f42-f011-4611-9575-77bb0446d7d2"
                            },
                            {
                                "Name": "ShippingFirstName",
                                "Value": "Testperson-nl"
                            },
                            {
                                "Name": "ShippingLastName",
                                "Value": "Approved"
                            },
                            {
                                "Name": "ShippingStreet",
                                "Value": "Jaherkade 3 D"
                            },
                            {
                                "Name": "ShippingPostalCode",
                                "Value": "2521VA"
                            },
                            {
                                "Name": "ShippingCity",
                                "Value": "Gravenhage"
                            },
                            {
                                "Name": "ShippingCountry",
                                "Value": "NL"
                            },
                            {
                                "Name": "ShippingPhoneNumber",
                                "Value": "0698765432"
                            },
                            {
                                "Name": "ShippingEmail",
                                "Value": "customer@buckaroo.io"
                            }
                        ]
                    }
                ]
            }
        }
        

        Order UpdateReservation request

        {
            "Currency": "EUR",
            "Invoice": "Ref.1 OrderID updated",
            "ClientIP": {
                "Type": 0,
                "Address": "0.0.0.0"
            },
            "Services": {
                "ServiceList": [
                    {
                        "Name": "klarnakp",
                        "Action": "UpdateReservation",
                        "Parameters": [
                            {
                                "Name": "ReservationNumber",
                                "Value": "d91f5f42-f011-4611-9575-77bb0446d7d2"
                            },
                            {
                                "Name": "ArticleTitle",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "Blue Toy Car"
                            },
                            {
                                "Name": "ArticleNumber",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "12345"
                            },
                            {
                                "Name": "ArticleType",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "General"
                            },
                            {
                                "Name": "ArticleQuantity",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "1"
                            },
                            {
                                "Name": "ArticlePrice",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "10.00"
                            },
                            {
                                "Name": "ArticleVat",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "21"
                            },
                            {
                                "Name": "ArticleImageUrl",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "https://apod.nasa.gov/apod/image/2210/ngc4631_sherick.jpg"
                            },
                            {
                                "Name": "ArticleProductUrl",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "https://apod.nasa.gov/apod/astropix.html"
                            }
                        ]
                    }
                ]
            }
        }
        
        

        Full UpdatedReservation Request

        {
            "Currency": "EUR",
            "Description": "Test KlarnaKP UpdateReservation",
            "Services": {
                "ServiceList": [
                    {
                        "Name": "KlarnaKP",
                        "Action": "UpdateReservation",
                        "Parameters": [
                            {
                                "Name": "ReservationNumber",
                                "Value": "d91f5f42-f011-4611-9575-77bb0446d7d2"
                            },
                            {
                                "Name": "ShippingFirstName",
                                "Value": "Testperson-nl"
                            },
                            {
                                "Name": "ShippingLastName",
                                "Value": "Approved"
                            },
                            {
                                "Name": "ShippingStreet",
                                "Value": "Jaherkade 3 D"
                            },
                            {
                                "Name": "ShippingPostalCode",
                                "Value": "2521VA"
                            },
                            {
                                "Name": "ShippingCity",
                                "Value": "Gravenhage"
                            },
                            {
                                "Name": "ShippingCountry",
                                "Value": "NL"
                            },
                            {
                                "Name": "ShippingPhoneNumber",
                                "Value": "0698765432"
                            },
                            {
                                "Name": "ShippingEmail",
                                "Value": "customer@buckaroo.io"
                            },
                            {
                                "Name": "ArticleTitle",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "Blue Toy Car"
                            },
                            {
                                "Name": "ArticleNumber",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "12345"
                            },
                            {
                                "Name": "ArticleType",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "General"
                            },
                            {
                                "Name": "ArticleQuantity",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "1"
                            },
                            {
                                "Name": "ArticlePrice",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "10.00"
                            },
                            {
                                "Name": "ArticleVat",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "21"
                            },
                            {
                                "Name": "ArticleImageUrl",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "https://apod.nasa.gov/apod/image/2210/ngc4631_sherick.jpg"
                            },
                            {
                                "Name": "ArticleProductUrl",
                                "GroupType": "Article",
                                "GroupID": "1",
                                "Value": "https://apod.nasa.gov/apod/astropix.html"
                            },
                            {
                                "Name": "ArticleTitle",
                                "GroupType": "Article",
                                "GroupID": "2",
                                "Value": "Shipping Fee"
                            },
                            {
                                "Name": "ArticleNumber",
                                "GroupType": "Article",
                                "GroupID": "2",
                                "Value": "123456"
                            },
                            {
                                "Name": "ArticleType",
                                "GroupType": "Article",
                                "GroupID": "2",
                                "Value": "ShipmentFee"
                            },
                            {
                                "Name": "ArticleQuantity",
                                "GroupType": "Article",
                                "GroupID": "2",
                                "Value": "1"
                            },
                            {
                                "Name": "ArticlePrice",
                                "GroupType": "Article",
                                "GroupID": "2",
                                "Value": "4.95"
                            },
                            {
                                "Name": "ArticleVat",
                                "GroupType": "Article",
                                "GroupID": "2",
                                "Value": "21"
                            },
                            {
                                "Name": "ArticleType",
                                "GroupType": "Article",
                                "GroupID": "3",
                                "Value": "Discount"
                            },
                            {
                                "Name": "ArticleTitle",
                                "GroupType": "Article",
                                "GroupID": "3",
                                "Value": "Discount on product"
                            },
                            {
                                "Name": "ArticleNumber",
                                "GroupType": "Article",
                                "GroupID": "3",
                                "Value": "1234567"
                            },
                            {
                                "Name": "ArticleQuantity",
                                "GroupType": "Article",
                                "GroupID": "3",
                                "Value": "1"
                            },
                            {
                                "Name": "ArticlePrice",
                                "GroupType": "Article",
                                "GroupID": "3",
                                "Value": "-2.50"
                            },
                            {
                                "Name": "ArticleVat",
                                "GroupType": "Article",
                                "GroupID": "3",
                                "Value": "0"
                            }
                        ]
                    }
                ]
            }
        }
        

        Request Parameters

        ParameterTypeOCMDescription
        ArticleTitlestringMName of article
        ArticleNumberstringOUnique product number
        ArticleTypestringOAllowed values: physical / digital / shipping_fee / surcharge / discount / gift_card / store_credit
        ArticlePricedecimalMPrice Including VAT
        ArticleQuantityintegerMNumber of articles
        ArticleVatdecimalOVAT percentage
        ArticleImageUrlstringOUrl of Product image
        ArticleProductUrlstringOUrl of PDP
        ShippingFirstNamestringODelivery address first name.
        ShippingLastNameStringODelivery address last name.
        ShippingStreetstringODelivery address 1st address line
        ShippingStreet2stringODelivery address 2nd address line
        ShippingPostalCodestringODelivery address postal code
        ShippingCitystringODelivery address city
        ShippingCountrystringODelivery address country code
        ShippingEmailstringODelivery address email address
        ShippingCellPhoneNumberstringODelivery address phone number

        UpdateReservation response

        {
            "Key": "354CEDA9094E4699931FAE6DB22485C0",
            "Status": {
                "Code": {
                    "Code": 190,
                    "Description": "Success"
                },
                "SubCode": {
                    "Code": "S990",
                    "Description": "The request was successful."
                },
                "DateTime": "2023-03-27T09:30:27"
            },
            "RequiredAction": null,
            "Services": null,
            "CustomParameters": null,
            "AdditionalParameters": null,
            "RequestErrors": null,
            "ServiceCode": "KlarnaKp",
            "IsTest": true,
            "ConsumerMessage": null
        }
        

        Response Parameters

        ParameterTypeOCMDescription
        ServiceCodestringMKlarna serivce label is KlarnaKp
        CodestringMContains the status of the UpdateReservation not the Reservation
        IsTestbooleanMIf their is actual funds processed

        UpdateReservation push

        {
          "DataRequest": {
            "Key": "13F9A3BBE2B045D9B97FD51BE11A2F23",
            "Invoice": null,
            "ServiceCode": "KlarnaKp",
            "ActionCode": "UpdateReservation",
            "Status": {
              "Code": {
                "Code": 190,
                "Description": "The request was successful."
              },
              "SubCode": null,
              "DateTime": "2023-03-27T09:29:37"
            },
            "IsTest": true,
            "Order": null,
            "Currency": "EUR",
            "AmountDebit": 0,
            "Services": null,
            "CustomParameters": null,
            "AdditionalParameters": null,
            "MutationType": 0,
            "IssuingCountry": null,
            "StartRecurrent": false,
            "Recurring": false,
            "CustomerName": null,
            "PayerHash": null,
            "PaymentKey": null
          }
        }
        

        Push Parameters

        ParameterTypeOCMDescription
        ServiceCodestringMKlarna serivce label is KlarnaKp
        CodestringMContains the status of the UpdateReservation not the Reservation
        IsTestbooleanMIf their is actual funds processed

        Was this article helpful?