Transactions

Get transaction by reference

Retrieve a transaction by its reference with the Go SDK.

GET/transactions/reference/{reference}

Use client.Transaction.GetByReference to retrieve a transaction by reference.

Call the method

transaction, _, _ := client.Transaction.GetByReference(
	"ref_04551509-d7d3-4eab-a1fd-2eb12809b5a4",
)
FieldTypeDescription
referencestringUnique reference passed when the transaction was created.

Response

{
  "precise_amount": 300,
  "amount": 3,
  "precision": 100,
  "transaction_id": "txn_93c3f6dc-9c2c-46b0-89c5-1814cef4d0e4",
  "parent_transaction": "",
  "source": "bln_845bbf20-cc0c-41d2-810b-24f104f1cb8b",
  "destination": "bln_e92a1ba7-92c7-427c-8c8f-bfdca55c875d",
  "reference": "ref_04551509-d7d3-4eab-a1fd-2eb12809b5a4",
  "currency": "BTC",
  "description": "test",
  "status": "APPLIED",
  "hash": "0b9c25fb5b00d6c71cb4ca87026bf6dc316e63353d3330deb588bd0b3d74dcc0",
  "allow_overdraft": false,
  "inflight": false,
  "created_at": "2025-02-08T13:36:42.748594Z",
  "meta_data": {
    "customer_id": "12345",
    "payment_method": "card"
  }
}

Go response (*blnkgo.Transaction)

FieldTypeDescription
TransactionIDstringUnique ID for the transaction.
ReferencestringReference you queried.
Statusblnkgo.
PryTransactionStatus
Current status of the transaction.
PreciseAmount*big.IntAmount in minor units.
Amountfloat64Float amount after precision is applied.
CurrencystringCurrency of the transaction.
SourcestringSource balance.
DestinationstringDestination balance.
CreatedAttime.TimeDate and time the transaction was created.
MetaDataMetaDataOptional metadata object.