Customer Registration

POST

When to use this API

Customer Registration is not a mandatory call before every payout, and it is not a prerequisite for a quotation — you can price a transaction first with a blank customerCode and resolve registration afterwards. Which path applies depends on whether RHUB already knows the customer.

Existing customer

RHUB already holds the customer. Continue with the customer code you hold — at quotation and at payout. No further registration is needed.

New customer, registered before payout

The customer is not yet known to RHUB and you want to register them as a separate step. After the quotation, register the customer with the Customer Registration API and use the resulting customer code for the payout.

New customer, registered on the fly

The customer is not yet known to RHUB and you want to register them as part of the payout. RHUB supports registration inside the Payout flow, governed by isAutoRegistered and the sender details the Payout contract defines. No separate Customer Registration call is needed.

Coded fields in the request draw their values from the master APIs — for example Business Type, Business Registration Type, Nature of Business, Customer Legal Status, Occupation and Document ID Type.

KYC/KYB Document Requirements

The documents RHUB accepts and requires when registering a customer. Which of them applies depends on the customer you are onboarding; they are not all submitted in a single API call.

KYC — Individual Customers

Accepted document types for an individual customer:

Citizenship Card
Driving License
Emirates ID
GCC ID
Govt. Approved ID
National ID Card
Passport
Residence Permit
Senior Citizen Card

KYB — Business Customers

Required documents for a business customer, by category:

Business registration and incorporation

Trade/Commercial License
Certificate of Incorporation
Memorandum and Articles of Association

Owners, shareholders and partners

Certified ID copies of all Owners/Shareholders/Partners
Address proof of all Owners/Shareholders/Partners

Authorized signatories and representatives

Approved Authorized Signatory List with specimen signatures
Certified ID copy of Authorized signatories
Certified ID copy of Authorized representatives

Company address

Company Address proof (not older than 3 months)

Codes and upload mechanics

RHUB has not published a mapping between these document names and idTypeCode, the document ID type codes or any master API value, so none is given here. Upload mechanics — supported formats, size limits and how a reference is returned — are on Document Upload.

Contract

There are two methods for registering a customer:

Using this API.
On-the-fly registration during payout.

If you choose auto-registration (on-the-fly registration) during payout, this API is not required.

POST/ewallet/api/v1/customer-registration

Sandboxhttps://sandbox-client.remittanceshub.com:8130/ewallet/api/v1/customer-registrationProductionhttps://prod-api.remittanceshub.com:9091/ewallet/api/v1/customer-registration

The Customer-Registration API is used to register or create the customer in the system.

Request Parameter of Business Customer

