Hosted Onboarding

This guide will help you integrate Datman’s Onboarding URL generation smoothly and securely. Please read carefully; keys and values are case-sensitive, and small errors can cause failures.

Prerequisites

Ensure you have the SECRET_KEY, PUBLIC_KEY, WEBHOOK_SECRET_KEY provided by Datman.

This key is required for secure communication and authentication.

Environments

Environment	Base URL
Sandbox	`https://ws1-portal.datmancrm.com`
Production	`https://portal.datmancrm.com`

Process Flow Diagram

Step-by-Step Integration Guide

1. Prepare Your Payload

Prepare a JSON payload with the required keys. All keys are case-sensitive.

Key	Description	Required / Optional	Example
i	Store ID	Required	8052345
f	Your website or referring domain	Required	www.datman.com
TradingName	Trading name of the business	Required	Prashanth Aus Test
BusinessPhoneNumber	Business phone number	Optional	871234567
MerchantURL	Merchant website URL	Optional	https://www.google.com
MerchantEmail	Merchant email	Required	prashanth@datman.je
BusinessAddress1	Address line 1	Optional	56th Street
BusinessAddress2	Address line 2	Optional	Stoke-On-Trent
BusinessAddressCity	Business city	Optional	Stoke on City
BusinessAddressPostcode	Postal code	Optional	A65 F4E2
BusinessAddressCountry	Country	Required	Australia
OwnerTitle	Title (Mr/Ms/Mrs)	Required	Mrs
OwnerFirstName	Owner’s first name	Required	Prashanth
OwnerLastName	Owner’s last name	Required	Test
OwnerEmail	Owner's email	Required	prashanth@datman.je
OwnerBirthDate	Owner's birthdate (YYYY-MM-DD)	Optional	1999-10-01
OwnerPhoneNumber	Owner’s phone number	Required	871234567
OwnerAddress1	Owner’s address line 1	Optional	20 Willotts Hill Road
OwnerAddress2	Owner’s address line 2	Optional	Newcastle under Lyme
OwnerAddressCity	Owner’s city	Optional	Newcastle
OwnerAddressPostcode	Owner’s postal code	Optional	A65 F4E2
OwnerAddressCountry	Owner’s country	Required	Australia

Example Payload

{
    "i": "8052345",
    "f": "www.datman.com",
    "TradingName": "Prashanth Aus Test ",
    "BusinessPhoneNumber": "871234567",
    "MerchantURL": "https://www.google.com",
    "MerchantEmail": "prashanth@datman.je",
    "BusinessAddress1": "56th Street",
    "BusinessAddress2": "Stoke-On-Trent",
    "BusinessAddressCity": "Stoke on City",
    "BusinessAddressPostcode": "A65 F4E2",
    "BusinessAddressCountry": "United Kingdom",
    "OwnerTitle": "Mrs",
    "OwnerFirstName": "Prashanth",
    "OwnerLastName": "Test ",
    "OwnerEmail": "prashanth@datman.je",
    "OwnerBirthDate": "1999-10-01",
    "OwnerPhoneNumber": "871234567",
    "OwnerAddress1": "20 Willotts Hill Road",
    "OwnerAddress2": "Newcastle under Lyme",
    "OwnerAddressCity": "Newcastle",
    "OwnerAddressPostcode": "A65 F4E2",
    "OwnerAddressCountry": "United Kingdom"
}

2. Base64 Encode Your Payload

Convert your payload JSON string to Base64.

3. Generate Signature

Use HMAC SHA-256 to generate the signature with your secret key and payload.

Node.js Example:

4. Construct the Onboarding URL

Use the following format:

https://portal.datmancrm.com/signup?q=<BASE64_PAYLOAD>&signature=<SIGNATURE>&key=<public_key>

Example:

https://portal.datmancrm.com/signup?q=U2FtcGxlUGF5bG9hZA==&signature=SSSS&key=1234

5. Redirect the User

Redirect the user to the generated URL. The user will see the onboarding form and can sign up.

Final Recommendations

Ensure the secret key is kept safe and never exposed on client-side code.

Always double-check that Base64 and signature generation are correct before redirection.

Prerequisites#

Environments#

Process Flow Diagram#

Step-by-Step Integration Guide#

1. Prepare Your Payload#

2. Base64 Encode Your Payload#

3. Generate Signature#

4. Construct the Onboarding URL#

5. Redirect the User#

Final Recommendations#