Skip to main content

​
KYB Session Process Guide

What is KYB?
KYB (Know Your Business) is the business identity verification process that a Business User must complete in order to reach the REGULAR KYB level. This level is a prerequisite for creating an operational account on the Ralio platform.

​
Prerequisites

Before starting the KYB process, make sure you have the following:
  • A valid API Key with access to the management endpoints.
  • The Business User already created on the platform. Use the endpoint below if you haven’t done so yet: 
    POST /api/v1/account/business-user
    Once created, you will receive the uid (unique identifier of the Business User). This uid is required in all subsequent steps.
  • The business documentation ready to upload (at minimum, all mandatory documents).

​
Step 1 — Create a KYB Session

Using the Business User’s uid, the next step is to create a KYB Session. This session acts as the container where all documents uploaded during the verification process will be associated. Endpoint: 
POST /api/v1/account/business-user/{uid}/kyb-sessions
Path parameters:
ParameterTypeDescription
uidstringBusiness User ID
Successful response (201): The API returns the created session object, which includes:
FieldTypeDescription
idstringKYB Session ID — save this value
kybIdintegerKYB ID associated with the Business User
documentsarrayList of documents (initially empty)
createdAtstringCreation date and time
updatedAtstringLast update date and time
⚠️ Important: Save the id field from the response. This is the sessionId you will need in the following steps.

​
Step 2 — Upload documentation

Using the sessionId obtained in the previous step, proceed to upload all required documents. Each document is uploaded individually through the upload endpoint. Endpoint: 
POST /api/v1/account/business-user/{uid}/kyb-sessions/{sessionId}/documents
Path parameters:
ParameterTypeDescription
uidstringBusiness User ID
sessionIdstringKYB Session ID
Body (multipart/form-data):
FieldTypeRequiredDescription
categorystringYesDocument category. Value: COMPANY_INFO
typestringYesDocument type. E.g.: MEMORANDUM_ARTICLES, BUSINESS_NUMBER, etc.
filefileYesThe document file

​
Document category

Documenttype valueMandatory
Memorandum and Articles of AssociationMEMORANDUM_ARTICLESYes
Business NumberBUSINESS_NUMBERYes
Proof of Company Address (utility bill, bank statement, etc.)PROOF_OF_ADDRESSYes
Certificate of Directors and Shareholders RegisterDIRECTORS_SHAREHOLDERS_REGYes
Recent Financial Statements (balance sheets, audited financial statements if available)FINANCIAL_STATEMENTSNo
Business Licenses & PermitsLICENSES_PERMITSNo
Any other relevant documents (contracts, audit reports, etc.)OTHERNo

​
File restrictions:

Maximun size: 10MB
Accepted formats: PDF (.pdf), Excel (.xlsx, .xls), Word (.docx, .doc), Images (.jpg, .jpeg, .png)

​
Document considerations

  • All mandatory documents must be uploaded before the session can be submitted for review.
  • Additional (optional) documents can also be uploaded up until the moment of submission.
  • You can delete an already-uploaded document using the delete endpoint, but only before submitting the session for review.
  • You can list the documents uploaded to the session at any time.
Document management endpoints:
ActionMethodEndpoint
List documentsGET/api/v1/account/business-user/{uid}/kyb-sessions/{sessionId}/documents
Delete documentDELETE/api/v1/account/business-user/{uid}/kyb-sessions/{sessionId}/documents/{documentId}

​
Step 3 — Submit the session for review

Once all mandatory documents have been uploaded, the next step is to submit the KYB Session to the Compliance team for review. This action is irreversible. Endpoint: 
POST /api/v1/account/business-user/{uid}/kyb-sessions/{sessionId}/submit
Path parameters:
ParameterTypeDescription
uidstringBusiness User ID
sessionIdstringKYB Session ID
🚫 From this point on:
  • No more documents can be uploaded to the session.
  • No uploaded documents can be deleted.
  • The session will transition to the IN REVIEW state.

​
Step 4 — Compliance team review

Once submitted, the KYB Session enters the IN REVIEW state and is handled internally by Ralio’s Onboarding Compliance team. During this phase:
  • The Compliance team reviews all submitted documentation.
  • Related Parties are declared (individuals linked to the business, such as partners, directors, beneficial owners, etc.).
  • A KYC Session is generated for each Related Party, so they can complete their own individual identity verification process.
  • If necessary, the Compliance team may request additional information or documentation.

​
Where can you track the process status?

This information is visible in two places within the Portal:
  1. Inside the Business User profile — detailed view of the business entity.
  2. Onboarding Business section — global view of the onboarding process.
The Related Parties declared by the Compliance team must complete their KYC (Know Your Customer) process, i.e., individual identity verification. This process runs in parallel with the KYB review and is managed through the corresponding KYC Sessions.
ℹ️ The KYC process for Related Parties is a requirement for the KYB Session to be approved.

​
Step 6 — Approval and REGULAR level activation

Once the review process has been successfully completed:
  • The KYB Session is approved by the Compliance team.
  • The Business User’s KYB level changes from LIGHT → REGULAR.
  • The Merchant is notified via a webhook with the corresponding KYB level change event.
💡 Make sure your webhook endpoint is properly configured to receive this notification. You can check the Webhooks Events section in the documentation.

​
Step 7 — Account creation

With the KYB at REGULAR level, the Merchant can proceed with the creation of the operational account for the Business User on the Ralio platform.