riverty logo

Docs

Get Started Login

Create Merchant

Creates a merchant with its shop and contract

Path

POST /merchants

Request Parameters

Accept-version
required
string
undefined

Request Body

application/json

legalName
required
string
Max length: 80
This is the registered legal name of the company.
courtRegistrationCity
string
Max length: 255
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
Max length: 30
The registration number of the company.
vatNumber
string
Max length: 20
The VAT number of the company. This field should not include spaces.
required
object
required
object
object
object
required
object

Responses

Successful Call

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
  }
 }
}
    

Response Example

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