Parameters	Input Type	Length	Requirement	Description
customerTypeCode	Numeric	06	M	Individual : 100001, Business : 100002 eg: 100002
customerSubTypeCode	Numeric	06	M	100001
serviceTypeCode	Alpha	07	M	REGULAR
docReferenceNumber	Alphanumeric	10 - 30	M	10 digit unique doc reference number, used while uploading document. eg: GHJ7K87GJGG6 (should contains 10 to 30 digits alpha numeric only)
walletOwnerCode	Numeric	10	M	Send Client Code. eg:1000009999
tradeName	Alphanumeric	01 - 70	M	Company trade name. eg: Hcl tech
natureOfBusinessCode	Alphanumeric	06 - 10	M	Select the suited data received from nature of business Api. (eg: RHT011 , refer NatureOfBusinessApi )
dialCode	Alphanumeric with '+' symbol	02 - 04	C	Country dial code. eg: +1, +91 note: Required when the contact number dial code does not match the selected country code.
mobileNumber	Alphanumeric	07 - 20	M	Contact number. eg: 9090909090
email	Alphanumeric + special characters (Email format)	01 - 50	M	Email id of customer. eg: john.doe@example.com
addressLine1	Alphanumeric	01 - 35	M	Address detail of business. eg: A455 Wall street
countryCode	Alpha	03	M	3-digit Country code of business's address. eg:MWI,DZA etc
state	Alpha	01 - 50	M	State eg: Delhi
city	Alpha	01 - 50	M	City eg: Delhi
pincode	Alphanumeric	01 - 10	M	Pincode eg: SDFC2345
businessRelationshipCode	Numeric	06	O	for International Remittance use : 100003, for Others use : 100004
businessAuthorizedPerson	Alpha	01 - 50	O	The authorized person in the company. eg: John Wick
legalStatusCode	Alphanumeric	06 - 10	M	Select the suited data received from Business Registration Type/Legal Status API from Master. (eg: RHB002 , refer LegalStatusApi)
idNumber	Alphanumeric	01 - 50	M	Business registration/license number. eg: GJJKJHKJH889GJ
idCountry	Alpha	03	M	Business registration/license country code, eg: MWI,USD etc
issueDate	Date	10 - 19	M	Business registration/license issue date in yyyy-mm-dd format. eg: 1999-09-12
idExpiryDate	Date	10 - 19	M	Business registration/license expiry date in yyyy-mm-dd format. eg: 1999-09-12
ownerDetailList
//for individual owner
customerTypeCode	Numeric	06	M	for Individual owner : 100001
firstName	Alpha	01 - 75	M	First name of owner. eg: John
lastName	Alpha	02 - 75	M	Last name of owner. eg: Sharma
dateOfBirth	Date	10 - 19	M	Date of birth of owner in yyyy-mm-dd format. eg: 1999-09-12
gender	Alpha	01 - 10	M	Gender of owner (male, female, other)
addressLine1	Alphanumeric	01 - 35	M	Address detail of owner. eg: 89WE jane street
countryCode	Alpha	03	M	3-digit Country code of owner's address. eg: MWI,DZA etc
state	Alpha	01 - 50	M	State. eg: Delhi
city	Alpha	01 - 50	M	City eg: Delhi
pincode	Alphanumeric	01 - 10	M	Pincode eg: SDFC2345
idTypeCode	Alphanumeric	06 - 10	M	The predefined code corresponding to the different document types for business. eg: eg: RHD006 (for more info, please refer to DocumentTypeApi)
idNumber	Alphanumeric	01 - 50	M	Id numder of the Id proof provided for Kyc. eg:JHGHG987KIUK
idCountry	Alpha	03	M	3-digit Country code of country where id issued. eg: USA, IND
//for business owner
customerTypeCode	Numeric	06	M	for Business owner : 100002
companyName	Alphanumeric	01 - 70	M	Business company/Trade name eg: Example Trading Ltd
addressLine1	Alphanumeric	01 - 35	M	Address detail of company eg: HG68 Example Road
countryCode	Alpha	03	M	3-digit Country code of company. eg: USA, CHN
state	Alpha	01 - 50	M	State eg: Delhi
city	Alpha	01 - 50	M	City eg: New york

Requirement legend: M = Mandatory · O = Optional · C = Conditional

Request Details of Business Customer

