Customer KYB via API (Business Only)

Introduction

To initiate the KYB process via API, you will need to include all the optional fields in the customer creation request. Once submitted, the customer information is verified programmatically. Any required supporting documents must then be uploaded to complete the KYB process.

KYB via API Flow

The required documents for the KYB Process are:

• Incorporation Certificate
• Shareholder Registry
• Directors Registry
• Proof of Address
• Identification Document (for business representative)

In addition to the required documents, SpherePay may request additional information during the onboarding process depending on the business's risk profile and SpherePay internal risk assessment.

Onboarding a Customer step by step using KYB API

The following steps will guide you through the process of onboarding a business customer step by step using KYB API.

1. Create a Customer

To create a customer, you can use the Create Customer endpoint.

Request Example

{
  "type": "business",
  "email": "business@example.com",
  "phone": "+1234567890",
  "address": {
    "line1": "123 Main St",
    "line2": "string",
    "city": "San Francisco",
    "postalCode": "94107",
    "state": "CA",
    "country": "USA"
  },
  "businessInformation": {
      "legalName": "SpherePay Pte Ltd",
      "tradeName": "SpherePay",
      "description": "SpherePay is a payment processing platform",
      "entityType": "corportation",
      "naicsCode": "1234567890",
      "website": "https://spherepay.co",
      "incorporatedOn": "2026-01-01",
      "identificationNumberType": "ein",
      "identificationNumber": "1234567890",
      "identificationNumberCountry": "USA",
      "identificationNumberDescription": "Employer Identification Number",
      "estimatedAnnualRevenueInUsd": "100000_999999",
      "expectedMonthlyPaymentsUsd": "800000",
      "accountPurpose": "third_party_money_transmission",
      "accountPurposeDescription": "Handles client funds",
      "primarySourceOfFunds": "third_party_funds",
      "primarySourceOfFundsDescription": "Client funds",
      "isDao": false,
      "regulatedActivities": ["money_services"],
      "regulatedActivitiesDescription": "The business engages in money services",
      "participatesInRegulatedFinancialActivity": true,
      "regulatedFinancialActivityDescription": "The business engages in money services",
      "moneyServicesDescription": "Handles client funds",
      "complianceScreeningExplanation": "Approved by third-party",
      "operatesInProhibitedCountries": false
  }
}

2. Accepting Terms of Service & Signing Merchant Service Agreement

After a business customer has been created, you can generate a TOS link to redirect the customer to the Terms of Service and Privacy Policy. To generate a TOS link, you can use the Generate TOS Link endpoint

Once the link is generated, you can redirect the customer to the link to complete the onboarding process. The customer is expected to accept the Terms and Conditions, and Privacy Policy before proceeding. After the customer has accepted the Terms and Conditions, SpherePay will automatically redirect the user to a form to fill out required information for the Merchant Service Agreement (MSA). Once the form is completed, the customer will be redirected to the Merchant Service Agreement page to sign the agreement.

3. Register Business Representative (UBO)

The business representative, also known as the Ultimate Beneficial Owner (UBO), must be a person who owns at least 25% shares of the company and can act as a spokesperson for the company. This step can be done in conjunction with the MSA signing process (Step 2).

To register a business representative, you can use the Register Business Representative endpoint.

Request Example

{
  "name": "John Doe",
  "email": "john.doe@example.com",
  "phone": "+1234567890"
}

4. Upload Required Documents including Identification Document for Business Representative (UBO)

Once the business representative (UBO) has been registered, you need to upload their required documents including identification document for identification verification. Important: Documents must be uploaded before requesting face liveness verification.

Other documents such as proof of address, incorporation certificate, shareholder registry, directors registry, etc. can be uploaded at this step.

To upload the required documents for the business representative, you can use the Upload Required Documents endpoint.

To find out what documents are required for the business representative (UBO), please refer to the Individual Verification Criteria.

incop

Request Example

curl --location 'https://api.spherepay.co/v2/document' \
--header 'Authorization: Bearer <your_api_key>' \
--form 'target="business-representative"' \
--form 'targetId="business_representative_4914a2f6226e42cc8d207ead9573b29f"' \
--form 'documentType="id_card"' \
--form 'side="front"' \
--form 'file=@"/path/to/your/document.jpg"' \
--form 'country="SGP"'

Response Example

{
  "id": "document_4914a2f6226e42cc8d207ead9573b29f",
  "target": "business_representative",
  "targetId": "business_representative_4914a2f6226e42cc8d207ead9573b29f",
  "documentType": "id_card",
  "description": "John Doe passport for identity verification",
  "fileName": "id_card_john_doe.jpg",
  "fileSize": 2048576,
  "mimeType": "image/jpeg",
  "createdAt": "2025-05-23T11:45:00Z"
}

5. Face Liveness Verification for Business Representative (UBO)

Important: Documents must be uploaded before requesting face liveness verification.

Once the required documents for the business representative (UBO) have been uploaded, you can request for face liveness verification. To request for face liveness verification, you can use the Request Face Liveness Verification for Business Representative endpoint.

Response Example

{
  "url": "<https://sumsub.com/websdk/p/sbx_12345678-abcd-efgh-ijkl-123456789012>",
  "expiresAt": "2025-05-23T23:59:59Z"
}

Once the link is generated, you can redirect or open the link in a new tab for the business representative (UBO) to complete the face liveness verification process. The business representative is expected to complete the face liveness verification process before proceeding.

6. Submit Business Representative (UBO) Verification

Important: The business representative (UBO) must be verified before submitting the business customer for verification.

Once all the steps above have been completed for the business representative (documents uploaded and face liveness verification completed), you can proceed to submit the business representative's information for verification. To start the verification process, you can use the Submit Business Representative Information for Verification endpoint.

Response Example

{
  "businessRepresentativeId": "business_representative_4914a2f6226e42cc8d207ead9573b29f"
}

7. Submit Business Customer for Verification

Once the business representative (UBO) has been verified, you can proceed to submit the business customer's information for verification. To start the verification process, you can use the Submit Verification endpoint. This is the final step in the onboarding process and will trigger the verification process.

Response Example

{
  "customerId": "customer_4914a2f6226e42cc8d207ead9573b29f"
}

Please note that the HTTP status code for this endpoint is 200 OK. Once the verification is submitted, the business customer will be onboarded and subject for further verification. The process will take approximately 0-2 business days to complete. You can check the KYB status to ensure the customer has completed the KYB process by checking the Get Customer endpoint.

8. Register Customer's Wallet & Bank Account

Once the business customer has been created and the KYB process is complete, you can register a wallet and a bank account for the customer. Please refer to the Register Wallet & Bank Account guide for more information.

9. Create a Transfer

Once the business customer has been created and the KYB process is complete, you can create a transfer for the customer. Please refer to the Transfer guide for more information.