Authorize Payment

More information can be found in our Documentation.

Path

POST /api/v3/checkout/authorize

Request Body

application/json

merchantUrl

string

URL to redirect the customer to after the payment process

checkoutId

string

Unique identifier of checkout process in UUID format. Required only in the Two-Step Authorize use-case.

merchantId

string

Max length: 50

Merchant ID within the Riverty system, part of the credentials used for Riverty Netherlands and Belgium. If you were not provided these credentials by your Account Manager, leave empty.

required

object

Payment information

type

required

string

Enum:

Invoice

Installment

Account

Consolidatedinvoice

PayinX

Payment method type

object

Required for Fixed Installments payments in Germany, Austria and Switzerland

object

The information about recurring direct debit agreement

object

invoice

object

Consolidated invoice information

object

payinX

object

Input data for authorize request with PayInX payment type. Currently empty

object

The person initiating the checkout, typically the buyer who places the order. May also receive the order.

identificationNumber

required in

string

Max length: 20

National ID number (if the customer is a physical person). Registration number (if the customer is a company).

object

Customer address

legalForm

required in

string

Max length: 255

Type of business. This field is mandatory for processing B2B transactions in Austria, Germany and Switzerland.

object

existingCustomer

boolean

Is customer an existing customer for merchant

verifiedCustomerIdentification

boolean

This field signifies whether the customer's identification has been successfully verified.

marketingOptIn

boolean

Shows if merchant is allowed to send marketing information to customer

customerSince

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Since when customer has been merchant's client

customerClassification

string

Max length: 255

Customer reputation (e.g. VIP client)

acquisitionChannel

string

Enum:

NotSet

Advertisment

SocialNetwork

Direct

SearchEngine

Other

Customer acquisition channel

hasCustomerCard

boolean

Shows if customer has loyalty card

customerCardSince

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

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

Max length: 50

Unique value for identifying a profile tracking session

ipAddress

string

Max length: 39

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

Max length: 4096

UserAgent of this specific consumer

amountOfTransactions

number

Amount of paid orders last 12 months

otherPaymentMethods

boolean

Other payment method than MI in wallet

verifiedCustomerIdentificationType

string

Max length: 255

Specific method or category used to authenticate or verify a customer's identity

verifiedCustomerIdentificationDate

string

yyyy-MM-dd

Date on which a customer's identification details have been successfully confirmed or authenticated dateformat: yyyy-MM-dd

customerNumber

string

Max length: 100

Customer number has to be unique, if no customer number available please leave empty

salutation

string

Enum:

Mrs

Miss

Salutation

firstName

string

Max length: 50

First name. Everything over 50 characters will be truncated

lastName

string

Max length: 50

Last name. Everything over 50 characters will be truncated

companyName

string

Max length: 255

Purchasing company name. Everything over 255 characters will be truncated. This field is mandatory for processing B2B transactions in Austria, Belgium, Germany, the Netherlands and Switzerland.

required in

string

Max length: 255

phone

required in

string

Max length: 20

Phone

mobilePhone

required in

string

Max length: 20

Mobile phone

birthDate

required

string

yyyy-MM-dd

Date of birth. Not required if customerCategory is 'Company'.

customerCategory

required

string

Enum:

Company

Person

Customer category

conversationLanguage

string

Enum:

The language code used for client communication. If not provided, the system will default to the language configured for the client.

distributionType

string

Enum:

Paper

Sms

How information (invoices, notices, etc.) will be distributed to customer.

vatId

required in

string

Max length: 50

VAT registration number, the unique number that identifies a business. This field is mandatory for processing B2B transactions in Austria, Germany and Switzerland.

object

The recipient of the order, potentially different from the buyer. Specifies the delivery address and contact details.

object

Customer address

addressType

string

Enum:

Standard

ShipTo

PickUpPoint

InStore

Delivery Address Type

object

PickUp point information

careOf

string

Max length: 50

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

required in

string

Max length: 100

Name of street or packstation

streetNumber

