Skip to main content
Yuno provides a suite of B2B Organization Management APIs designed for platforms and whitelabel partners who need to manage multiple sub-organizations and their users. These APIs allow you to automate your merchants’ onboarding by creating a hierarchical structure of Account Groups, Accounts, and Users.
Prerequisites To use these APIs, your organization must have the whitelabel property enabled in the Yuno Dashboard. Contact your Yuno account manager to enable this feature.

​
Core Management Flow

Follow these steps to set up a new merchant environment.
1

Create an Account Group

The account group acts as the parent entity for your merchant, centralizing the management of related accounts. Use the Create Account Group endpoint to initialize this group.
curl --request POST \
  --url https://api-sandbox.y.uno/v1/organizations/account-groups \
  --header 'PRIVATE-SECRET-KEY: <YOUR_PRIVATE_SECRET_KEY>' \
  --header 'PUBLIC-API-KEY: <YOUR_PUBLIC_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Acme Payments",
    "merchant_id": "acme_001"
  }'
Output & Next Steps: The response will include a unique id for the Account Group. Store this ID, as you will need it to create specific merchant accounts in the next step.
2

Create an Account

Within the newly created account group, you can create one or more accounts. This structure allows you to separate business logic, regions, or business lines for the same merchant. Use the Create Account endpoint.
curl --request POST \
  --url https://api-sandbox.y.uno/v1/organizations/account-groups/{account_group_id}/accounts \
  --header 'PRIVATE-SECRET-KEY: <YOUR_PRIVATE_SECRET_KEY>' \
  --header 'PUBLIC-API-KEY: <YOUR_PUBLIC_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Acme Production"
  }'
Output & Next Steps: You will receive an id for the merchant account. This ID is used to scope payments, sessions, and configurations specifically to this merchant environment.
3

Create a User and Assign Permissions

Finally, create a physical user and grant them access to the account or the entire account group. Assigning roles (like merchant-admin) ensures the user has the necessary permissions to manage the merchant dashboard. Use the Create User endpoint.
curl --request POST \
  --url https://api-sandbox.y.uno/v1/organizations/users \
  --header 'PRIVATE-SECRET-KEY: <YOUR_PRIVATE_SECRET_KEY>' \
  --header 'PUBLIC-API-KEY: <YOUR_PUBLIC_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "admin@acmepay.com",
    "first_name": "John",
    "last_name": "Doe",
    "account_group_permissions": [
      {
        "account_group_id": "{account_group_id}",
        "role_id": "merchant-admin"
      }
    ]
  }'
Output & Next Steps: The user will be created in the system. To allow them to log in to your whitelabel portal, use the Authenticate Whitelabel User endpoint to generate a secure access token.

​
Environment Availability

The B2B Organization Management APIs are available in both Sandbox and Production environments. For more information on how to manage your API keys and base URLs, visit the Environments page.

​
Next Steps

Explore the full API reference for more advanced management options: