Creating Customers - API
Before you can open accounts or initiate transactions in the Lorum portal, you must first create a customer via the Lorum API.
Create a Customer
Individual
Create an individual customer via Add Individual
POST /v1/customers/individuals
Ensure the customer's first name and last name match their legal identification document exactly.
Business
Create a business customer via Add Business
POST /v1/customers/businesses
Ensure the business name matches the legal registration exactly.
Reliance model: The first five customers you create will have a
pendingstatus and require manual review by Lorum's compliance team. Once the reliance model is established, subsequent customers will be automatically approved after creation, provided they meet the required onboarding criteria.
Uploading Customer Documents
Before moving to a reliance model and for certain currencies onboarding, document uploads are required. Documents are uploaded in two steps: first upload the file, then link it to the customer.
Step 1 - Upload the document via Upload Document
POST /v1/documents
The request must be a multipart/form-data upload. Include the document_type field to specify the type of document being uploaded.
Step 2 - Link the document to the customer via Link Document
POST /v1/customers/{customer_id}/documents
For the initial customer compliance review, you can either upload each required document individually or combine all required documents into a single ZIP file and upload it as one file.
ZIP files are not supported for currency onboarding. For currency onboarding, each required document must be uploaded separately with the relevant document type selected.
Other document operations:
- List documents - List Documents
GET /v1/documents
- Get a document - Get Document
GET /v1/documents/{document_id}
- Unlink a document - Unlink Document
DELETE /v1/customers/{customer_id}/documents/{document_id}
Moving to Reliance Model
Client File Requirements
As part of approval, and on an ongoing basis throughout your relationship with Lorum, you may be required to provide client files for compliance review. Lorum reviews these files in accordance with the AML Policies and Procedures you share during approval - so the documents and information in a client file should reflect what your own policies require you to collect.
Individual Customers
Client files for individuals should include:
- Valid identification documents
- Valid proof of address documents
- Source of funds or source of wealth (if applicable)
- Expected transactional activity:
- Anticipated monthly volume and number of transactions
- Purpose of the transactions
- Client profile
- Evidence of client risk rating
Business Customers
Client files for businesses should include:
- Certificate of incorporation or business registration
- Shareholder and ownership structure
- Valid identification documents for all directors and ultimate beneficial owners (UBOs)
- Proof of address for the entity and relevant parties
- Source of funds or source of wealth (if applicable)
- Expected transactional activity:
- Anticipated monthly volume and number of transactions
- Purpose of the transactions
- Client profile and business model
- Evidence of client risk rating
Updated 5 days ago