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 pending status 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:

GET /v1/documents

GET /v1/documents/{document_id}

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

Did this page help you?