Skip to main content
POST
Register Customer
Create a new customer account with personal information and authentication credentials. Customers can access self-service features including sending remittances, applying for loans, and managing investments.

​
Password Encryption

Security Requirement: The password and confirmPassword fields can optionally be encrypted using RSA public key encryption before sending to the API.
When registering customers, you can choose to encrypt password fields using the RSA public key provided on your dashboard. Encryption ensures data confidentiality during transmission.

​
Customer Registration Flow

The payloadEncrypted field determines how the system processes your payload:
For production integrations, use payloadEncrypted with encrypted passwords to protect customer credentials.

Encryption Keys & Tokens

Learn how to encrypt passwords using RSA public key encryption with OAEP padding (SHA-256).

​
Request Headers

​
Code Examples

For internal testing or development environments where encryption is not required:
Never use payloadEncrypted: false in production environments as it transmits passwords without encryption.

​
Validation Rules

  • Must be a valid email format - Must be unique across all customers in the tenant - Cannot be changed after creation - Maximum length: 255 characters
  • Minimum 8 characters - At least one uppercase letter (A-Z) - At least one lowercase letter (a-z) - At least one number (0-9) - At least one special character (!@#$%^&*) - Cannot contain common words or patterns
  • Must be in international format with country code - Example: +447123456789 (UK), +12125551234 (US) - No spaces or special characters except leading + - Must be a valid phone number for the country
  • Customer must be at least 18 years old - Date of birth must be in ISO format (YYYY-MM-DD) - Cannot be a future date - Cannot be more than 120 years ago
  • First name: 2-50 characters - Last name: 2-50 characters - Only letters, spaces, hyphens, and apostrophes allowed - No numbers or special characters

Login

Authenticate the newly created customer

Submit KYC Documents

Upload verification documents for the customer

Headers

​
platform
string
default:fincode
required
​
uuid
string
default:200
required

Body

application/json
​
devicePlatform
string
required
Example:

"IOS"

​
appVersion
string
required
Example:

"1"

​
appId
string
required
Example:

"com.fincode.remitjunction"

​
customerType
enum<string>
default:INDIVIDUAL
required
Available options:
INDIVIDUAL,
COMPANY
Example:

"INDIVIDUAL"

​
payloadEncrypted
boolean
default:true
required

Determines whether the payload contains encrypted or raw data. Use payloadEncrypted: true when sending encrypted passwords, or payloadEncrypted: false for raw passwords.

Example:

true

​
firstName
string
required
Example:

"Excel"

​
lastName
string
required
Example:

"Nwachukwu"

​
email
string<email>
required
Example:

"excel.nwachukwu+2@fincode.co.uk"

​
dialingCode
string
required
Example:

"+44"

​
phone
string
required
Example:

"984 573 63733"

​
dob
string<date>
required
Example:

"1989-12-16"

​
password
string<password>
required

Customer password. Must be RSA-encrypted (Base64) when using payloadEncrypted is true, or raw when using false.

Example:

"O5ti8XI/pLYC27E+ehORvg2YplXqX3ckoS7Kzk9cEdtC+LSzVICID9c/Tzsi0V5d..."

​
confirmPassword
string<password>
required

Must match the password field. Must be RSA-encrypted (Base64) when using payloadEncrypted is true, or raw when false.

Example:

"O5ti8XI/pLYC27E+ehORvg2YplXqX3ckoS7Kzk9cEdtC+LSzVICID9c/Tzsi0V5d..."

​
address
object
required
​
dynamicFields
object
required

Response

200

Customer registered successfully