➡ Request Parameter
Product name
| Type | Condition | Restriction |
|---|---|---|
| xs:string | Mandatory | Length <=255 |
Merchant's product number or other identifier like SKU, EAN, GTIN, ISBN etc.
| Type | Condition | Restriction |
|---|---|---|
| xs:string | Mandatory | Length <=255 |
| Type | Condition | Restriction |
|---|---|---|
| xs:string | Optional, if <item@article-number> is unique | Length <=255 |
Each item within a shopping basket must be uniquely identifiable, either by the <item@article-number> or in combination with the <item@unique-article-number>, or both.
Example
Imagine, all shirts within the shopping-basket have the same article-number. To make them unique, additionally submit size, color, printing, etc. by using the <item@unique-article-number>.
Quantity
| Type | Condition |
|---|---|
| xs:int | Mandatory |
The details of the purchased goods are defined by the shopping basket items. One <item>-element defines the purchased good/service. If several items of the exact same kind have been purchased, use <item@quantity>.
Gross price of one unit (including tax)
| Type | Condition |
|---|---|
| xs:decimal | Mandatory |
If an amount with more than 4 decimals is provided, it will be rounded to 4 decimals internally.
Tax rate that applies to the item, e.g. 19% send like 19
| Type | Condition |
|---|---|
| xs:decimal | Mandatory |
Optional article category. The interpretation of this value is defined by Ratepay's risk management process.
| Type | Condition | Restriction |
|---|---|---|
| xs:string | Optional | Length <=511 |
According to ISO 18245.
Item-specific discount
| Type | Condition | Restriction |
|---|---|---|
| xs:decimal | Optional | Negative value |
If an amount with more than 4 decimals is provided, it will be rounded to 4 decimals internally.
With this attribute an additional text can be submitted to be used as additional description for correspondence sent by Ratepay to the customer, e.g. download codes, descriptions of patterns, services details etc.
| Type | Condition | Restriction |
|---|---|---|
| xs:string | Optional | Length <=511 |
Only for marketplace transactions!
The shop_id needs to be unique under the respective partner profile.
This attribute is mandatory in order to process mixed baskets in marketplace scenarios.
| Type | Condition | Restriction |
|---|---|---|
| xs:string | Mandatory | Length <=255 |