Skip to main content

Documentation Index

Fetch the complete documentation index at: https://guide.cloud.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

This feature is in private beta. If you want access, please contact Support.
Your ledger may be the source of truth for financial records, but the work around it often happens somewhere else. Teams may need to check provider data, review customer records, calculate a result, approve an action, or flag something for investigation before a workflow is complete. Custom Apps help you bring those steps closer to the ledger, so your team can work from inside Cloud instead of switching between tools.

​
About Custom Apps

A Custom App is a third-party app that can be installed and used inside Blnk Cloud. It can read data from a selected Cloud instance, perform actions through Cloud APIs, connect to external systems, and show a custom interface inside the Cloud dashboard. For example, consider a KYC review workflow. Typically, this would involve managing data across Blnk identities, a KYC provider, internal spreadsheets, manual notes, etc. With a Custom App, that review flow can live inside Cloud, closer to the ledger.

​
Start with a clear workflow

Before writing code, define the workflow your app should support:
1

Describe your app in one sentence

The best Custom Apps are focused. They help a team complete one job inside Cloud instead of trying to become a large internal system.
A good mental model is to think of each Custom App as a feature of your Blnk Cloud workspace, instead of a complete app.
For our KYC app, its job is:
KYC app description
Help operations review customer identities and update their KYC status from inside Blnk Cloud.
2

Map your workflow

From there, map the work the app needs to handle. Here’s the workflow for our KYC app:
StepWhat the app needs to do
Read recordsFetch identities from the selected Cloud instance.
Run a checkSend identity details to a KYC provider or internal review service.
Save the resultWrite the KYC status back to the identity metadata.
Flag exceptionsCreate an alert when an identity needs manual review.
Show progressDisplay reviewed identities, statuses, and action logs inside the app portal.
This gives the app a clear boundary of what the workflow is responsible for and what should happen at each step.
Keep the workflow narrow. If the app starts covering unrelated jobs, you should consider splitting those jobs into separate apps.

Run the example KYC app

Open the demo repository and follow its README to run the KYC example app this documentation is built around.

​
Need help?

If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at support@blnkfinance.com or send us a message here.