required in

string

Max length: 10

Street or packstation number

streetNumberAdditional

required in

string

Max length: 10

Additional street number

postalCode

required in

string

Max length: 10

Postal code

postalPlace

required in

string

Max length: 100

Postal place

countryCode

string

Enum:

Country code

customerNumber

string

Max length: 100

Customer number has to be unique, if no customer number available please leave empty

salutation

string

Enum:

Mrs

Miss

Salutation

firstName

string

Max length: 50

First name. Everything over 50 characters will be truncated

lastName

string

Max length: 50

Last name. Everything over 50 characters will be truncated

companyName

string

Max length: 255

Purchasing company name. Everything over 255 characters will be truncated. This field is mandatory for processing B2B transactions in Austria, Belgium, Germany, the Netherlands and Switzerland.

required in

string

Max length: 255

phone

required in

string

Max length: 20

Phone

mobilePhone

required in

string

Max length: 20

Mobile phone

birthDate

required

string

yyyy-MM-dd

Date of birth. Not required if customerCategory is 'Company'.

customerCategory

required

string

Enum:

Company

Person

Customer category

conversationLanguage

string

Enum:

The language code used for client communication. If not provided, the system will default to the language configured for the client.

distributionType

string

Enum:

Paper

Sms

How information (invoices, notices, etc.) will be distributed to customer.

vatId

required in

string

Max length: 50

VAT registration number, the unique number that identifies a business. This field is mandatory for processing B2B transactions in Austria, Germany and Switzerland.

object

Order object

number

required

string

Max length: 50

Order number. Unique order number provided by the merchant. A valid order number can include alphanumeric characters, dashes and underscores.

totalNetAmount

required

number

Total net amount of order.

totalGrossAmount

required

number

Total gross amount of order. Must match the grossUnitPrice * quantity of order items

currency

string

Enum:

EUR

NOK

SEK

DKK

CHF

Currency

object

channelType

string

Enum:

Internet

Catalog

CallCenter

Stationary

Other

Order channel type

deliveryType

string

Enum:

Normal

Express

Order delivery type

ticketDeliveryMethod

string

Enum:

NotSet

PickUp

Post

Phone

object

array

Passengers

array

Itineraries

object

bookingReference

string

Max length: 4096

Booking reference

object

array

Passengers

array

Itineraries

object

bookingReference

string

Max length: 4096

Booking reference

object

array

Passengers

array

Itineraries

object

bookingReference

string

Max length: 4096

Booking reference

object

array

Passengers

array

Itineraries

object

bookingReference

string

Max length: 4096

Booking reference

object

company

string

Max length: 4096

Name of rental company

object

Base class of Address fields

object

Base class of Address fields

startDate

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Pick up date and time

endDate

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

End date and time

array

Information about drivers who have rented a car

identificationNumber

required in

string

Max length: 20

National ID number (if the customer is a physical person). Registration number (if the customer is a company).

object

Customer address

legalForm

required in

string

Max length: 255

Type of business. This field is mandatory for processing B2B transactions in Austria, Germany and Switzerland.

object

existingCustomer

boolean

Is customer an existing customer for merchant

verifiedCustomerIdentification

boolean

This field signifies whether the customer's identification has been successfully verified.

marketingOptIn

boolean

Shows if merchant is allowed to send marketing information to customer

customerSince

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Since when customer has been merchant's client

customerClassification

string

Max length: 255

Customer reputation (e.g. VIP client)

acquisitionChannel

string

Enum:

NotSet

Advertisment

SocialNetwork

Direct

SearchEngine

Other

Customer acquisition channel

hasCustomerCard

boolean

Shows if customer has loyalty card

customerCardSince

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

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

Max length: 50

Unique value for identifying a profile tracking session

ipAddress

string

Max length: 39

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

Max length: 4096

UserAgent of this specific consumer

amountOfTransactions

number

Amount of paid orders last 12 months

otherPaymentMethods

boolean

Other payment method than MI in wallet

