Skip to main content

Business profiles

A business profile is a business (KYB) customer you onboard under your partner account, together with its beneficial owners, directors and shareholders.

The flow​

Create the profile

Create business profile with the business people in businessPersonList and its transaction profile in financials (required). The customer is queued for compliance review straight away.

Upload documents

Request an upload link with purpose set to BusinessDocument for each document in Get document requirements, then PUT the file to the returned URL. Identity documents for the business's people are not uploaded through the API.

Confirm the documents

Send the document ids in businessDocumentIdList on Update business profile.

Get the decision

Listen for the customer.onboarding.* webhooks, or poll Get verification status.

Endpoints​

Key ideas​

  • Your id and ours. You send partnerCustomerId, your own reference. ryno returns customerId. Every other route takes customerId, except lookup by reference.
  • Safe retries. Create is idempotent on partnerCustomerId, and every write is all-or-nothing.
  • Editable until review. You can update a profile until an analyst starts reviewing it (InReview), and again from ChangesRequested until the analyst picks the case back up. Otherwise an update returns 409 Customer.AlreadySubmitted. See Statuses.

Shared response and error formats are on the API introduction.