Financial Data Platform | Modernbanc

Your first transaction

A quick introduction to building with Modernbanc. In this example, we will create a basic transaction between two accounts.

1
Getting your API keys

Lets get Modernbanc up and running by testing out our API. You can get API keys by signing up on the platform. Once registered, you can create a workspace. Here you will choose a name and a workspace identifier that will be used in API calls. You can learn more at workspaces.

Once in your workspace, you can create an API key. Select the dropdown menu in the top left or press G, then select Settings or press S. Now, select API keys or press A. Click the Create button and you are now ready to copy your API key to get started.

If you get stuck at any point in the Quickstart, help is just a click away! Join our Slack channel or send us a message to [email protected].

Environment

testTesting, experiment without live users.
liveLive environment to use with real customers.
2
Creating your first accounts

Accounts are the core of Modernbanc's accounting system. They are used to store balances and to keep track of anything measured in units (currency, tickets, materials, etc).

In order to store balances in the account, we need to specify what unit, or currency, the account will use. We can do this by attaching units to the account during the creation process.

  • Naviate to the Accounts tab in the settings dropdown or press G and then A.
  • Click the Create button in the upper right corner.
  • Fill out the form with the following values:
    • Name: Quickstart - Account A.
    • Unit: United States dollar.
  • Click Create on the bottom right of the form.
  • Repeat the above steps to create Quickstart - Account B.
  • Note: take note of the Account identifier on the left side of the list view for each account. You will need it in the next step. In this case ACT-43 and ACT-44.
3
Creating your first transaction

Now that we have our two accounts, we can create a transaction between them. We will create a transaction from Account A to Account B.

Note: amount format must match the unit mode and precision. If the unit mode is floats, and the precision is 2, the format should look like 100.00. You can read more about how units work here.

  • Navigate to the Transactions tab in the settings dropdown or press G and then T.
  • Click the Create button in the upper right corner.
  • Fill out the form and click Create.
    • Enter a sample amount, like 200, in the Amount field.
    • In the From and To fields, select the accounts you created in the previous step. You can search by name, in this case just type quickstart and they will show up.
  • You should now see the transaction appear at the top of the transactions list.

Done!

Congratulations! You have created your first transaction in Modernbanc.

Next up: Workflows: Send Slack notification on transaction creation