Skip to main content

Data Types

CreateOrderModel

NameDescriptionTypeAdditional Information
merchantOrderNumberA 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-123StringMax length: 32
countryCodeString
currencyString
mobilePhoneNumberString
tagsArray of String
orderItemsThe 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 ItemsFree order items/rows, like gift cards, can have a value of 0, denoting no cost
callbackUriTo receive a callback when an order status changes, you need a web server receiving HTTP POST calls.
termsUriURI to a page with webshop terms.StringMust be a valid URI
Must be accessible by end customer
Max length: 500
deferredDeliveryTo flag an order with deferred delivery, set the "deferredDelivery" property to true (default: false) when creating the order.BooleanMore Information
minutesUntilLinkExpiresInt32
presetValuesCollection of PresetValue
requireElectronicIdAuthenticationBoolean
merchantName
partnerKeyProvided by Svea to select partners.Guid
identityFlagsUsed to control what actions the user is able to performIdentityFlags
required field

Order Model

NameDescriptionTypeAdditional Information
smsSentSuccessfullyWhether the Instore link was send to customer successfullyBoolean
merchantOrderNumberOrder No from Merchant systemString
instoreUiUriInstore URL generatedString
orderStatusStatus of the orderString
paymentOrderIdCheckout Order Id which identifies an Order , which can be used for managing OrdersString
orderItemsCart

Order Items

caution

Quantity, UnitPrice, DiscountPercent, DiscountAmount and VatPercent for each order row expected to be given in minor units.

NameDescriptionTypeAdditional InformationExamples
ArticleNumberArticle numberStringMax length: 256
NameArticle name.StringMax length: 40
QuantityQuantity of the product.Int641-7 digits
Minor Units.
UnitPricePrice of the product including VAT.Int641-13 digits
Can be negative.
Minor Units.
DiscountPercentThe discount percent of the order row.
Cannot be used together with DiscountAmount
Int64Min: 0
Max: 10000
No fractions
Minor Units.
0 = 0%
100 = 1%
9900 = 99%
10000 = 100%
DiscountAmountThe total discount amount for this order row.
Cannot be used together with DiscountPercent
Int64Min: 0
Max: Order row total
Minor Units.
VatPercentThe VAT percentage of the current product. Valid vat percentage for that country.Int64Minor Units.
UnitThe unit type, e.g., “st”, “pc”, “kg” etc.StringMax length: 4
RowNumberThe row number the row will have in the Webpay systemInt32
MerchantDataMetadata visible to the storeStringMax length: 255
Cleaned up from Checkout database after 45 days.
required field

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.

NameDescriptionTypeAdditional InformationExamples
ArticleNumberArticle numberStringMax length: 256
NameArticle name.StringMax length: 40
QuantityQuantity of the product.Int641-7 digits
Minor Units.
UnitPricePrice of the product including VAT.Int641-13 digits
Can be negative.
Minor Units.
DiscountPercentThe discount percent of the order row.
Cannot be used together with DiscountAmount
Int64Min: 0
Max: 10000
No fractions
Minor Units.
0 = 0%
100 = 1%
9900 = 99%
10000 = 100%
DiscountAmountThe total discount amount for this order row.
Cannot be used together with DiscountPercent
Int64Min: 0
Max: Order row total
Minor Units.
VatPercentThe VAT percentage of the current product. Valid vat percentage for that country.Int64Minor Units.
UnitThe unit type, e.g., “st”, “pc”, “kg” etc.StringMax length: 4
RowNumberThe row number the row will have in the Webpay systemInt32
MerchantDataMetadata visible to the storeStringMax length: 255
Cleaned up from Checkout database after 45 days.
required field

PresetValue

NameDescriptionTypeAdditional Information
TypeNameName of the field you want to set (see limits below).String
ValueSee limits below.String
IsReadonlySet this to true if you don't want the end customer to be able to change the value in the Checkout.Boolean
required field

List of presetvalue typenames

NameTypeAdditional Information
NationalIdStringCountry-specific validation.
EmailAddressStringMax 50 characters. Must be a valid email address.
PhoneNumberString1-18 digits, can include “+”, “-“s and space.
PostalCodeStringCountry-specific validation.
IsCompanyBooleanRequired if nationalid is set to "read only"

Customer

NameDescriptionType
fullNameString
firstNameString
lastNameString
streetAddressString
coAddressString
postalCodeString
cityString
isGenericBoolean
addressLinesArray of String

IdentityFlags

NameDescriptionTypeAdditional Information
HideNotYouBoolean
HideChangeAddressBoolean
HideAnonymousBoolean