POST /services HTTP/1.0
HOST: sandbox-client.remittanceshub.com:8130
Content-Type: application/json; charset=utf-8
POST https://sandbox-client.remittanceshub.com:8130/ewallet/api/v1/customer-registration
{
  "customerTypeCode": "100002",
  "customerSubTypeCode": "100001",
  "serviceTypeCode": "REGULAR",
  "docReferenceNumber": "CUS1234571",
  "walletOwnerCode": "1000008398",.
  "tradeName": "Example Trading Ltd",
  "natureOfBusinessCode": "RHT010",
  "mobileNumber": "9876543211",
  "email": "accounts@example.com",
  "addressLine1": "12 Example Road",
  "countryCode": "MWI",
  "state": "Central Region",
  "city": "Lilongwe",
  "pincode": "676567",
  "businessRelationshipCode": "100003",
  "businessAuthorizedPerson": "Example",
  "legalStatusCode": "RHB002",
  "idNumber": "ID321412123123",
  "idCountry": "CAN",
  "issueDate": "2024-08-22",
  "idExpiryDate": "2024-08-31",
  "ownerDetailList": [
  {
    "customerTypeCode": "100001",
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "2006-08-22",
    "gender": "male",
    "companyName": "",
    "addressLine1": "12 Example Road",
    "countryCode": "MWI",
    "state": "Malawi",
    "city": "Lilongwe",
    "pincode": "121122",
    "idTypeCode": "RHD002",
    "idNumber": "ID1212121212",
    "idCountry": "IND",
 },
  {
    "customerTypeCode": "100002",
    "companyName": "Example Trading Ltd",
    "addressLine1": "12 Example Road",
    "countryCode": "MWI",
    "state": "Central Region",
    "city": "Lilongwe",
  }
  ]
  }

Response Details of Business Customer

{
"transactionId": "7915520",
"requestTime": "Mon Feb 03 11:51:46 IST 2025",
"responseTime": "Mon Feb 03 11:51:47 IST 2025",
"resultCode": "0",
"resultDescription": "Transaction successful",
"customerRegistration": {
    "code": "1000000645",
    "customerTypeCode": "100002",
    "customerSubTypeCode": "100001",
    "walletOwnerCode": "1000008398",
    "customerId": "100000000000002B",
    "fullName": "Example Trading Ltd",
    "tradeName": "Example Trading Ltd",
    "natureOfBusinessCode": "RHT010",
    "mobileNumber": "9876543211",
    "addressLine1": "12 Example Road",
    "city": "Lilongwe",
    "state": "Central Region",
    "pincode": "676567",
    "countryCode": "MWI",
    "idNumber": "ID321412123103",
    "idCountry": "CAN",
    "issueDate": "2024-08-22T00:00:00.000+0530",
    "idExpiryDate": "2024-08-31T00:00:00.000+0530",
    "screeningStatus": "IP",
    "customerStatus": "Active",
    "customerState": "System Approved",
    "customerStateCode": "AA",
    "countryName": "Malawi",
    "idCountryName": "Canada",
    "natureOfBusinessName": "Banking",
    "customerTypeName": "Juridical Owner",
    "creationDate": "2025-02-03T11:51:46.907+0530",
    "createdBy": "105513",
    "sendClientName": "Example Trading Ltd",
    "docReferenceNumber": "DOC1234567",
    "walletOwnerName": "Example Trading Ltd",
    "logoUrl": "/fileUpload/download/1000008398/Example_logo.jpeg",
    "sendClientAddress": "123 Example Street, Blantyre, Blantyre, Malawi",
    "sendClientMobileNo": "265768568432",
    "registrationApprovedBy": "EXAMPLE",
    "registrationNumber": "ID321412123103",
    "ownerDetailList": [
        {
            "code": "1000000458",
            "customerTypeCode": "100001",
            "ownerId": "100000000000002B00",
            "customerCode": "1000000645",
            "firstName": "John",
            "middleName": "",
            "lastName": "Doe",
            "companyName": "",
            "fullName": "John Doe",
            "gender": "male",
            "nationality": "",
            "dateOfBirth": "2006-08-22 00:00:00",
            "email": "",
            "mobileNumber": "",
            "addressLine1": "12 Example Road",
            "addressLine2": "",
            "city": "Lilongwe",
            "state": "Malawi",
            "pincode": "121122",
            "countryCode": "MWI",
            "residenceStatusCode": "",
            "transactionVolumeCode": "",
            "idTypeCode": "RHD002",
            "idNumber": "ID1212121212",
            "idIssuedBy": "",
            "idCountry": "IND",
            "screeningStatus": "IP",
            "screeningScore": "",
            "screeningUniqueId": "",
            "screeningUrl": "",
            "creationDate": "2025-02-03T11:51:46.998+0530",
            "ownerStatus": "Active",
            "ownerState": "System Approved",
            "ownerStateCode": "AA",
            "dialCode": "",
            "businessAuthorizedPerson": "",
            "source": ""
        },
        {
            "code": "1000000459",
            "customerTypeCode": "100002",
            "ownerId": "100000000000002B00",
            "customerCode": "1000000645",
            "firstName": "",
            "middleName": "",
            "lastName": "",
            "companyName": "Example Trading Ltd",
            "fullName": "",
            "gender": "",
            "nationality": "",
            "email": "",
            "mobileNumber": "",
            "addressLine1": "12 Example Road",
            "addressLine2": "",
            "city": "Lilongwe",
            "state": "Central Region",
            "pincode": "121212",
            "countryCode": "MWI",
            "residenceStatusCode": "",
            "transactionVolumeCode": "",
            "idTypeCode": "",
            "idNumber": "",
            "idIssuedBy": "",
            "idCountry": "",
            "screeningStatus": "IP",
            "screeningScore": "",
            "screeningUniqueId": "",
            "screeningUrl": "",
            "creationDate": "2025-02-03T11:51:47.335+0530",
            "ownerStatus": "Active",
            "ownerState": "System Approved",
            "ownerStateCode": "AA",
            "dialCode": "",
            "businessAuthorizedPerson": "",
            "source": ""
        }
    ],
    "autoRegistered": false
}
}