verifiedCustomerIdentificationType

string

Max length: 255

Specific method or category used to authenticate or verify a customer's identity

verifiedCustomerIdentificationDate

string

yyyy-MM-dd

Date on which a customer's identification details have been successfully confirmed or authenticated dateformat: yyyy-MM-dd

customerNumber

string

Max length: 100

Customer number has to be unique, if no customer number available please leave empty

salutation

string

Enum:

Mrs

Miss

Salutation

firstName

string

Max length: 50

First name. Everything over 50 characters will be truncated

lastName

string

Max length: 50

Last name. Everything over 50 characters will be truncated

companyName

string

Max length: 255

Purchasing company name. Everything over 255 characters will be truncated. This field is mandatory for processing B2B transactions in Austria, Belgium, Germany, the Netherlands and Switzerland.

required in

string

Max length: 255

phone

required in

string

Max length: 20

Phone

mobilePhone

required in

string

Max length: 20

Mobile phone

birthDate

required

string

yyyy-MM-dd

Date of birth. Not required if customerCategory is 'Company'.

customerCategory

required

string

Enum:

Company

Person

Customer category

conversationLanguage

string

Enum:

The language code used for client communication. If not provided, the system will default to the language configured for the client.

distributionType

string

Enum:

Paper

Sms

How information (invoices, notices, etc.) will be distributed to customer.

vatId

required in

string

Max length: 50

VAT registration number, the unique number that identifies a business. This field is mandatory for processing B2B transactions in Austria, Germany and Switzerland.

price

number

Price of a rental car

currency

string

Enum:

EUR

NOK

SEK

DKK

CHF

Currency

bookingReference

string

Max length: 4096

Booking reference

object

company

string

Max length: 4096

object

Base class of Address fields

checkin

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Check-in date and time

checkout

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Check-out date and time

array

Guests information

identificationNumber

required in

string

Max length: 20

National ID number (if the customer is a physical person). Registration number (if the customer is a company).

object

Customer address

legalForm

required in

string

Max length: 255

Type of business. This field is mandatory for processing B2B transactions in Austria, Germany and Switzerland.

object

existingCustomer

boolean

Is customer an existing customer for merchant

verifiedCustomerIdentification

boolean

This field signifies whether the customer's identification has been successfully verified.

marketingOptIn

boolean

Shows if merchant is allowed to send marketing information to customer

customerSince

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Since when customer has been merchant's client

customerClassification

string

Max length: 255

Customer reputation (e.g. VIP client)

acquisitionChannel

string

Enum:

NotSet

Advertisment

SocialNetwork

Direct

SearchEngine

Other

Customer acquisition channel

hasCustomerCard

boolean

Shows if customer has loyalty card

customerCardSince

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

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

Max length: 50

Unique value for identifying a profile tracking session

ipAddress

string

Max length: 39

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

Max length: 4096

UserAgent of this specific consumer

amountOfTransactions

number

Amount of paid orders last 12 months

otherPaymentMethods

boolean

Other payment method than MI in wallet

verifiedCustomerIdentificationType

string

Max length: 255

Specific method or category used to authenticate or verify a customer's identity

verifiedCustomerIdentificationDate

string

yyyy-MM-dd

Date on which a customer's identification details have been successfully confirmed or authenticated dateformat: yyyy-MM-dd

customerNumber

string

Max length: 100

Customer number has to be unique, if no customer number available please leave empty

salutation

string

Enum:

Mrs

Miss

Salutation

firstName

string

Max length: 50

First name. Everything over 50 characters will be truncated

lastName

string

Max length: 50

Last name. Everything over 50 characters will be truncated

companyName

string

Max length: 255

Purchasing company name. Everything over 255 characters will be truncated. This field is mandatory for processing B2B transactions in Austria, Belgium, Germany, the Netherlands and Switzerland.

required in

string

Max length: 255

phone

required in

string

Max length: 20

Phone

mobilePhone

required in

string

Max length: 20

Mobile phone

birthDate

