Bit Capital

The Bit Capital Developer Hub

Welcome to the Bit Capital developer hub. You'll find comprehensive guides and documentation to help you start working with the platform as quickly as possible, as well as support if you get stuck. Let's jump right in!

Guides    Community

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.

Method

URL

Description

register

POST /provider/register

Registers a new wallet to the provider

unregister

POST /provider/unregister

Deletes an existing wallet from the provider

block

POST /provider/block

Blocks an existing wallet

unblock

POST /provider/unblock

Unblocks a wallet that was previously blocked

update

POST /provider/update

Updates informations about a certain wallet

isAccountNumberAvailable

POST /provider/accounts/availability-check

Checks if a account number is available for this provider

isApproved

GET /provider/:walletId/is-approved

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

status

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.

Feature

Description

audit

Features focused on gathering informations for audit reasons

block

Feature for blocking / unblocking user operations in the provider

branch

Feature related to branch management inside a provider

boleto_emission

Feature related to the boleto emission operation

boleto_payment

Feature related to the boleto payment operation

card

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

deposit

Feature related to deposit operations in the provider

document

Feature related to document operations in the provider

payment

Feature related to p2p transfers inside a provider

postback

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

withdraw

Feature related to handling the withdraw operation in a provider

phone_credits

Feature related to handling the phone credits purchases in a provider

legal

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

participating_institution

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

Updated 3 months ago



Custom Providers


Build your own connections to BT Core

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.