GuidesAPI ReferenceCommunity
GuidesCommunityLog In

Custom Providers

Build your own connections to BT Core


Experimental API

This feature is still in the experimental phase. It is only supported in SaaS and may change with time. For enabling the permissions for your credentials, ask us in our help desk.

We love Open Banking, it's the main purpose of Bit Capital and for that we created a way to customize even more your BT Core with your own providers. In this section we describe in details how it works and the theory behind it.
We recommend reading the Assets and Wallets , Platform Assets and Custom Assets before.

Structure of an Asset Provider

A provider is basically a micro-service that follows the Bit Capital Provider API Contracts for communicating with the Core API. It is divides in the features and methods to allow different providers to have different operations that it controls.

Another important property of a provider is that it needs to be associated with an asset on the platform, it should be a Custom Assets.

Operation Flow

When you are using your instance of BT Core, whenever you want to execute a operation you usually send an asset for that operation (or it's implicit that it is the root asset). When you make this request, behind the curtains the Core API makes a request to a specific URL in the provider associated with the asset you specified.

After that, the provider answers the Core API and you get your operation executed in most cases. When you're using your own custom providers, expect that the Core API will make a request to you everytime someone asks for a given operation in your asset.

Provider Methods

These are the required methods for a provider to work, they mostly reside on the wallet registration cycle.





POST /provider/register

Registers a new wallet to the provider


POST /provider/unregister

Deletes an existing wallet from the provider


POST /provider/block

Blocks an existing wallet


POST /provider/unblock

Unblocks a wallet that was previously blocked


POST /provider/update

Updates informations about a certain wallet


POST /provider/accounts/availability-check

Checks if a account number is available for this provider


GET /provider/:walletId/is-approved

Checks if a certain wallet is approved in the provider KYC.


GET /status

Health check between the Core API and the provider.

Provider Features

Features are the possible types of operations a provider that can have, a provider can have multiple features and every feature has it's set of required methods in it.




Features focused on gathering informations for audit reasons


Feature for blocking / unblocking user operations in the provider


Feature related to branch management inside a provider


Feature related to the boleto emission operation


Feature related to the boleto payment operation


Feature related to card operations, more info in Provider Card Feature


Feature related to deposit operations in the provider


Feature related to document operations in the provider


Feature related to p2p transfers inside a provider


Feature related to handling postbacks that came outside the platform to this provider using the BT Core Hooks


Feature related to handling the withdraw operation in a provider


Feature related to handling the phone credits purchases in a provider


Feature related to the cycle of accepting legal terms inside a provider


Feature related to providing a list of participating institutions for this specific provider

Did this page help you?