National ID number (if the customer is a physical person). Registration number (if the customer is a company).
address
required
address object
Address
careOf
string <= 50 characters
Care of. Intermediary who is responsible for transferring a piece of mail between the postal system and the final addressee. For example Jane c/o John (“Jane at John's address”).
This field has to be used for company, authority and organization names as well - e. g. "Sportverein Blau-Weiß e.V.
street
string <= 100 characters
Name of street or packstation
streetNumber
string <= 10 characters
Street or packstation number
streetNumberAdditional
string <= 10 characters
Additional street number
postalCode
string <= 10 characters
Postal code
postalPlace
string <= 100 characters
Postal place
countryCode
string
Enum:NOSEFIDKDEATCHNLBE
Country code
legalForm
string <= 255 characters
Type of business. Required for Austria, Germany and Switzerland.
riskData
required
riskData object
Risk related data. Merchants can do external risk checks and provide that information to Riverty.
existingCustomer
boolean
Is customer an existing customer for merchant
verifiedCustomerIdentification
boolean
Is identification verified
marketingOptIn
boolean
Shows if merchant is allowed to send marketing information to customer
Specify the channel which consumer has used for accessing merchant page
hasCustomerCard
boolean
Shows if customer has loyalty card
customerCardSince
string Format: date-time
The date when the loyalty card was issued to the customer
customerCardClassification
string
Specifies the level of the loyalty card (e.g Gold member).
For DE, AT, CH, this must be an integer from 1 to 5, where 5 is the highest VIP level.
profileTrackingId
string <= 50 characters
Unique Id of the device for profile tracking
ipAddress
required
string <= 39 characters
Customer’s IP address
numberOfTransactions
integer
Total number of successful purchases that have been made by the specific consumer
customerIndividualScore
string
The customer's individual risk score provided by the merchant.
Accepts a number from -10000 to 10000 (can be encased in quotation marks or not), or a single case-insensitive letter from 'a' to 'z'.
userAgent
string <= 4096 characters
UserAgent of this specific consumer
amountOfTransactions
number
Amount of paid orders last 12 months
otherPaymentMethods
boolean
Other payment method than MI in wallet
customerNumber
string <= 100 characters
Customer number has to be unique, if no customer number available please leave empty
salutation
string
Enum:MrMrsMissDiverse
Salutation.
firstName
required
string <= 50 characters
First name. Everything over 50 characters will be truncated
lastName
required
string <= 50 characters
Last name. Everything over 255 characters will be truncated
companyName
string <= 255 characters
Purchasing company name. Required if customerCategory is 'Company'. Everything over 50 characters will be truncated.
email
required
string <= 255 characters
Email
phone
string <= 20 characters
Phone
mobilePhone
string <= 20 characters
Mobile phone
birthDate
required
string Format: date
Date of birth. Not required if customerCategory is 'Company'.
customerCategory
required
string
Enum:CompanyPerson
Customer category.
conversationLanguage
string
Enum:NOSVSEFIDADKENDENLFR
Conversation language. 'SE' and 'DK' are obsolete values, and will be removed in the future. Use 'SV' instead of 'SE', and 'DA' instead of 'DK'.
distributionType
string
Enum:PaperEmailSms
Specifies how information (invoices, notices, etc.) will be distributed to customer.
vatId
string <= 50 characters
VAT registration number, the unique number that identifies a business. This field is mandatory for processing B2B transactions in Austria, Germany and Switzerland.
RESPONSES:
200 OK
RESPONSE SCHEMA:
isValid
boolean
Is response valid
correctedAddress
correctedAddress object
Corrected address
careOf
string <= 50 characters
Care of. Intermediary who is responsible for transferring a piece of mail between the postal system and the final addressee. For example Jane c/o John (“Jane at John's address”).
This field has to be used for company, authority and organization names as well - e. g. "Sportverein Blau-Weiß e.V.