required

string

yyyy-MM-dd

Date of birth. Not required if customerCategory is 'Company'.

customerCategory

required

string

Enum:

Company

Person

Customer category

conversationLanguage

string

Enum:

The language code used for client communication. If not provided, the system will default to the language configured for the client.

distributionType

string

Enum:

Paper

Sms

How information (invoices, notices, etc.) will be distributed to customer.

vatId

required in

string

Max length: 50

VAT registration number, the unique number that identifies a business. This field is mandatory for processing B2B transactions in Austria, Germany and Switzerland.

numberOfRooms

integer

Number of rooms

price

number

Price of the hotel accommodation

currency

string

Enum:

EUR

NOK

SEK

DKK

CHF

Currency

bookingReference

string

Max length: 4096

Booking reference

merchantImageUrl

string

Max length: 2048

Image URL for the merchants brand. This image is shown at the top of the order page in Riverty. Supported image formats are: gif, jpeg (jpg), png, webp.

array

Array of order items. Maximum allowed 200 items.

productId

required

string

Max length: 100

Merchant Product identification number.

groupId

string

Max length: 255

Item group ID. The group this item belongs to. Provided by the merchant. Everything over 255 characters will be truncated.

description

required

string

Product name. For example "Black music player 64GB". Everything over 255 characters will be truncated.

type

string

Enum:

PhysicalArticle

DigitalArticle

GiftCard

Discount

ShippingFee

Surcharge

Info

Subscription

netUnitPrice

required

number

Net unit price.

grossUnitPrice

required

number

Gross price per item.

quantity

required

number

Quantity. Use of integer is strongly proposed. If you want to use decimal, please contact your integration manager.

unitCode

string

Max length: 50

Unit code (for example pieces, liters, kilograms, etc.).

vatCategory

string

Enum:

HighCategory

LowCategory

NullCategory

NoCategory

MiddleCategory

OtherCategory

Vat category

vatPercent

required

number

Tax percent.

vatAmount

required

number

Tax amount per item.

imageUrl

string

Max length: 2048

URL for the image of this product. It will be turned into a thumbnail and displayed in Riverty, on the invoice line next to the order item. The linked image must be a rectangle or square, width between 100 pixels and 1280 pixels. Supported image formats are: gif, jpeg (jpg), png, webp.

googleProductCategoryId

integer

Google product category ID.

googleProductCategory

string

Max length: 255

Indicates the category of the item based on the Google product taxonomy. Categorizing the product helps ensure that the ad is shown with the right search results.

merchantProductType

string

Max length: 255

Categorization used by Merchant as a complement to Google Taxonomy.

lineNumber

integer

Line number. The merchant may add a line number to each order item, to sort them in a particular order.

productUrl

string

Max length: 2048

URL to the product.

marketPlaceSellerId

string

Max length: 32

ID of an individual seller on a marketplace. If this field is used, an entry in the element additionalData -> marketplace must also be provided.

parentTransactionReference

string

Max length: 128

A unique reference provided to Riverty by a third party (merchant or Payment Service Provider). Identifies an entire order.

additionalInformation

string

Max length: 4096

Extended description of the order item.

specification

N/A

Specification.

serviceStart

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Capture start time.

serviceEnd

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Capture end time.

productUser

string

Max length: 50

Product User

costCenter

string

Max length: 50

Used for B2B to specify the costCenter e.g. Marketing or Sales Department - Displayed on the invoice.

parentTransactionReference

string

Max length: 128

A unique reference provided to Riverty by a third party (merchant or Payment Service Provider). Identifies an entire order.

object

Additional data

pluginProvider

string

Max length: 50

Plugin Provider Name

pluginVersion

string

Max length: 50

Plugin Version

shopUrl

string

Max length: 2048

URL of the Webshop

shopPlatform

string

Max length: 50

Name of the platform used for the Webshop

shopPlatformVersion

string

Max length: 50

Version of the webshop platform

array

