Testing Onboarding API

Tailormade Postman Collection

Riverty can provide a dedicated "Postman Collection" upon request to make it easier for partners to test our APIs. This collection contains all relevant API calls for Payment and Merchant Onboarding, as well as highlighted fields and field-specific information.

Before Testing

1. Ensure that the test credentials are already in place in the shared 'Partner Postman Collection' for Merchant Onboarding
2. Confirm to have received the tailor-made ‘Test-Suite’-document, 'Partner Postman Collection' for Merchant Onboarding
3. Utilize the Riverty Merchant Onboarding Partner Test-endpoint link: https://onboarding-api.riverty.io
4. Take advantage of the ‘Riverty Test Cases’ to simulate all relevant scenarios in a structured manner. The overview is available in the table below.

Riverty Test Cases

#	Cases	Results	Details
1	Retrieve bearer token	Access token, expires in, token type	The access token is required in the authorization header in the underlying requests, next to the Accept-version which is 1.0
2	Create a merchant and a shop	Merchant ID, shop ID
3	Retrieve first shop credentials	Test API key	Might need to wait for 2 minutes or try multiple times to get credentials back.
4	Add a second shop to the existing merchant	Shop ID
5	Retrieve second shop credentials	Test API key	Might need to wait for 2 minutes or try multiple times to get credentials back.
6	Try onboarding of the same merchant with the same partner reference (Idempotency)	First call: merchant ID & shop ID, Second call: The same merchant ID & shop ID as the first call.
7	Onboard a merchant where the companyRegistrationNumber (COC/KvK) already exists under the same partner	400 Bad Request with: Merchant with companyRegistrationNumber {number} already onboarded, merchantId = {id}, Please use the addshop endpoint.	The API rejects duplicate merchant onboarding for the same partner. Use Add Shop on the existing merchant instead. If the same COC exists under another partner, onboarding will succeed per current behavior; the duplicate constraint is scoped to the partner.
8	Add a shop to a merchant where the URL + market country combination already exists for that merchant	400 Bad Request with: There is already a shop under this merchant with the same URL operating in the same market country.	The API enforces uniqueness of (shop URL, marketCountry) per merchant. Create the shop with a different URL or market, or update the existing shop instead.