Merchant Creation & Associations

Merchant Creation and Association API Request

The Merchant Creation and Association API is used to register a new merchant on the platform and link (associate) the merchant with the appropriate configuration, such as a payment provider, business group, or partner entity.

Things to note

Store ID can be any numeric value upto 10 digits

Email - merchant email should be in valid format and unique one for creation of merchants. If it's duplicate mail id then it gets associated with same store ID but with new merchant id

Phone number - valid merchant phone number which should include country code

Country - it accepts only United Kingdom, Ireland, Australia, New Zealand, Canada, United States, Mexico

First name, last name and business name data will be filled based on what merchant has provided to FH team

Change of ownership accepts only Boolean value if true - the given mail ID merchant will be having ownership, when its false and try to associate same mail ID merchant it throws an error

isReseller value accept Boolean this is used to denote this reseller account.

isPartner value accepts true/false, When we are sending True for isPartner, storeId should not be passed.

ResellerId. It is an optional field can be used to create resellers merchants. When blank it is for normal merchants.

10.

Action - create only is accepted and creation of merchants can be performed

curl --location --request POST 'https://ws2-portal-api.datmancrm.com/merchants/ws2/api/v1/merchants/merchant-association' \ --header 'api_key: API_KEY' \ --header 'Content-Type: application/json' \ --data-raw '{ "action": "create", "isPartner": false, "storeId": "123223", "email": "test@datman.je", "phoneNumber": "+11234567890", "country": "United States", "firstName": "John", "lastName": "Snow", "businessName": "Kebab House", "changeOfownership": true, "isReseller": false }'

{ "message": "New merchant account has been created and has been added to the {{email}}", "merchantId": "{{merchant_id}}", "account_verification_status": false, "bank_verification_status": false, "email": "{{email}}", "signup_link": "{{signup_link}}" }

Merchant Creation & Associations

Request

Responses