Request Parameter of Individual Customer

Parameters	Input Type	Length	Requirement	Description
customerTypeCode	Numeric	06	M	Individual : 100001, Business : 100002 eg: 100001
customerSubTypeCode	Numeric	06	M	100001
serviceTypeCode	Alpha	07	M	REGULAR
docReferenceNumber	Alphanumeric	10 - 30	M	10 digit unique doc reference number, used while uploading document. eg: GHJ7K87GJGG6 (should contains 10 to 30 digits alpha numeric only)
walletOwnerCode	Numeric	10	M	Send Client Code for which the customer is being registered eg:1000009999
firstName	Alpha	01 - 75	M	First name of customer eg: John
lastName	Alpha	02 - 75	M	Last name of customer eg: Sharma
dateOfBirth	Date	10 - 19	M	Customer's date of birth in yyyy-mm-dd format. eg: 1999-09-12
gender	Alpha	01 - 10	M	Customer's gender. (male, female, other)
nationality	Alpha	03	M	Nationality of customer in 3-digit Country code format. eg:DZA,USA etc
dialCode	Alphanumeric with '+' symbol	02 - 04	C	Country dial code. eg: +1, +91 note: Required when the contact number dial code does not match the selected country code.
mobileNumber	Alphanumeric	07 - 20	M	Contact number. eg: 9090909090
email	Alphanumeric + special characters (Email format)	01 - 50	M	Email id of customer. eg: john.doe@example.com
addressLine1	Alphanumeric	01 - 35	M	Address details of customer eg: A455 Wall street
countryCode	Alpha	03	M	3-digit Country code of customer's residence. eg:MWI,DZA etc
state	Alpha	01 - 50	M	State of customer's residence eg: Delhi
city	Alpha	01 - 50	M	City of customer's residence eg: Delhi
pincode	Alphanumeric	01 - 10	M	Address pincode eg: SDFC2345
occupationCode	Alphanumeric	06 - 10	M	Select the suited data received from Occupation API from Master. ( eg RHO016 refer OccupationApi )
jobTitle	Alpha	01 - 50	O	Designation of customer's job profile
jobIndustry	Alpha	01 - 50	O	Job industry of customer
idTypeCode	Alphanumeric	06 - 10	M	The predefined code corresponding to the different document types for individual. eg RHD002 (for more info, please refer to DocumentTypeApi)
idNumber	Alphanumeric	01 - 50	M	Id numder of the Id proof provided for Kyc eg:JHGHG987KIUK
issueDate	Date	10 - 19	M	Issue date of the Id proof provided for Kyc in yyyy-mm-dd format. eg: 1999-09-12
idExpiryDate	Date	10 - 19	M	Expiry date of the Id proof provided for Kyc in yyyy-mm-dd format. eg: 2026-09-12

