Update Business Profile

Update an existing business profile and progress to the next onboarding stage.

Endpoint

PUT https://prod.rynopay.io/partner/v1/business-profiles/{businessProfileId}

Path parameters

Parameter	Type	Description
businessProfileId	UUID	The business customer ID returned from Create Business Profile

Request body

Field	Type	Required	Description
customerId	string (UUID)	Yes	Must match the businessProfileId path parameter
businessEmail	string	Yes	Business email address (max 255 chars)
phoneNumber	string	Yes	International phone number (E.164 format)
name	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)
industry	string	Yes	Business industry (max 100 chars)
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 100 chars)
registrationDate	string	No	Date of registration (YYYY-MM-DD)
addresses	array	No	List of Address objects
financials	object	No	Financial information

info

The customerId in the request body must match the businessProfileId in the URL path. A mismatch returns a 400 Bad Request with error code Partner.BusinessProfileIdMismatch.

Example request

curl -X PUT https://prod.rynopay.io/partner/v1/business-profiles/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "businessEmail": "info@acmecorp.com",
    "phoneNumber": "+2348012345678",
    "name": "Acme Corporation Ltd",
    "tradingName": "Acme Pay",
    "businessTypeCode": "LIMITED_LIABILITY",
    "incorporationCountryIso3Code": "NGA",
    "industry": "CustomerRevenue",
    "description": "Fintech solutions provider for SMEs",
    "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": "UpTo100k",
      "estimatedTransactionValue": "UpTo50k",
      "sourceOfFunds": "CustomerRevenue",
      "purposeOfAccount": "MerchantPayouts"
    }
  }'

Response

200 OK

{
  "isSuccess": true
}

400 Bad Request

{
  "isSuccess": false,
  "error": {
    "code": "Partner.BusinessProfileIdMismatch",
    "message": "Route businessProfileId must match request.CustomerId"
  }
}