Create Customer
Register a new customer account in the FinCode platform
Password Encryption
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
ThepayloadEncrypted field determines how the system processes your payload:
| Value | Description |
|---|---|
true | Indicates payload is RSA-encrypted. The system will decrypt before processing. |
false | Indicates payload is sent as raw plaintext. Use only for testing or internal systems. |
Encryption Keys & Tokens
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Content-Type | string | Yes | Must be application/json |
platform | string | Yes | Platform identifier. Use fincode |
uuid | string | Yes | Unique request identifier. Use 200 |
Code Examples
Using payloadEncrypted: false (Testing Only)
Using payloadEncrypted: false (Testing Only)
Validation Rules
Email Validation
Email Validation
- Must be a valid email format - Must be unique across all customers in the tenant - Cannot be changed after creation - Maximum length: 255 characters
Password Requirements
Password Requirements
- 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
Phone Number Format
Phone Number Format
- 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
Age Requirement
Age Requirement
- 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
Name Validation
Name Validation
- First name: 2-50 characters - Last name: 2-50 characters - Only letters, spaces, hyphens, and apostrophes allowed - No numbers or special characters
Related Endpoints
Login
Submit KYC Documents
Body
"IOS"
"1"
"com.fincode.remitjunction"
INDIVIDUAL, COMPANY "INDIVIDUAL"
Determines whether the payload contains encrypted or raw data. Use payloadEncrypted: true when sending encrypted passwords, or payloadEncrypted: false for raw passwords.
true
"Excel"
"Nwachukwu"
"excel.nwachukwu+2@fincode.co.uk"
"+44"
"984 573 63733"
"1989-12-16"
Customer password. Must be RSA-encrypted (Base64) when using payloadEncrypted is true, or raw when using false.
"O5ti8XI/pLYC27E+ehORvg2YplXqX3ckoS7Kzk9cEdtC+LSzVICID9c/Tzsi0V5d..."
Must match the password field. Must be RSA-encrypted (Base64) when using payloadEncrypted is true, or raw when false.
"O5ti8XI/pLYC27E+ehORvg2YplXqX3ckoS7Kzk9cEdtC+LSzVICID9c/Tzsi0V5d..."
Response
Customer registered successfully
