Skip to main content
This guide walks you through installing the Blnk Python SDK, initializing the client, and creating your first transaction. By the end, you’ll have a working connection to Blnk and be ready to build financial products from your Python application.
1

Install the SDK

Install the SDK in your project. Requires Python 3.10 or later.
pip install blnk-python
For local development from source:
pip install .
2

Create a sample script

Create a main.py file as shown below to create your first transaction with the SDK.
Make sure you have a running Blnk Core instance. Set the URL and API key as environment variables in your project.
main.py
import json
import os

from blnk_sdk import BlnkClientOptions, blnk_init

blnk = blnk_init(
    os.environ.get("BLNK_API_KEY", ""),
    BlnkClientOptions(
        base_url=os.environ.get("BLNK_BASE_URL", "http://localhost:5001"),
    ),
)

response = blnk.transactions.create(
    {
        "precise_amount": 100000,
        "reference": "first_txn_001",
        "currency": "USD",
        "precision": 100,
        "source": "@FundingPool",
        "destination": "@MyBalance",
        "description": "My first Blnk transaction",
        "allow_overdraft": True,
    }
)

if response.status != 201 or not response.data:
    raise RuntimeError(response.message)

print(json.dumps(response.data, indent=2))
3

Execute the script

Run the file.
python main.py
You should get a response similar to:
201 Created
{
  "amount": 1000,
  "precision": 100,
  "precise_amount": 100000,
  "transaction_id": "txn_8d2ce2f0-0d75-4a91-9d43-2ad2c2e6b9ad",
  "parent_transaction": "",
  "source": "bln_f344b673-e855-4bda-b769-3e94a02c1941",
  "destination": "bln_d5cbde84-d20a-485b-8ce8-6677d782c3a1",
  "reference": "first_txn_001",
  "currency": "USD",
  "description": "My first Blnk transaction",
  "status": "QUEUED",
  "hash": "0b9c25fb5b00d6c71cb4ca87026bf6dc316e63353d3330deb588bd0b3d74dcc0",
  "allow_overdraft": true,
  "inflight": false,
  "created_at": "2024-11-26T09:33:35.265582042Z",
  "scheduled_for": "0001-01-01T00:00:00Z",
  "inflight_expiry_date": "0001-01-01T00:00:00Z",
  "inflight_commit_date": "0001-01-01T00:00:00Z"
}
4

View the transaction

Confirm the transaction landed in your ledger.
  1. Open Transactions in the sidebar.
  2. Find your transaction by reference (first_txn_001) or by the transaction_id from the script output.
  3. Click the row to open the details and verify the amount, status, source, and destination.
Blnk Cloud Transactions table with reference, amount, status, source, and destination columns
If the transaction is missing, click Refresh on the table to pull the latest data from Core.

Using the SDK

Authentication, timeouts, retries, and logging.

Error handling

ApiResponse checks and Core error bodies.

Changelog

Python SDK releases and version history.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.