Create a business customer profile+ API

post

https://api-sandbox.straitsx.com/v1/kyc/customer_profiles

[Available in Sandbox/Production environment] Create a business CP+ profile on our platform.

Body Params

customerName

string

required

Customer's full name (50 alphanumeric with spaces)
Regex: /^(?=.{1,50}$)[a-zA-Z0-9 ]+$/

customerNativeName

string

Regex: /^\s*.{1,191}\s*$/

merchantRef

string

Regex: /^\s*.{1,191}\s*$/

registrationType

string

required

Business

registrationIdType

string

required

business_reg_no

registrationId

string

required

Business Registration Number of the customer.
4-35 alphanumeric chars.
Regex: /\A[a-zA-Z0-9\- ]{4,35}\z/

entityLegalForm

string

required

Accepted values: PRIVATE_COMPANYorPUBLIC_COMPANY

businessContact

string

required

Provide the string in a valid format.
Regex: ^\+?[1-9]\d{0,3}[\s\-]?$?\d{1,4}$?[\s\-]?\d{1,4}[\s\-]?\d{1,4}[\s\-]?\d{0,4}$

website

string

Provide a valid URL.
Regex: /^(https?:\/\/)?(([0-9]{1,3}(\.[0-9]{1,3}){3,5})|(([-\p{L}0-9]{1,256}\.)+[-\p{L}]{2,6}))(:[0-9]+)?([\/?].*)?$/i

countryOfIncorporation

string

required

Customer's country of incorporation.
2 digit ISO country code - https://www.iban.com/country-codes

List of accepted countries, Refer to Other Info > Accepted Countries

dateOfIncorporation

string

required

yyyy-MM-dd format

address

object

required

Customer's registered address.

operatingAddress

object

required

Customer’s business operating address.

natureOfBusiness

string

required

Accepted Values:
PERSONAL_INVESTMENT_COMPANIES
SUPERANNUATION_FUND
CRYPTO_MINING
PROPRIETARY_TRADING
ALGORITHM_CRYPTO_TRADERS
P2P_MERCHANTS
OTHER_WEB3_SERVICES_NON_VASP
ACCOMMODATION_AND_FOOD_SERVICES
WASTE_MANAGEMENT_AND_REMEDIATION_SERVICES
AGRICULTURE_FORESTRY_FISHING_AND_HUNTING
ARTS_ENTERTAINMENT_AND_RECREATION
EDUCATIONAL_SERVICES
GAMING
HEALTHCARE_AND_SOCIAL_ASSISTANCE
INFORMATION
GENERAL_MANUFACTURING
PROFESSIONAL_SERVICES
SCIENTIFIC_AND_TECHNICAL_SERVICES
RETAIL_ELECTRONICS
RETAIL_FOOD_AND_BEVERAGE
RETAIL_JEWELRY
RETAIL_OTHERS
SALE_OF_DRUGS_AND_PHARMACEUTICAL_PRODUCTS
TRANSPORTATION_AND_WAREHOUSING
FAMILY_OFFICE
SOVEREIGN_WEALTH_FUND
INVESTMENT_FUNDS
CRYPTO_EXCHANGE_BROKER
CRYPTO_ATM
OTHER_DIGITAL_ASSET_SERVICE_PROVIDERS_VASP
BANK
NON_BANK_FINANCIAL_INSTITUTION
MONEY_SERVICES_BUSINESS_PAYMENT_SERVICE_PROVIDERS
CONSTRUCTION
GENERAL_WHOLESALERS
MANAGEMENT_OF_COMPANIES
PRECIOUS_STONES_METALS_DEALERS
CRUDE_OIL_NATURAL_GAS_DEALERS
PAWN_SHOPS
PUBLIC_ADMINISTRATION
REAL_ESTATE_RENTAL_LEASING
UTILITIES
OTHERS

otherNatureOfBusiness

string

*Required field if natureOfBusiness is OTHERS
Format: Free text

usOwnership

boolean

required

true / false

intermediaries

boolean

required

true / false - Refers to this onboarding question: “Is your company owned by any intermediary companies/legal arrangement (at least 10% or more)?

intermediariesDocuments

array of objects

*Required field if intermediaries is true

intermediariesDocuments

monthlyTransactionVolume

string

required

In USD.
Accepted Values: 0_TO_100000, 100001_TO_500000, 500001_TO_1000000, 100001_TO_10000000, GT_10000000

sourceOfWealth

object

*Required if entity is deemed High Risk by StraitsX or if require higher daily limits (Refer to Other Info > Transaction Limit Tiers)

sourceOfFunds

array of strings

required

Accepted Values:
LOAN_FROM_PARENT_COMPANY
LOAN_FROM_DIRECTORS_SHAREHOLDERS
INVESTOR_FUNDS
BUSINESS_LOANS
BUSINESS_REVENUE
CUSTOMER_FUNDS_FOR_INVESTMENT
ARBITRAGE_TRADING
EMPLOYMENT_INCOME
BUSINESS_OWNERSHIP_INCOME
PROPERTY_OWNERSHIP
INVESTMENT_HOLDINGS_RETURNS
GIFTS_INHERITANCE
CASH_SAVINGS
OTHERS

sourceOfFunds*

otherSourceOfFunds

string

*Required field if sourceOfFunds includes OTHERS
Free text.

directors

array of objects

required

directors*

beneficialOwners

array of objects

required

Pass in all beneficial owners for the business

beneficialOwners*

trader

object

required

Pass in the main trader’s information.

documents

object

required

licensingStatus

string

Accepts: FULLY_LICENSED, EXEMPT_FROM_LICENSING, IN_PRINCIPLE_APPROVAL_GRANTED, LICENSE_APPLICATION_IN_PROGRESS, NOT_SUBJECTED_TO_LICENSING_REQUIREMENTS

documents.operatingLicense field becomes mandatory if any option is selected apart from NOT_SUBJECTED_TO_LICENSING_REQUIREMENTS

purposeOfAccount

string

required

Declared purpose of the account.
Accepts only INVESTMENT, TRADING, REMITTANCES, TREASURY MANAGEMENT, BUSINESS USAGE and OTHERS

otherPurposeOfAccount

string

Required if OTHERS is selected for purposeOfAccount field.

Headers

X-XFERS-APP-API-KEY

string

required

You can retrieve this from your Dashboard Developer Tools.

Note: The X-XFERS-APP-API-KEY is a mandatory header for all authentication methods, including standard API key usage and HTTP Request Signing mode.

X-PUBLIC-KEY-ID

string

The Key ID, can be retrieved from your StraitsX Dashboard.

Note: This header attribute is required when HTTP Request Signing is enabled for your account.

X-TIMESTAMP

string

Current Unix epoch time in seconds. Must be within ±300 seconds of server time.

Note: This header attribute is required when HTTP Request Signing is enabled for your account.

X-NONCE

string

A unique UUID string per request, used for replay protection. Must not be reused within the timestamp window.
Regex: /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/i

Note: This header attribute is required when HTTP Request Signing is enabled for your account.

X-SIGNATURE

string

Base64-encoded digital signature of the canonical request string.

Note: This header attribute is required when HTTP Request Signing is enabled for your account.

Responses

200200

400400