Skip to main content

Documentation Index

Fetch the complete documentation index at: https://doc.raliopay.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Creating a Business User — Field Values Reference

When you create a business user (POST /api/v1/account/business-user), several fields only accept a constrained set of values. This guide explains where each value comes from so your request doesn’t get rejected with a validation error. There are two kinds of constrained fields:
  • Fixed enums — a closed list defined by the API. The valid values are shown in the request schema of the Create business user endpoint, and listed here for convenience.
  • Dynamic catalogs — values that live in a reference endpoint you must query first. You cannot hardcode these; always fetch the current list.

​
Fixed enums

These values are part of the API contract. Send them exactly as written (uppercase, underscore-separated).

​
company.incorporation.constitutionType

The legal structure of the company.
ValueDescription
INDIVIDUALIndividual / Sole Proprietor
CORPORATIONCorporation / Inc.
LLCLimited Liability Company (LLC / Ltd.)
PARTNERSHIPGeneral Partnership
LIMITED_PARTNERSHIPLimited Partnership (LP)
SOLE_PROPRIETORSHIPSole Proprietorship
COOPERATIVECooperative
NON_PROFITNon-Profit Organization / NGO
GOVERNMENTGovernment Entity
TRUSTTrust
FINANCIAL_INSTITUTIONRegulated Financial Institution / Bank
FOUNDATIONFoundation / Charitable Organization
OTHEROther — describe it in constitutionTypeOther
Important: When you send OTHER, also fill constitutionTypeOther with a free-text description.

​
businessActivity.industryType

Value
WHOLESALE
RETAIL
CRYPTO_FINTECH
ECOMMERCE
EDUCATION
ENTERTAINMENT
GOVERNMENT
HOSPITALITY
MANUFACTURING
PAYMENTS_REMITTANCE
FINANCIAL_SERVICES
PROFESSIONAL_SERVICES
HEALTHCARE
TRANSPORT_LOGISTICS
REAL_ESTATE
NON_PROFIT
OTHER
Important: When you send OTHER, also fill industryTypeOther with a free-text description.

​
businessActivity.expectedMonthlyVolume

ValueRange
LESS_THAN_50KUnder 50,000
50K_TO_250K50,000 – 250,000
250K_TO_500K250,000 – 500,000
500K_TO_1M500,000 – 1,000,000
MORE_THAN_1MOver 1,000,000

​
Dynamic catalogs

​
Country fields — ISO 3166-1 alpha-2

Every country field — company.incorporation.country, company.addresses.registered.country, company.addresses.operational.country, company.contact.phoneNumberCountry, company.contact.mobileCountryCode, and any country inside businessActivity.fundsFlow — expects a 2-letter ISO 3166-1 alpha-2 code (e.g. ES, US, FR). To get the list of countries Ralio supports, query: 
GET /api/v1/reference/countries
See List countries.

​
Free-text fields

The following fields are not enums — they accept free text and have no catalog to query:
  • businessActivity.businessNature
  • businessActivity.revenueModel
  • businessActivity.productsAndServices
Note: Percentages in businessActivity.revenueBreakdown and in businessActivity.fundsFlow (inwards/outwards) must each sum to 100.