A registered user is a persisted User entity created via UI registration or API provisioning. Registration can occur through:
- Hosted UI registration flows.
- API-driven account creation (Create User Account API).
- SSO authentication (external identity provisioning).
All newly registered accounts are assigned the Consumer (Buyer) role by default.
Role Transitions
To enable selling capabilities, the account must be upgraded using the Upgrade User Role API, converting the role from Consumer to Merchant. Administrative privileges may similarly be assigned through role updates.
Role Upgrade via UI
Within the hosted marketplace environment, role transitions are handled through user interactions:
- Guest to Registered Buyer: via 'Register / Sign In' action.
- Guest or Buyer to Merchant: via 'Be A Seller' action.
- Any user to Sub-Admin: via Admin Portal invitation and User Group assignment.
Role Upgrade via API
|
|
For programmatic onboarding or external provisioning, role assignment uses two APIs:
|
| Note: Ensure the role upgrade step completes before granting the user access to Merchant Portal features. The two-step flow enables automated onboarding, B2B user provisioning, and integration with external identity systems. |