Additional information for marketplace set-ups. If the marketPlaceSellerId field is used in the order items, then this element must include the corresponding marketplace data.

object

Subscription information

object

additionalPaymentInfo

string

Max length: 250

Additional technical payment information, not used for customer communication

object

inStore object

additionalMerchantData

string

Max length: 4096

Additional information about the merchant Format: Base64 encoded JSON

yourReference

string

Max length: 20

Can be used by purchasing company if they would like to provide internal reference

ourReference

string

Max length: 128

Can be used by selling company if they would like to provide specific reference for purchasing company. This field is limited to 128 characters, longer values will be truncated to fit within the specified limit.

object

e-invoice references information

nonce

string

Unique string provided by Riverty if the merchant is using Hosted Fields. Contact your Key Account Manager for more details.

object

Responses

outcome

string

Enum:

Accepted

Pending

Rejected

Check risk outcome

customerNumber

string

Max length: 100

Customer number

object

Customer response

customerNumber

string

Max length: 100

Customer number

customerAccountId

string

Max length: 50

Customer account id

firstName

string

Max length: 50

First name

lastName

string

Max length: 50

Last name

array

Address list

object

Customer response

customerNumber

string

Max length: 100

Customer number

customerAccountId

string

Max length: 50

Customer account id

firstName

string

Max length: 50

First name

lastName

string

Max length: 50

Last name

array

Address list

reservationId

string

checkoutId

string

secureLoginUrl

string

Url where consumer can be redirected to perform strong authentication. Filled only in case the risk check decides that purchase is not allowed without strong authentication. Contact your Account Manager to enable the feature.

scaSessionId

string

Sca Session Id

expirationDate

string

yyyy-MM-dd

The date and time when this authorization will expire if you did not make a Capture call. If the deadline has passed, you must make a new Authorize call before Capturing this order.

Successful Request

Successful Request, SCA

Unsuccessful Request, Failed Risk Check

Successful Request, Direct Debit

Request Example

    
        {
 "merchantUrl": "https://www.example.com",
 "payment": {
  "type": "Invoice"
 },
 "customer": {
  "identificationNumber": "800119-3989",
  "address": {
   "street": "Gütersloher Straße",
   "streetNumber": "123",
   "postalCode": "33415",
   "postalPlace": "Berlin",
   "countryCode": "DE"
  },
  "salutation": "Mrs",
  "firstName": "Astrid",
  "lastName": "Svensson",
  "email": "astrid.svensson@example.com",
  "mobilePhone": "12345678900",
  "birthDate": "1999-01-02",
  "customerCategory": "Person",
  "conversationLanguage": "EN"
 },
 "order": {
  "number": "riverty1",
  "totalGrossAmount": 185,
  "totalNetAmount": 155.41,
  "currency": "EUR",
  "items": [
   {
    "productId": "4534-BLK-M",
    "description": "Leather jacket, Black, size M",
    "grossUnitPrice": 100,
    "netUnitPrice": 84,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 16,
    "imageUrl": "https://developer-sandbox.riverty.com/images/black_leather_jacket.jpg"
   },
   {
    "productId": "5745-GRY-M",
    "description": "Socks, Grey, Size M",
    "grossUnitPrice": 10,
    "netUnitPrice": 8.4,
    "quantity": 5,
    "vatPercent": 19,
    "vatAmount": 1.6,
    "imageUrl": "https://developer-sandbox.riverty.com/images/grey_socks.jpg"
   },
   {
    "productId": "3323-BRN-M",
    "description": "Woolen hat, brown, Size M",
    "grossUnitPrice": 30,
    "netUnitPrice": 25.21,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 4.79,
    "imageUrl": "https://developer-sandbox.riverty.com/images/brown_wool_hat.jpg"
   },
   {
    "productId": "SHIP",
    "description": "Shipping",
    "type": "ShippingFee",
    "grossUnitPrice": 5,
    "netUnitPrice": 4.2,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 0.8
   }
  ]
 }
}

