Requests
Data request actions:
- Reserve
- CancelReservation
- UpdateReservation
- ExtendReservation
- AddShippingInfo
Transaction request Actions:
- Pay
- Refund
Testing:
The test checkout of Buckaroo communicates with Klarna's Sandbox environment, allowing different supported scenarios to be tested.
Solution:
- Session: Buckaroo offers Klarna redirect to the hosted page, which renders local payment options and language based on API request information. (The hosted page can be offered in English content as well). The session expires in 4 hours, with still pending transactions being closed as failed.
- Order: When a consumer completes steps on the hosted page, the redirect to your confirmation page is triggered, and the reservation is confirmed as valid.
- Fulfillment: Updates may be required between order confirmation and delivery.
Fulfillment Scenarios:
- Cancel reservation if there is no intent to fulfill. (CancelReservation)
- Cancel remaining reservation for partial deliveries. (CancelReservation)
- Update shipping address if changed. (UpdateReservation)
- Update order lines without increasing total amount. (UpdateReservation)
- Extend reservation if delayed delivery. (ExtendReservation)
Payment Scenarios:
- Full pay for all shipped products. (Pay)
- Partial pay for part of the order. (Pay)
- Share shuipment details for delivery. (AddShippinInfo)
Returns and Credits:
- Returns or compensation can be shared with Buckaroo as a refund.
Reserve action
Reserve Request
The reserve action is the first step to process the payment of an order with Klarna. It will return a redirect URL to forward the consumer. It is important to handle the push sent by Buckaroo of the reservation that contains the Buckaroo Reserve Datarequest key. This will require handling the follow-up actions.
Minimal Reserve Request
{
"Currency": "EUR",
"Invoice": "Ref.1 OrderID",
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "Reserve",
"Parameters": [
{
"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": "ArticleTitle",
"GroupType": "Article",
"GroupID": "2",
"Value": "Yellow Toy Train"
},
{
"Name": "ArticleNumber",
"GroupType": "Article",
"GroupID": "2",
"Value": "123456"
},
{
"Name": "ArticleType",
"GroupType": "Article",
"GroupID": "2",
"Value": "General"
},
{
"Name": "ArticleQuantity",
"GroupType": "Article",
"GroupID": "2",
"Value": "1"
},
{
"Name": "ArticlePrice",
"GroupType": "Article",
"GroupID": "2",
"Value": "5.00"
},
{
"Name": "ArticleVat",
"GroupType": "Article",
"GroupID": "2",
"Value": "21"
},
{
"Name": "ArticleTitle",
"GroupType": "Article",
"GroupID": "3",
"Value": "Discount"
},
{
"Name": "ArticleNumber",
"GroupType": "Article",
"GroupID": "3",
"Value": "1234567"
},
{
"Name": "ArticleQuantity",
"GroupType": "Article",
"GroupID": "3",
"Value": "1"
},
{
"Name": "ArticlePrice",
"GroupType": "Article",
"GroupID": "3",
"Value": "-1.00"
},
{
"Name": "ArticleVat",
"GroupType": "Article",
"GroupID": "3",
"Value": "0"
},
{
"Name": "OperatingCountry",
"Value": "DE"
}
]
}
]
}
}Full Reserve Request
{
"Currency": "EUR",
"Invoice": "Ref.1 OrderID",
"ReturnURL": "https://www.buckaroo.nl",
"ReturnURLCancel": "https://www.buckaroo.nl/cancel",
"ReturnURLError": "https://www.buckaroo.nl/mislukt",
"ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "Reserve",
"Parameters": [
{
"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": "ArticleTitle",
"GroupType": "Article",
"GroupID": "2",
"Value": "Yellow Toy Train"
},
{
"Name": "ArticleNumber",
"GroupType": "Article",
"GroupID": "2",
"Value": "123456"
},
{
"Name": "ArticleType",
"GroupType": "Article",
"GroupID": "2",
"Value": "General"
},
{
"Name": "ArticleQuantity",
"GroupType": "Article",
"GroupID": "2",
"Value": "1"
},
{
"Name": "ArticlePrice",
"GroupType": "Article",
"GroupID": "2",
"Value": "5.00"
},
{
"Name": "ArticleVat",
"GroupType": "Article",
"GroupID": "2",
"Value": "21"
},
{
"Name": "ArticleTitle",
"GroupType": "Article",
"GroupID": "3",
"Value": "Discount"
},
{
"Name": "ArticleNumber",
"GroupType": "Article",
"GroupID": "3",
"Value": "1234567"
},
{
"Name": "ArticleQuantity",
"GroupType": "Article",
"GroupID": "3",
"Value": "1"
},
{
"Name": "ArticlePrice",
"GroupType": "Article",
"GroupID": "3",
"Value": "-1.00"
},
{
"Name": "ArticleVat",
"GroupType": "Article",
"GroupID": "3",
"Value": "0"
},
{
"Name": "BillingFirstName",
"Value": "Testperson-nl"
},
{
"Name": "BillingLastName",
"Value": "Approved"
},
{
"Name": "BillingStreet",
"Value": "Neherkade"
},
{
"Name": "BillingHouseNumber",
"Value": "1"
},
{
"Name": "BillingHouseNumberSuffix",
"Value": "1"
},
{
"Name": "BillingPostalCode",
"Value": "2521VA"
},
{
"Name": "BillingCity",
"Value": "Gravenhage"
},
{
"Name": "BillingCountry",
"Value": "NL"
},
{
"Name": "BillingCellPhoneNumber",
"Value": "0612345678"
},
{
"Name": "BillingEmail",
"Value": "[email protected]"
},
{
"Name": "ShippingFirstName",
"Value": "Testperson-nl"
},
{
"Name": "ShippingLastName",
"Value": "Approved"
},
{
"Name": "ShippingStreet",
"Value": "Neherkade"
},
{
"Name": "ShippingHouseNumber",
"Value": "2"
},
{
"Name": "ShippingPostalCode",
"Value": "2521VA"
},
{
"Name": "ShippingCity",
"Value": "Gravenhage"
},
{
"Name": "ShippingCountry",
"Value": "NL"
},
{
"Name": "ShippingPhoneNumber",
"Value": "0698765432"
},
{
"Name": "ShippingEmail",
"Value": "[email protected]"
},
{
"Name": "Gender",
"Value": "1"
},
{
"Name": "OperatingCountry",
"Value": "DE"
},
{
"Name": "Pno",
"Value": "10071970"
},
{
"Name": "ShippingSameAsBilling",
"Value": "false"
}
]
}
]
}
}Reserve Response
A successful request will return a requiredAction redirect URL to forward the consumer to the Hosted page of Klarna.
General Reserve Response
{
"Key": "49EF793FC7AC404EABC4F57A32F5F08D",
"Status": {
"Code": {
"Code": 791,
"Description": "Pending processing"
},
"SubCode": {
"Code": "S002",
"Description": "An additional action is required: Redirect to Klarna"
},
"DateTime": "2026-02-02T14:48:27"
},
"RequiredAction": {
"RedirectURL": "https://checkout.buckaroo.nl/html/redirect.ashx?r=3D349C783491413EBAF06660932EF0BF",
"RequestedInformation": null,
"Name": "Redirect",
"TypeDeprecated": 0
},
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"ServiceCode": "Klarna",
"IsTest": true,
"ConsumerMessage": null
}Reserve Push
{
"DataRequest": {
"Key": "34C088DBD9244F27B3C62C21C7D6D6C8",
"Invoice": "Ref.1 OrderID Reserve",
"ServiceCode": "Klarna",
"ActionCode": "Reserve",
"Status": {
"Code": {
"Code": 190,
"Description": "The request was successful."
},
"SubCode": null,
"DateTime": "2026-02-02T07:28:26"
},
"IsTest": true,
"Order": null,
"Currency": "EUR",
"AmountDebit": 0,
"Services": [
{
"Name": "Klarna",
"Action": null,
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "1A582451AD6F4218BF719909170168A0"
}
],
"VersionAsProperty": 1
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 0,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": null
}
}CancelReservation action
The CancelReservation action can be used in two scenarios:
- There has been no partial capture, a cancel will close the full order.
- There has been a partial capture, a cancel will close the remaining amount and products still part of the reservation.
General CancelReservation Request
{
"Currency": "EUR",
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "CancelReservation",
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "1A582451AD6F4218BF719909170168A0"
}
]
}
]
}
}Request Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| DataRequestKey | string | M | Bukcaroo data request key |
CancelReservation Response
{
"Key": "D24D08A03A2944B9AD9F3723483C5161",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2026-02-02T08:45:24"
},
"RequiredAction": null,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"ServiceCode": "Klarna",
"IsTest": true,
"ConsumerMessage": null
}
Response Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the CancelReservation not the Reservation |
| IsTest | boolean | M | If there are actual funds processed |
CancelReservation Push
{
"DataRequest": {
"Key": "446F21147A2F4415967A2CF393714141",
"Invoice": null,
"ServiceCode": "Klarna",
"ActionCode": "CancelReservation",
"Status": {
"Code": {
"Code": 190,
"Description": "The request was successful."
},
"SubCode": null,
"DateTime": "2026-02-02T08:54:17"
},
"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
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the Cancellation not the Reservation |
| IsTest | boolean | M | If there are actual funds processed |
UpdateReservation action
UpdateReservation Request
The UpdateReservation action can be used in three scenarios:
- The consumer wants to change the order with a total amount same or lower, update the order lines of the reservation.
- The consumer wants to change the delivery address, update the Klarna shipping address of the reservation.
- The consumer wants to update the order and shipping, all updates can be shared.
In case 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 Klarna UpdateReservation",
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "UpdateReservation",
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "654A417764214CFC9406CF086438DA77"
},
{
"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": "[email protected]"
}
]
}
]
}
}Order UpdateReservation Request
{
"Currency": "EUR",
"Invoice": "Ref.1 OrderID updated",
"ClientIP": {
"Type": 0,
"Address": "0.0.0.0"
},
"Services": {
"ServiceList": [
{
"Name": "klarna",
"Action": "UpdateReservation",
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "654A417764214CFC9406CF086438DA77"
},
{
"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 Klarna UpdateReservation",
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "UpdateReservation",
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "BE19E75284354F7F9B7114AAABFAFBA3"
},
{
"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": "[email protected]"
},
{
"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"
}
]
}
]
}
}UpdateReservation Response
{
"Key": "354CEDA9094E4699931FAE6DB22485C0",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2026-02-02T09:30:27"
},
"RequiredAction": null,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"ServiceCode": "Klarna",
"IsTest": true,
"ConsumerMessage": null
}Response Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the UpdateReservation not the Reservation |
| IsTest | boolean | M | If there are actual funds processed |
UpdateReservation Push
{
"DataRequest": {
"Key": "13F9A3BBE2B045D9B97FD51BE11A2F23",
"Invoice": null,
"ServiceCode": "Klarna",
"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
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the UpdateReservation not the Reservation |
| IsTest | boolean | M | If there are actual funds processed |
ExtendReservation action
ExtendReservation
If there is a need to extend the guarantee of Klarna on the reservation, this can be requested by extending the reservation.
ExtendReservation Request
{
"Description": "Test Klarna Extend reservation period",
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "ExtendReservation",
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "C9CDB227F75E43B8B6075CBF9C0A48FE"
}
]
}
]
}
}Request Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| DataRequestKey | string | M | Buckaroo datarequest key |
ExtendReservation Response
{
"Key": "7848CD2D67DA45AA8EAA08BE0E96E99C",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2026-02-02T10:07:45"
},
"RequiredAction": null,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"ServiceCode": "Klarna",
"IsTest": true,
"ConsumerMessage": null
}Response Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the ExtendReservation not the Reservation |
| IsTest | boolean | M | If there are actual funds processed |
ExtendReservation Push
{
"DataRequest": {
"Key": "7848CD2D67DA45AA8EAA08BE0E96E99C",
"Invoice": null,
"ServiceCode": "Klarna",
"ActionCode": "ExtendReservation",
"Status": {
"Code": {
"Code": 190,
"Description": "The request was successful."
},
"SubCode": null,
"DateTime": "2026-02-02T10:07:45"
},
"IsTest": true,
"Order": null,
"Currency": null,
"AmountDebit": 0,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 0,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": null
}
}Push Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the ExtendReservation not the Reservation |
| IsTest | boolean | M | If there are actual funds processed |
Pay action
A pay action should be communicated once the order is being delivered. There are 2 scenarios supported:
- All products are shipped and a full pay is requested
- Part of the order is shipped and a partial pay is requested
Pay Full Request
{
"Currency": "EUR",
"AmountDebit": 12.34,
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "Pay",
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "C9CDB227F75E43B8B6075CBF9C0A48FE "
}
]
}
]
}
}Pay Partial Request
{
"Currency": "EUR",
"AmountDebit": 10.00,
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "Pay",
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "C9CDB227F75E43B8B6075CBF9C0A48FE"
},
{
"Name": "ArticleNumber",
"GroupType": "Article",
"GroupID": "1",
"Value": "12345"
},
{
"Name": "ArticleQuantity",
"GroupType": "Article",
"GroupID": "1",
"Value": "1"
}
]
}
]
}
}Pay with Shipping Details Request
{
"Currency": "EUR",
"AmountDebit": 22.45,
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "Pay",
"Parameters": [
{
"Name": "DataRequestKey",
"Value": "C9CDB227F75E43B8B6075CBF9C0A48FE"
},
{
"Name": "ShippingMethod",
"GroupType": "ShippingInfo",
"GroupID": "1",
"Value": "HOME"
},
{
"Name": "Company",
"GroupType": "ShippingInfo",
"GroupID": "1",
"Value": "DHL Express"
},
{
"Name": "TrackingNumber",
"GroupType": "ShippingInfo",
"GroupID": "1",
"Value": "AAAA1234567890"
}
]
}
]
}
}Request Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| DataRequestKey | string | M | Reserve datarequest key |
| ArticleNumber | string | O | Unique product number |
| ArticleQuantity | integer | M | Number of articles |
| ShippingMethod | string | O | Allowed values: PickUpStore, Home, BoxReg, BoxUnreg, PickUpPoint, Own, Postal, DHLPackstation, Digital, Undefined, PickUpWarehouse, ClickCollect, PalletDelivery |
| Company | string | O | Name of the shipping company |
| TrackingNumber | string | O | Unique tracking number |
Pay Response
{
"Key": "0EABAA91DB7B47C6B5E6BC7AFB209162",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2026-02-02T13:58:04"
},
"RequiredAction": null,
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "Klarna_Test_1770382683",
"ServiceCode": "klarna",
"IsTest": false,
"Currency": "EUR",
"AmountDebit": 10.29,
"TransactionType": "C339",
"MutationType": 1,
"RelatedTransactions": null,
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "8C47A5A5CC3E4B46BB6C883ACADA6695"
}Response Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the Pay |
| IsTest | boolean | M | If there are actual funds processed |
Pay Push
{
"Transaction": {
"Key": "058ABA06A4A24840AB6B77FA5689CAF2",
"Invoice": "Ref.1 OrderID Pay",
"ServiceCode": "Klarna",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2026-02-02T13:46:17"
},
"IsTest": true,
"Order": null,
"Currency": "EUR",
"AmountDebit": 10.29,
"TransactionType": "C339",
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": null,
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "D21F647EE3284E16AC1F3A5C99053CAE",
"Description": null
}
}Push Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the transaction |
| IsTest | boolean | M | If there are actual funds processed |
Refund action
Refund
Use the parameter AmountCredit to specify the refund amount and OriginalTransactionKey to refer to the payment transaction.
Refund request with articles
{
"Currency": "EUR",
"AmountCredit": 10.00,
"Invoice": "Ref.1 OrderID Refund",
"OriginalTransactionKey": "855CFD51867241FCAB5E23ADB49C1C3E",
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "Refund",
"Parameters": [
{
"Name": "ArticleNumber",
"GroupType": "Article",
"GroupID": "1",
"Value": "12345"
},
{
"Name": "ArticleQuantity",
"GroupType": "Article",
"GroupID": "1",
"Value": "1"
}
]
}
]
}
}Refund request amount based
{
"Currency": "EUR",
"AmountCredit": 12.45,
"Invoice": "Ref.1 OrderID Refund",
"OriginalTransactionKey": "3CB70527A86E4111BC72CC87A0D459DA",
"Services": {
"ServiceList": [
{
"Name": "Klarna",
"Action": "Refund"
}
]
}
}Request Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| OriginalTransactionKey | string | M | Buckaroo reference to the Capture at Klarna |
Refund response
{
"Key": "7F98D7EE65E844FAB7C67CDF15761B54",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2026-02-06T14:12:01"
},
"RequiredAction": null,
"Services": [
{
"Name": "klarna",
"Action": null,
"Parameters": [
{
"Name": "Processed",
"Value": "Classic"
}
]
}
],
"CustomParameters": null,
"AdditionalParameters": null,
"RequestErrors": null,
"Invoice": "Klarna_Test_1770383519",
"ServiceCode": "klarna",
"IsTest": false,
"Currency": "EUR",
"AmountCredit": 10.29,
"TransactionType": "C340",
"MutationType": 1,
"RelatedTransactions": null,
"ConsumerMessage": null,
"Order": null,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": "FD9934BF165142A6841701F05575B814"
}Refund push
{
"Transaction": {
"Key": "7F98D7EE65E844FAB7C67CDF15761B54",
"Invoice": "Ref.1 OrderID Refund",
"ServiceCode": "Klarna",
"Status": {
"Code": {
"Code": 190,
"Description": "Success"
},
"SubCode": {
"Code": "S990",
"Description": "The request was successful."
},
"DateTime": "2026-02-02T14:24:55"
},
"IsTest": true,
"Order": null,
"Currency": "EUR",
"AmountCredit": 1,
"TransactionType": "C340",
"Services": null,
"CustomParameters": null,
"AdditionalParameters": null,
"MutationType": 1,
"RelatedTransactions": [
{
"RelationType": "refund",
"RelatedTransactionKey": "0EABAA91DB7B47C6B5E6BC7AFB209162"
}
],
"IsCancelable": false,
"IssuingCountry": null,
"StartRecurrent": false,
"Recurring": false,
"CustomerName": null,
"PayerHash": null,
"PaymentKey": " FD9934BF165142A6841701F05575B814",
"Description": null
}
}Push Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| ServiceCode | string | M | Service label is Klarna |
| Code | string | M | Contains the status of the transaction |
| IsTest | boolean | M | If there are actual funds processed |
| RelatedTransactionKey | string | O | Contains the Pay Transaction Key of Buckaroo |
Reserve Action
Request Parameters
| Parameter | Type | OCM | Description |
|---|---|---|---|
| locale | string | O | Allowed Values nl-NL / en-NL / nl-BE / fr-BE / be-BE / en-BE / de-DE / en-DE / de-AT / en-AT / de-CH / fr-CH / it-CH / en-CH / sv-SE / en-SE / nb-NO / en-NO / da-DK / en-DK / fi-FI / sv-FI / en-FI / en-GB / en-IE / fr-FR / en-FR / it-IT / en-IT / es-ES / en-ES / pt-PT / en-PT / pl-PL / en-PL |
| OperatingCountry | string | M | Allowed values NL / BE / DE / AT / CH / DK / SE / NO / GB / FI / PL / IE / FR / IT / ES / PT |
| ArticleTitle | string | M | Name of article |
| ArticleNumber | string | O | Unique product number |
| ArticleType | string | O | Allowed values: physical / digital / shipping_fee / surcharge / discount / gift_card / store_credit |
| ArticlePrice | decimal | M | Price Including VAT |
| ArticleQuantity | integer | M | Number of articles |
| ArticleVat | decimal | O | VAT percentage |
| ArticleImageUrl | string | O | Url of Product image |
| ArticleProductUrl | string | O | Url of PDP |
| BillingFirstName | string | O | Customer first name |
| BillingLastName | string | O | Customer's last name |
| BillingStreet | string | O | Customer 1st line address |
| BillingStreet2 | string | O | Customer 2nd line address |
| BillingPostalCode | string | O | Customer postal code |
| BillingCellPhoneNumber | string | O | Customer phone number |
| BillingCity | string | O | Customer city |
| BillingCountry | string | O | Customer Country |
| BillingEmail | string | O | Customer email address |
| Pno | string | O | Customer birthdate format: DDMMYYYY or Customer PNO |
| ShippingSameAsBilling | boolean | O | Customer address and shipping address are the same, TRUE / FALSE |
| ShippingCareOf | string | O | Person/company receiving the shipment on behalf of the shipping recipient |
| ShippingFirstName | string | O | Delivery address first name. |
| ShippingLastName | string | O | Delivery address last name. |
| ShippingStreet | string | O | Delivery address 1st address line |
| ShippingStreet2 | string | O | Delivery address 2nd address line |
| ShippingPostalCode | string | O | Delivery address postal code |
| ShippingCity | string | O | Delivery address city |
| ShippingCountry | string | O | Delivery address country code. It should be the same as the Billing country. |
| ShippingEmail | string | O | Delivery address email address |
| ShippingCellPhoneNumber | string | O | Delivery address phone number |
| ShippingCompany | string | O | Delivery address company name |
| ContentType | string | O | Content type agreed with Klarna ex. "application/vnd.klarna.internal.emd-v2+json" |
| Body | string | O | Additional Parameters based on the agreed format with Klarna |
Updated 7 days ago