Data Types
CreateOrderModel
Name | Description | Type | Additional Information |
---|---|---|---|
merchantOrderNumber | A string that identifies the order in the merchant’s systems. The merchantOrderNumber is unique per order. If using Vipps payment method, allowed values are any combination of: A-Z , a-z , 0-9 , - and _ (underscore). Example for Vipps: abc-12d-efg-123 | String | Max length: 32 |
countryCode | String | ||
currency | String | ||
mobilePhoneNumber | String | ||
tags | Array of String | ||
orderItems | The total cost of the order rows in the cart needs to be equal or higher than 0 but the cart must not be empty. | Order Items | Free order items/rows, like gift cards, can have a value of 0, denoting no cost |
callbackUri | To receive a callback when an order status changes, you need a web server receiving HTTP POST calls. | ||
termsUri | URI to a page with webshop terms. | String | Must be a valid URI Must be accessible by end customer Max length: 500 |
deferredDelivery | To flag an order with deferred delivery, set the "deferredDelivery" property to true (default: false) when creating the order. | Boolean | More Information |
minutesUntilLinkExpires | Int32 | ||
presetValues | Collection of PresetValue | ||
requireElectronicIdAuthentication | Boolean | ||
merchantName | |||
partnerKey | Provided by Svea to select partners. | Guid | |
identityFlags | Used to control what actions the user is able to perform | IdentityFlags |
Order Model
Name | Description | Type | Additional Information |
smsSentSuccessfully | Whether the Instore link was send to customer successfully | Boolean | |
merchantOrderNumber | Order No from Merchant system | String | |
instoreUiUri | Instore URL generated | String | |
orderStatus | Status of the order | String | |
paymentOrderId | Checkout Order Id which identifies an Order , which can be used for managing Orders | String | |
orderItems | Cart |
Order Items
caution
Quantity, UnitPrice, DiscountPercent, DiscountAmount and VatPercent for each order row expected to be given in minor units.
Name | Description | Type | Additional Information | Examples |
---|---|---|---|---|
ArticleNumber | Article number | String | Max length: 256 | |
Name | Article name. | String | Max length: 40 | |
Quantity | Quantity of the product. | Int64 | 1-7 digits Minor Units. | |
UnitPrice | Price of the product including VAT. | Int64 | 1-13 digits Can be negative. Minor Units. | |
DiscountPercent | The discount percent of the order row. Cannot be used together with DiscountAmount | Int64 | Min: 0 Max: 10000 No fractions Minor Units. | |
DiscountAmount | The total discount amount for this order row. Cannot be used together with DiscountPercent | Int64 | Min: 0 Max: Order row total Minor Units. | |
VatPercent | The VAT percentage of the current product. Valid vat percentage for that country. | Int64 | Minor Units. | |
Unit | The unit type, e.g., “st”, “pc”, “kg” etc. | String | Max length: 4 | |
RowNumber | The row number the row will have in the Webpay system | Int32 | ||
MerchantData | Metadata visible to the store | String | Max length: 255 Cleaned up from Checkout database after 45 days. |
OrderRow
caution
Quantity, UnitPrice, DiscountPercent, DiscountAmount and VatPercent for each order row expected to be given in minor units.
caution
Maximum allowed number of rows per order is 1000.
Name | Description | Type | Additional Information | Examples |
---|---|---|---|---|
ArticleNumber | Article number | String | Max length: 256 | |
Name | Article name. | String | Max length: 40 | |
Quantity | Quantity of the product. | Int64 | 1-7 digits Minor Units. | |
UnitPrice | Price of the product including VAT. | Int64 | 1-13 digits Can be negative. Minor Units. | |
DiscountPercent | The discount percent of the order row. Cannot be used together with DiscountAmount | Int64 | Min: 0 Max: 10000 No fractions Minor Units. | |
DiscountAmount | The total discount amount for this order row. Cannot be used together with DiscountPercent | Int64 | Min: 0 Max: Order row total Minor Units. | |
VatPercent | The VAT percentage of the current product. Valid vat percentage for that country. | Int64 | Minor Units. | |
Unit | The unit type, e.g., “st”, “pc”, “kg” etc. | String | Max length: 4 | |
RowNumber | The row number the row will have in the Webpay system | Int32 | ||
MerchantData | Metadata visible to the store | String | Max length: 255 Cleaned up from Checkout database after 45 days. |
PresetValue
Name | Description | Type | Additional Information |
---|---|---|---|
TypeName | Name of the field you want to set (see limits below). | String | |
Value | See limits below. | String | |
IsReadonly | Set this to true if you don't want the end customer to be able to change the value in the Checkout. | Boolean |
List of presetvalue typenames
Name | Type | Additional Information |
---|---|---|
NationalId | String | Country-specific validation. |
EmailAddress | String | Max 50 characters. Must be a valid email address. |
PhoneNumber | String | 1-18 digits, can include “+”, “-“s and space. |
PostalCode | String | Country-specific validation. |
IsCompany | Boolean | Required if nationalid is set to "read only" |
Customer
Name | Description | Type |
---|---|---|
fullName | String | |
firstName | String | |
lastName | String | |
streetAddress | String | |
coAddress | String | |
postalCode | String | |
city | String | |
isGeneric | Boolean | |
addressLines | Array of String |
IdentityFlags
Name | Description | Type | Additional Information |
---|---|---|---|
HideNotYou | Boolean | ||
HideChangeAddress | Boolean | ||
HideAnonymous | Boolean |