Skip to main content
This guide walks you through installing the Blnk Go 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 Go application.
1

Install the SDK

Create a Go project and install the SDK. v1.2.0 and later require Go 1.22 or later.
2

Client initialization

Parse your Blnk base URL and create a client. Pass a pointer to your API key when your instance requires authentication. The SDK sends it as the X-Blnk-Key header.Use nil when running locally without auth.
client.go
3

Create a sample script

Create a main.go 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 when your instance requires authentication.
main.go
4

Execute the script

Run the file.
You should get a response similar to this:
201 Created
5

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

The Transactions table shows every transaction synced from your Core instance.

If the transaction is missing, click Refresh on the table to pull the latest data from Core.

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.