Account activation

Rootline Accounts are fundamental to enabling you and your merchants to receive payments. Each user can have one or multiple accounts, providing flexibility in payment processing and fund management. This documentation outlines the core concepts, and will be extended over time.

To find the accounts that have been created for you and your users, navigate to the Accounts overview page in the Rootline dashboard. Each account comes with an account_id that can be provided in the Payment API to manage your payments appropriately.

Activating accounts

If it is the first time that your user is getting an Account, they will have to be onboarded with Rootline. As soon as your user has submitted the Rootline Hosted Onboarding form, you will receive a webhook that onboarding has started. To receive those webhooks you listen to the company.created (if the legal entity is company or) person.created (if the legal entity is a person) webhook.

Here's an example of a company.created event:

{
    "object": "event",
    "webhook_endpoint_id": "webh_4WxqjT0YfsxXDeKPbrwRie",
    "event_type": "company.created",
    "event_time": "2024-12-24T14:18:11.435566Z",  
    "livemode": false,
    "api_version": "2024-04-23",
    "company": {
        "id": "co_5IGIrh15JJZ5oKSYubFpEr",
        "object": "company",
        "name": "TraderJoes",
        "company_name": "Trader Joe's",
        "created_at": "2024-12-24T14:18:11.422Z",
        "reference": "myRefForUser1"
    }
}

Next, when Rootline completes the onboarding process of your user, an account will be created, after Rootline sends an account.created webhook if you have subscribed to the event.

info

A risk-based onboarding process may apply for your platform, in which case your user might not be required to provide all details from the start, depending on your user's risk profile.

Here's an example of an account.created webhook:

{
    "object": "event",
    "webhook_endpoint_id": "webh_59rz4zUN69BvGY8cpo7lqn",
    "event_type": "account.created",
    "event_time": "2024-12-24T14:21:34.914319Z",  
    "livemode": false,
    "api_version": "2024-04-23",
    "account": {
        "id": "acc_47fm2EUbd8ndPcMu5ULmcA",
        "object": "account",
        "description": "Trader Joe's account",
        "name": "simplythetest",
        "legal_entity_id": "co_5IGIrh15JJZ5oKSYubFpEr",
        "base_return_url": "https://www.tradingjoes.com",
        "created_at": "2024-12-24T14:21:34.881Z",
        "reference": "myRefForUser1"
    }
}

Now you're all set to start sending payments to this account.

Configuring webhooks

To configure webhook events, please read our documentation about webhooks.