riverty logo

Docs

Path

POST /merchants

Request Parameters

Accept-version required
string
undefined

Request Body

application/json

legalName
required
string > 80 Characters
This is the registered legal name of the company.
courtRegistrationCity
string > 255 Characters
The registered court city of the company. This field is specificly for Germany. This field is required for DE to ensure unique identification.
companyRegistrationNumber
required
string > 30 Characters
The registration number of the company.
vatNumber
required
string > 20 Characters
The VAT number of the company. This field should not include spaces.
registeredAddress
required
object
primaryContact
required
object
invoiceContact
object
merchantPortalAdmin
object
shop
required
object

Responses

Successful Call

Response Example

    
        {
 "merchantId": "2023036387",
 "shopId": "RTY000002249"
}
    

Request Example

    
        {
 "legalName": "Example Merchant A",
 "companyRegistrationNumber": "HRA12345",
 "vatNumber": "DE123456789",
 "courtRegistrationCity": "Berlin",
 "registeredAddress": {
  "street": "Kurfürstendamm",
  "houseNumber": "1000",
  "houseNumberAddition": null,
  "postalCode": "10719",
  "city": "Berlin",
  "country": "DE"
 },
 "primaryContact": {
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "+4930936681944",
  "email": "john.doe@examplepartner.com"
 },
 "invoiceContact": {
  "firstName": "Jane",
  "lastName": "Doe",
  "phoneNumber": "+4930936681946",
  "email": "jane.doe@examplepartner.com"
 },
 "merchantPortalAdmin": {
  "firstName": "Jack",
  "lastName": "Doe",
  "phoneNumber": "+4930936681945",
  "email": "jack.doe@examplemerchant-a.de"
 },
 "shop": {
  "name": "Example Shop A",
  "url": "https://www.exampleshop-a.de",
  "marketCountry": "DE",
  "isMarketplace": false,
  "industryCode": "5691",
  "industryCodeStandard": "MCC",
  "numberOfAnnualTransactions": 100000,
  "averageOrderValue": 30,
  "operationalContact": {
   "firstName": "John",
   "lastName": "Doe",
   "phoneNumber": "+4930936681944",
   "email": "john.doe@examplepartner.com"
  },
  "technicalContact": {
   "firstName": "Janet",
   "lastName": "Doe",
   "phoneNumber": "+4930936681944",
   "email": "janet.doe@examplepartner.com"
  },
  "fraudContact": {
   "firstName": "Jeff",
   "lastName": "Doe",
   "phoneNumber": "+4930936681944",
   "email": "jeff.doe@examplemerchant-a.de"
  },
  "customerservicePhoneNumber": "+4930936681945",
  "customerserviceEmailAddress": "customer.service@examplemerchant-a.de",
  "contract": {
   "partnerReference": "C1774334145",
   "iban": null,
   "agreementId": 31
  }
 }
}