Data and Integration Overview
The Merchant Onboarding API enables our partners to make Riverty payment methods available in their merchant’s checkout within minutes. Simply send Riverty the merchant’s master data via the Merchant Onboarding API and receive test and live API keys in response. By sending our API keys to the our partners, instead of directly to merchants, we allow our partners to retain client contact.
Riverty uses the below ID system to organize partners, agreements, merchants and shops into a parent-child data structure.
More detailed Information about IDs and Contract can be found on our Onboarding IDs and Contacts Page.
- A Partner can have multiple agreements (e.g. per country)
- Merchants can have several webshops
- Every webshop must have at least 1 active agreement
The webshop object requires a unique partner reference (255 string length including letters, numbers, hyphens and underscores, but not other special characters). This reference must be created and provided by the partner. This partner reference is then used as the Idempotancy Key by Riverty’s system to stop duplicate processing of the same merchant. Duplicate merchant entries in Riverty’s system could cause improper processing of consumer transactions and merchant settlement.
Merchant Onboarding is completed through the partner via the Merchant Onboarding API following the below three phases:
- Administration (Create Merchant / Add Shop)
- Implementation (Get Credentials)
- Go-live (First Transaction)
|Partner sends Merchant master data
|The onboarding API will validate the request and start the onboarding process. If the validation fails, feedback will be given otherwise the process continues with step 3.
|Riverty creates the Merchant in the LIVE and TEST environments.
|The partner sends Get Credentials for fetching the API keys for LIVE and TEST environments (or will wait for Credentials Available before sending Get Credentials – see In Development section below)
|In case the Merchant has several webshops and/or is active in multiple countries, the partner will first do the “new merchant & webshop” call and will afterwards do as many “add additional webshop” calls as needed, to receive TEST & LIVE API keys for each country/webshop combination
|Riverty returns the API keys to the Partner.
|First Merchant transaction is placed.