Requirement legend: M = Mandatory · O = Optional · C = Conditional

Request Details of Individual Customer

 POST /services HTTP/1.0
 HOST: sandbox-client.remittanceshub.com:8130
 Content-Type: application/json; charset=utf-8
 POST https://sandbox-client.remittanceshub.com:8130/ewallet/api/v1/customer-registration

 {
"customerTypeCode": "100001",
"customerSubTypeCode": "100001",
"docReferenceNumber": "CUS1234569",
"serviceTypeCode": "REGULAR",
"walletOwnerCode": "1000008438",
"firstName": "John",
"lastName": "Doe",
"dateOfBirth": "2006-08-22",
"occupationCode": "RHO016",
"jobTitle": "Job Title",
"jobIndustry": "Job Industry",
"gender": "female",
"nationality": "IND",
"mobileNumber": "9876543211",
"email": "accounts@example.com",
"addressLine1": "123 Example Street",
"countryCode": "TZA",
"state": "Dar es Salaam",
"city": "Dar es Salaam",
"pincode": "232222",
"idTypeCode": "RHD002",
"idNumber": "ID2121121212",
"issueDate": "2024-08-22",
"idExpiryDate": "2029-01-09"
 }

Response Details of Individual Customer

{
"transactionId": "9226196",
"requestTime": "Mon Feb 03 11:49:51 IST 2025",
"responseTime": "Mon Feb 03 11:49:51 IST 2025",
"resultCode": "0",
"resultDescription": "Transaction successful",
"customerRegistration": {
    "code": "1000002221",
    "customerTypeCode": "100001",
    "customerSubTypeCode": "100001",
    "walletOwnerCode": "1000008929",
    "customerId": "100000000000004I",
    "firstName": "John",
    "lastName": "Doe",
    "fullName": "John Doe",
    "nickName": "John",
    "tradeName": "John Doe",
    "gender": "male",
    "nationality": "IND",
    "dateOfBirth": "1989-08-28",
    "mobileNumber": "9876543212",
    "addressLine1": "12 Example Road",
    "city": "New Delhi",
    "state": "New Delhi",
    "pincode": "544444",
    "countryCode": "MWI",
    "idTypeCode": "RHD002",
    "idNumber": "ID31232444444",
    "screeningStatus": "IP",
    "customerStatus": "Active",
    "customerState": "System Approved",
    "customerStateCode": "AA",
    "nationalityName": "India",
    "countryName": "Malawi",
    "customerTypeName": "Individual",
    "creationDate": "2025-02-03T11:49:51.259+0530",
    "createdBy": "105732",
    "sendClientName": "EXAMPLE",
    "docReferenceNumber": "CUS1234570",
    "walletOwnerName": "EXAMPLE",
    "logoUrl": "/fileUpload/download/1000008929/logo 1DADANADA.jpg",
    "sendClientAddress": "12 Example Road, Area 3, Blantyre, Southern Region, Malawi",
    "sendClientMobileNo": "26599123456789",
    "idTypeName": "Passport ",
    "registrationApprovedBy": "EXAMPLE",
    "registrationNumber": "ID31232444444",
    "createdByCode": "1000008929",
    "createdByName": "EXAMPLE",
    "autoRegistered": false
    }
  }

When to use this API​

KYC/KYB Document Requirements​

KYC — Individual Customers​

KYB — Business Customers​

Contract​

Request Parameter of Business Customer​

Request Details of Business Customer​

Response Details of Business Customer​

Request Parameter of Individual Customer​

Request Details of Individual Customer​

Response Details of Individual Customer​

Related APIs​