Response Example

    
        {
 "outcome": "Accepted",
 "customerNumber": "AP000100888",
 "reservationId": "f0d7e939-6e43-4fe6-93e5-79b6aba984cf",
 "checkoutId": "e907c794-de5a-436e-9676-904ee0c55360",
 "expirationDate": "2023-10-22"
}

Request Example

    
        {
 "merchantUrl": "https://www.example.com",
 "payment": {
  "type": "Invoice"
 },
 "customer": {
  "identificationNumber": "800119-3989",
  "firstName": "Astrid",
  "lastName": "Svensson",
  "salutation": "Mrs",
  "email": "astrid.svensson@example.com",
  "birthDate": "1999-01-02",
  "mobilePhone": "12345678900",
  "customerCategory": "Person",
  "address": {
   "street": "Gütersloher Straße",
   "streetNumber": "123",
   "postalCode": "33415",
   "postalPlace": "Berlin",
   "countryCode": "DE"
  },
  "conversationLanguage": "EN"
 },
 "order": {
  "number": "riverty1",
  "totalGrossAmount": 185,
  "totalNetAmount": 155.41,
  "currency": "EUR",
  "items": [
   {
    "productId": "4534-BLK-M",
    "description": "Leather jacket, Black, size M",
    "grossUnitPrice": 100,
    "netUnitPrice": 84,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 16,
    "imageUrl": "https://developer-sandbox.riverty.com/images/black_leather_jacket.jpg"
   },
   {
    "productId": "5745-GRY-M",
    "description": "Socks, Grey, Size M",
    "grossUnitPrice": 10,
    "netUnitPrice": 8.4,
    "quantity": 5,
    "vatPercent": 19,
    "vatAmount": 1.6,
    "imageUrl": "https://developer-sandbox.riverty.com/images/grey_socks.jpg"
   },
   {
    "productId": "3323-BRN-M",
    "description": "Woolen hat, brown, Size M",
    "grossUnitPrice": 30,
    "netUnitPrice": 25.21,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 4.79,
    "imageUrl": "https://developer-sandbox.riverty.com/images/brown_wool_hat.jpg"
   },
   {
    "productId": "SHIP",
    "description": "Shipping",
    "type": "ShippingFee",
    "grossUnitPrice": 5,
    "netUnitPrice": 4.2,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 0.8
   }
  ]
 }
}

Response Example

    
        {
 "outcome": "Pending",
 "secureLoginUrl": "https://secure-dev.riverty.dev/ssnauthentication/login/b959ee3c27bd4432b326837dcf3b04a0",
 "scaSessionId": "b959ee3c27bd4432b326837dcf3b04a0",
 "riskCheckMessages": [
  {
   "type": "BusinessError",
   "code": "200.910",
   "message": "Strong identification needed",
   "actionCode": "AskConsumerToIdentify",
   "fieldReference": "customer.identificationNumber"
  }
 ]
}

Request Example

    
        {
 "merchantUrl": "https://www.example.com",
 "payment": {
  "type": "Invoice"
 },
 "customer": {
  "identificationNumber": "800119-3989",
  "firstName": "Astrid",
  "lastName": "Svensson",
  "salutation": "Mrs",
  "email": "astrid.svensson@example.com",
  "birthDate": "1999-01-02",
  "mobilePhone": "12345678900",
  "customerCategory": "Person",
  "address": {
   "street": "Gütersloher Straße",
   "streetNumber": "123",
   "postalCode": "33415",
   "postalPlace": "Berlin",
   "countryCode": "DE"
  },
  "conversationLanguage": "EN"
 },
 "order": {
  "number": "riverty1",
  "totalGrossAmount": 185,
  "totalNetAmount": 155.41,
  "currency": "EUR",
  "items": [
   {
    "productId": "4534-BLK-M",
    "description": "Leather jacket, Black, size M",
    "grossUnitPrice": 100,
    "netUnitPrice": 84,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 16,
    "imageUrl": "https://developer-sandbox.riverty.com/images/black_leather_jacket.jpg"
   },
   {
    "productId": "5745-GRY-M",
    "description": "Socks, Grey, Size M",
    "grossUnitPrice": 10,
    "netUnitPrice": 8.4,
    "quantity": 5,
    "vatPercent": 19,
    "vatAmount": 1.6,
    "imageUrl": "https://developer-sandbox.riverty.com/images/grey_socks.jpg"
   },
   {
    "productId": "3323-BRN-M",
    "description": "Woolen hat, brown, Size M",
    "grossUnitPrice": 30,
    "netUnitPrice": 25.21,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 4.79,
    "imageUrl": "https://developer-sandbox.riverty.com/images/brown_wool_hat.jpg"
   },
   {
    "productId": "SHIP",
    "description": "Shipping",
    "type": "ShippingFee",
    "grossUnitPrice": 5,
    "netUnitPrice": 4.2,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 0.8
   }
  ]
 }
}

