​

B2B Customer Registration Flow

This guide details the complete flow for registering business (B2B) customers in the FinHub platform. The registration process involves several steps including business account creation, verification, and document submission.

​

Flow Overview

The following sequence diagram illustrates the complete B2B registration process:

​

Implementation Steps

​

1. Create Business Account

The first step is to create a business account in the system.

Endpoint: POST /api/v2/business/create

Request Body:

{
  "businessName": "Acme Corporation",
  "businessType": "LIMITED_COMPANY",
  "registrationNumber": "12345678",
  "countryOfIncorporation": "GB",
  "taxIdentificationNumber": "GB123456789"
}

Response:

{
  "businessId": "bus_12345678",
  "status": "CREATED",
  "createdAt": "2025-06-01T10:30:00Z"
}

​

2. Add Business Details

Next, add detailed information about the business.

Endpoint: PUT /api/v2/business/{businessId}/details

Request Body:

{
  "businessAddress": {
    "addressLine1": "123 Business Street",
    "addressLine2": "Suite 456",
    "city": "London",
    "region": "Greater London",
    "postalCode": "EC1A 1BB",
    "country": "GB"
  },
  "businessContact": {
    "email": "contact@acmecorp.com",
    "phone": "+44123456789",
    "website": "https://www.acmecorp.com"
  },
  "industryCategory": "TECHNOLOGY",
  "yearEstablished": 2010,
  "numberOfEmployees": "10_49"
}

Response:

{
  "businessId": "bus_12345678",
  "status": "DETAILS_ADDED",
  "updatedAt": "2025-06-01T10:35:00Z"
}

​

3. Add Business Representative

Add an authorized representative for the business.

Endpoint: POST /api/v2/business/{businessId}/representatives

Request Body:

{
  "firstName": "John",
  "lastName": "Smith",
  "dateOfBirth": "1980-01-15",
  "nationality": "GB",
  "email": "john.smith@acmecorp.com",
  "phone": "+44123456789",
  "position": "DIRECTOR",
  "isPrimaryContact": true,
  "address": {
    "addressLine1": "456 Residential Street",
    "city": "London",
    "postalCode": "EC1A 2CC",
    "country": "GB"
  }
}

Response:

{
  "representativeId": "rep_12345678",
  "verificationStatus": "PENDING_EMAIL_VERIFICATION",
  "verificationEmailSent": true
}

​

4. Upload Business Documents

Upload required business documentation.

Endpoint: POST /api/v2/business/{businessId}/documents

Request Body (multipart/form-data):

documentType: CERTIFICATE_OF_INCORPORATION
file: [binary data]
description: Certificate of Incorporation for Acme Corporation

Response:

{
  "documentId": "doc_12345678",
  "documentType": "CERTIFICATE_OF_INCORPORATION",
  "status": "UPLOADED",
  "uploadedAt": "2025-06-01T10:45:00Z"
}

​

5. Submit for Verification

Once all required information and documents are provided, submit the business for verification.

Endpoint: POST /api/v2/business/{businessId}/verify

Request Body:

{
  "acceptTerms": true,
  "acceptPrivacyPolicy": true
}

Response:

{
  "businessId": "bus_12345678",
  "verificationStatus": "IN_REVIEW",
  "estimatedCompletionTime": "2025-06-03T10:45:00Z"
}

​

Required Documents

The following documents are typically required for business verification:

1. Certificate of Incorporation
2. Proof of Business Address (utility bill, bank statement, etc.)
3. Articles of Association
4. Shareholder Register
5. Proof of Identity for all representatives and beneficial owners

​

Verification Process

After submission, the business verification process includes:

1. Document Verification: All submitted documents are checked for authenticity
2. Business Registry Check: Verification against official business registries
3. Representative Verification: Identity verification of key representatives
4. Beneficial Owner Verification: Identity verification of beneficial owners
5. Risk Assessment: Evaluation of business risk profile

​

Next Steps

After successful verification, you can proceed to:

1. Create wallets for the business
2. Set up payment methods
3. Configure user permissions
4. Begin processing transactions

For more information on these steps, refer to the relevant guides in our documentation.