Data Types

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		String

required field

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

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.	0 = 0% 100 = 1% 9900 = 99% 10000 = 100%
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.

required field

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.	0 = 0% 100 = 1% 9900 = 99% 10000 = 100%
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.

required field

Name	Description	Type
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

required field

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"