Created with Sketch.
Created with Sketch.
Checkout 3.0

Checkout 3 API Types

Customer Address

NameTypeDescription
FirstNamestring0-40 length
LastNamestring0-40 length
Address1string 0-100 length
Address2string0-100 length
Zipstring 5 length
Citystring 0-30 length
CountrystringMandatory if Branch setup contains ShowCountryInCheckoutForm set on true
CareOfAddressboolTrue if address is ‘C/O’ type. Otherwise false
DoorCodestring0-30 length

Company Address

NameTypeDescription
Namestring0-40 length
Address1string 0-100 length
Address2string0-100 length
Zipstring 5 length
Citystring 0-30 length
CountrystringMandatory if Branch setup contains ShowCountryInCheckoutForm set on true
CareOfAddressboolTrue if address is ‘C/O’ type. Otherwise false
DoorCodestring0-30 length

Delivery Address

NameTypeDescription
TypeDeliveryAddressTypeType of address (Private/Company)
ViewTypeDeliveryAddressViewTypeState of address
FirstNamestring0-40 length
LastNamestring0-40 length
Address1string 0-100 length
Address2string0-100 length
Zipstring 5 length
Citystring 0-30 length
CountrystringMandatory if Branch setup contais ShowCountryInCheckoutForm set on true
CareOfAddressboolTrue if address is ‘C/O’ type. Otherwise false
DoorCodestring0-30 length

Delivery Address Type

Name Value Description
Default"Default"Delivery address type can not be changed. The Private type is used as default
Private"Private"Delivery address type is set on Private
Company"Company"Delivery address type is set on Company

Delivery Address View Type

Name Value Description
Unchecked"Unchecked"Delivery address is not specified.
InvalidEditable"InvalidEditable"Delivery address is in editable state
ValidPreview"ValidPreview"Delivery address is specified and valid

Purchase Mode Type

Name Value Description
B2C"B2C"The purchase is made on end-customer’s own name.
B2B"B2B"The purchase is made on behalf of an organization.

Check-box state Type

Name Value Description
Hidden"Hidden"Check-box input is hidden
Unchecked"Unchecked" Check-box input is unchecked
Checked"Checked" Check-box input is checked

Language

For language you can either use enum value or string value.

Name Value String ValueDescription
English0"English"English language
Swedish1 "Swedish"Swedish language
Finnish2"Finnish"Finnish language
Norwegian3"Norwegian"Norwegian language
Estonian4"Estonian"Estonian language
Danish5"Danish"Danish language
Czech6"Czech"Czech language
Latvian7"Latvian"Latvian language
Slovak9"Slovak"Slovak language
Polish10"Polish"Polish language

Payment Method Type

Name Value
Invoice"Invoice"
Loan"Loan"
Card"Card"
DirectPayment"DirectPayment"
PartPayment"PartPayment"
Swish"Swish"
HighAmountLoan"HighAmountLoan"
PayPal"PayPal"
PayOnDelivery"PayOnDelivery"
B2BInvoice"B2BInvoice"
DirectInvoice"DirectInvoice"
Masterpass"Masterpass"
MobilePay"MobilePay"
Vipps"Vipps"
ZeroAmount"ZeroAmount"

Item

PropertyData typeDescription
DescriptionstringItem name / 0-35 length
Notes string Item notes / 0-35 length
AmountstringPrice of the product inclusive of tax
TaxCodestringTax code
TaxAmountstringTax amount
QuantitydecimalQuantity of the same product. If quantity is used, the amount and taxAmount parameter should be defined for a single item.

Checkout Setup

PropertyData typeDescription
SelectedPaymentMethodTypePaymentMethodTypePreselected payment method. (Setup is not applicable for the Sweden market)
RecurringPaymentsCheckBoxStateTypeList of item objects . Can be set only when Checkout site definition have allowed Recurring payments
EmailInvoiceCheckBoxStateTypeSetup of recurring send invoice by email check-box. Can be set only when Checkout site definition have allowed Email invoice
LanguageLanguageIn which language to display the checkout form.
ModePurchaseModeB2C or B2B. Default is B2C
CompletedNotificationUrlstringCallback URL called after complete payment
DisplayItemsboolParameters that tells whether the item list should be displayed inside the checkout form. If true, checkout will contains view with purchase list of items.
smsNewsletterSubscriptionTextstringCustom SMS newsletter subscription text visible when completing payment. This setup will replace default text.
emailNewsletterSubscriptionTextstringCustom Email newsletter subscription text visible when completing payment. This setup will replace default text.
SmsNewsletterSubscriptionCheckBoxStateTypeWhether to offer a SMS newsletter subscription and whether it should be selected by default.
EmailNewsletterSubscriptionCheckBoxStateTypeWhether to offer a Email newsletter subscription and whether it should be selected by default.
DifferentDeliveryAddressCheckBoxStateTypeDelivery address check-box setup. Checked can be only with valid delivery address
TermsAndConditionsUrlstringCustom T&C link. This setup replace set T&C link from Partner onboarding application
IntegrityConditionsUrlstringCustom integrity link. This setup replace set T&C link from Partner onboarding application
EnableB2BLinkboolEnable or disable b2b link visibility
EnableCountrySelectorboolEnable or disable country selector
ShowThankYouPageboolParameter to show or hide thank you page

