Create Business Profile

Create a new business customer profile for KYB onboarding.

Endpoint

POST https://prod.rynopay.io/partner/v1/business-profiles

Request body

Field	Type	Required	Description
email	string	Yes	Business email address (max 255 chars)
phoneNumber	string	No	International phone number (E.164 format, e.g. +2348012345678)
companyName	string	Yes	Registered business name (2–255 chars)
tradingName	string	No	Trading or brand name (max 255 chars)
businessTypeCode	string	Yes	Business structure type. See allowed values
incorporationCountryIso3Code	string	Yes	Country of incorporation (ISO 3166-1 alpha-3, e.g. NGA)
industry	string	Yes	Business industry. See allowed values
description	string	No	Business description (max 1000 chars)
website	string	Yes	Business website (valid absolute URL, max 255 chars)
registrationNumber	string	Yes	Company registration number (max 10 chars)
registrationDate	string	No	Date of registration (YYYY-MM-DD)
addresses	array	No	List of Address objects
financials	object	No	Financial information

Address object

Field	Type	Required	Description
streetLine1	string	Yes	Primary street address (max 255 chars)
streetLine2	string	No	Secondary address line (max 255 chars)
city	string	Yes	City (max 100 chars)
state	string	Yes	State or province (max 100 chars)
postalCode	string	Yes	Postal / ZIP code (max 20 chars)
countryCode	string	Yes	Country code (ISO 3166-1 alpha-3, 3 uppercase letters)

Financials object

Field	Type	Required	Description
monthlyTurnOver	string	Yes	Expected monthly turnover. See allowed values
estimatedTransactionValue	string	Yes	Estimated per-transaction value. See allowed values
sourceOfFunds	string	Yes	Primary source of business funds. See allowed values
purposeOfAccount	string	Yes	Intended use of the account. See allowed values

Example request

curl -X POST https://prod.rynopay.io/partner/v1/business-profiles \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "info@acmecorp.com",
    "phoneNumber": "+2348012345678",
    "companyName": "Acme Corporation Ltd",
    "tradingName": "Acme",
    "businessTypeCode": "LIMITED_LIABILITY",
    "incorporationCountryIso3Code": "NGA",
    "industry": "CustomerRevenue",
    "description": "Fintech solutions provider",
    "website": "https://acmecorp.com",
    "registrationNumber": "RC123456",
    "registrationDate": "2020-06-15",
    "addresses": [
      {
        "streetLine1": "12 Marina Road",
        "city": "Lagos",
        "state": "Lagos",
        "postalCode": "100001",
        "countryCode": "NGA"
      }
    ],
    "financials": {
      "monthlyTurnOver": "UpTo50k",
      "estimatedTransactionValue": "UpTo15k",
      "sourceOfFunds": "CustomerRevenue",
      "purposeOfAccount": "CustomerCollections"
    }
  }'

Response

200 OK

{
  "isSuccess": true,
  "value": {
    "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Field	Type	Description
customerId	string (UUID)	Unique identifier for the newly created business customer

400 Bad Request

{
  "isSuccess": false,
  "error": {
    "code": "Validation",
    "message": "One or more validation errors occurred"
  }
}

Enum reference

Business type codes

Value
SOLE_PROPRIETORSHIP
LIMITED_LIABILITY
PARTNERSHIP
CORPORATION
NON_PROFIT

Industry types

Value
CustomerRevenue
ShareholderCapital
BusinessLoans
Grants
Investments
AssetSales
CryptoProceeds
IntercompanyTransfers
Donations
MarketplaceFees
SubscriptionRevenue
TradingIncome

Monthly turnover

Value	Description
UpTo15k	Up to $15,000
UpTo50k	Up to $50,000
UpTo100k	Up to $100,000
UpTo500k	Up to $500,000
Above500k	Above $500,000

Estimated transaction value

Value	Description
UpTo5k	Up to $5,000
UpTo15k	Up to $15,000
UpTo50k	Up to $50,000
UpTo100k	Up to $100,000
Above100k	Above $100,000

Source of funds

Value
CustomerRevenue
ShareholderCapital
BusinessLoans
Grants
Investments
AssetSales
CryptoProceeds
IntercompanyTransfers
Donations
MarketplaceFees
SubscriptionRevenue
TradingIncome

Purpose of account

Value
CustomerCollections
Payroll
SupplierPayments
MarketplaceSettlements
EscrowHolding
SubscriptionBilling
CrossBorderTrade
FxSettlement
CryptoOnRamp
CryptoOffRamp
Donations
InvestmentHolding
AffiliatePayouts
MerchantPayouts
InternalTreasury