Response Example

    
        {
 "outcome": "Rejected",
 "customer": {
  "firstName": "Reject",
  "lastName": "LASTNAME",
  "addressList": [
   {
    "street": "Street",
    "streetNumber": "1",
    "postalCode": "12345",
    "postalPlace": "FARSTA",
    "countryCode": "DE"
   }
  ]
 },
 "reservationId": "00000000-0000-0000-0000-000000000000",
 "checkoutId": "00000000-0000-0000-0000-000000000000",
 "riskCheckMessages": [
  {
   "type": "BusinessError",
   "code": "200.901",
   "message": "Negative Customer Score",
   "customerFacingMessage": "Leider ist die Zahlungsmethode derzeit nicht verfügbar. Bitte eine andere Zahlungsmethode auswählen.",
   "actionCode": "OfferSecurePaymentMethods"
  }
 ]
}

Request Example

    
        {
 "merchantUrl": "https://www.example.com",
 "payment": {
  "type": "Invoice",
  "directDebit": {
   "bankAccount": "DE02120300000000202051"
  }
 },
 "customer": {
  "identificationNumber": "800119-3989",
  "address": {
   "street": "Gütersloher Straße",
   "streetNumber": "123",
   "postalCode": "33415",
   "postalPlace": "Berlin",
   "countryCode": "DE"
  },
  "salutation": "Mrs",
  "firstName": "Astrid",
  "lastName": "Svensson",
  "email": "astrid.svensson@example.com",
  "mobilePhone": "12345678900",
  "birthDate": "1999-01-02",
  "customerCategory": "Person",
  "conversationLanguage": "EN"
 },
 "order": {
  "number": "riverty1",
  "totalGrossAmount": 185,
  "totalNetAmount": 155.41,
  "currency": "EUR",
  "items": [
   {
    "productId": "4534-BLK-M",
    "description": "Leather jacket, Black, size M",
    "grossUnitPrice": 100,
    "netUnitPrice": 84,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 16,
    "imageUrl": "https://developer-sandbox.riverty.com/images/black_leather_jacket.jpg"
   },
   {
    "productId": "5745-GRY-M",
    "description": "Socks, Grey, Size M",
    "grossUnitPrice": 10,
    "netUnitPrice": 8.4,
    "quantity": 5,
    "vatPercent": 19,
    "vatAmount": 1.6,
    "imageUrl": "https://developer-sandbox.riverty.com/images/grey_socks.jpg"
   },
   {
    "productId": "3323-BRN-M",
    "description": "Woolen hat, brown, Size M",
    "grossUnitPrice": 30,
    "netUnitPrice": 25.21,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 4.79,
    "imageUrl": "https://developer-sandbox.riverty.com/images/brown_wool_hat.jpg"
   },
   {
    "productId": "SHIP",
    "description": "Shipping",
    "type": "ShippingFee",
    "grossUnitPrice": 5,
    "netUnitPrice": 4.2,
    "quantity": 1,
    "vatPercent": 19,
    "vatAmount": 0.8
   }
  ]
 }
}

Response Example

    
        null