Transactions

Get transaction by reference

Retrieve a transaction by its reference with the TypeScript SDK.

GET/transactions/reference/{reference}

Use blnk.Transactions.getByReference to retrieve a transaction by reference.

Call the method

const response = await blnk.Transactions.getByReference(
  'ref_04551509-d7d3-4eab-a1fd-2eb12809b5a4',
);

Field	Type	Description
`reference`	`string`	Unique reference passed when the transaction was created.

Use the transaction details

Use the returned transaction ID when you need to refund, update inflight status, or inspect lineage.

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"
  }
}

Field	Type	Description
`transaction_id`	`string`	Unique ID for the transaction.
`reference`	`string`	Reference you queried.
`status`	`string`	Current status of the transaction.