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 at Rootline they will first have to be onboarded. 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",
"reference": "my-ref-of-user1",
"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"
}
}
Next, when Rootline completes the onboarding process of your user, an account will be created. From this moment it is ready to be used. When Rootline creates the account, your system will be informed if you have subscribed to the account.created webhook:
{
"object": "event",
"webhook_endpoint_id": "webh_59rz4zUN69BvGY8cpo7lqn",
"event_type": "account.created",
"event_time": "2024-12-24T14:21:34.914319Z",
"reference": "my-ref-of-user1",
"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"
}
}
Now you're all set to start sending payments to this account.
Configuring webhooks
To configure webhook events, please read our documentation about webhooks.