B2C Info

PropertyData typeDescription
CustomerTokenstringCustomer’s token
InvoicingAddressAddressCustomerCustomer’s invoicing address
DeliveryAddressDeliveryAddressCustomer’s delivery address
UserInputsUserInputsUser inputs

B2B Info

PropertyData typeDescription
InvoicingAddressAddressCompanyCompany’s invoicing address
DeliveryAddressDeliveryAddressCompany’s delivery address
UserInputsB2BUserInputsUser inputs

Delivery Address

PropertyData typeDescription
Address1string 0-100 length
Address2string 0-100 length
Zipstring 5 length
City string 0-30 length
Country string Mandatory if Branch setup contains ShowCountryInCheckoutForm set on true
FirstName string 0-40 length
LastName string 0-40 length
TypeDeliveryAddressType Type of address (Private/Company)

B2C User Inputs

PropertyData typeDescription
Phone string Customer’s phone number passed by a partner’s application.
EmailstringCustomer’s e-mail address passed by a partner’s application.

B2B User Inputs

PropertyData typeDescription
Phone string Customer’s phone number passed by a partner’s application.
EmailstringCustomer’s e-mail address passed by a partner’s application.
Reference string Custom customer’s reference for payment identifying

Extra Identifiers

PropertyData typeDescription
OrderReference string Merchant custom ID reference
LoyaltyNumberstringCan be a number of a customer’s membership card.
ProductGroup string Defined the product category.
Attachment string Random merchant’s data (some kind of serialized JSON for example)
Description string An optional description provided by partner. May be multi-line and may contain whatever the partner wants.
ReferenceName string Merchant custom value Reference name
PosId string Merchant custom PosId

Partner’s purchase identifiers

Name Data Type Description
DescriptionstringAn optional description provided by partner. May be multi-line and may contain whatever the partner want
OrderReferencestring Merchant custom ID reference
LoyaltyNumberstringCan be a number of a customer’s membership card.
ProductGroupstringJust a string that defines the product category. Allow anything for now. Will be defined later.
AttachmentstringRandom merchant’s data (some kind of serialized JSON for example)
ReferenceNamestringMerchant custom value Reference name

Checkout site information

Name Data Type Description
SiteCodestringCode of the site in which the purchase has been made.
CountryCodestringThe three-letters country code of the site.
CurrencyCodestringThe three-letter code of the currency in which the purchase has been made.

B2C State

Name Data Type Description
StepGetPaymentB2CFormStepDescription of current step in checkout flow
UserInputsGetPaymentB2CUserInputsInformation provided by customer in checkout form
InvoicingAddressAddressCustomerInvoicing address
DeliveryAddressDeliveryAddressDelivery address

B2C Step

Name Data Type Description
CustomerTokenstring Customer token
CurrentB2CStepTypeLatest purchase state type
RememberMeCheckBoxStateTypeCheckbox state of remember me
SmsNewsletterSubscriptionCheckBoxStateTypeCheckbox state of sms newsletter subscription
EmailNewsletterSubscriptionCheckBoxStateTypeCheckbox state of email newsletter subscription

Card State

Name Data Type Description
MaskedCardNumberstringIf card payment method was selected, Masked card number used card
CardBrand stringIf card payment method was selected, brand of used card
CardExpirationDate stringIf card payment method was selected, expiration date of used card

B2C User Inputs

Name Data Type Description
EmailstringCustomer’s e-mail address passed by a partner’s application.
ZipstringCustomer’s zip code passed by a partner’s application.
SsnstringCustomer’s social security number
PhonestringCustomer’s phone number passed by a partner’s application.

B2B State

Name Data Type Description
StepGetPaymentB2BFormStepDescription of current step in checkout flow
UserInputsGetPaymentB2BUserInputsInformation provided by customer in checkout form
CustomerInfoGetPaymentB2BCustomerInfoInformation about referer of B2B payment
InvoicingAddressAddressCompanyInvoicing address
DeliveryAddressDeliveryAddressDelivery address

B2B Step

Name Data Type Description
StepGetPaymentB2BFormStepDescription of current step in checkout flow
UserInputsGetPaymentB2BUserInputsInformation provided by customer in checkout form
CustomerInfoGetPaymentB2BCustomerInfoInformation about referer of B2B payment
InvoicingAddressAddressCompanyInvoicing address
DeliveryAddressDeliveryAddressDelivery address

B2B User inputs

Name Data Type Description
EmailstringCustomer’s e-mail address passed by a partner’s application.
ZipstringCustomer’s zip code passed by a partner’s application.
CompanySsnstringCompany social security number
CustomerSsn string Referrer’s social security number
PhonestringCustomer’s phone number passed by a partner’s application.

B2B Customer Info

Name Data Type Description
FirstNamestringReferrer’s First name.
LastNamestring Referrer’s Last name.

Authentication Type

Name Value Description
None“None”No third party verification
BankId“BankId”Verification pass via BankId
Tupas“Tupas”Verification pass via Tupas

Form Payments

Name Type Description
SelectedPaymentGetPaymentPaymentMethodInformation about selected Payment method

Payment Method

Name Type Description
TypePaymentMethodTypeType of Payment method
RecurringPaymentCheckBoxStateTypeState of recurring payment check-box
RecurringPaymentTokenstringGenerated recurring payment token