Record a transaction
Post a transaction in your Blnk Ledger.
Authorization
Basic authentication header of the form — Basic <encoded-value>, where <encoded-value> is the base64-encoded string of your username:password.
Body
The transaction amount.
The currency of the transaction amount is in.
The unique transaction reference number for the transaction. If empty, Blnk auto-creates one.
The balance sending the amount. @ prefix indicates that the balance is an internal balance.
The balance receiving the amount. @ prefix indicates that the balance is an internal balance.
Narration of the transaction.
Indicates the date and time of a scheduled transaction.
Always format the date input as ‘YYYY-MM-DDTHH:MM:SS+00:00’ (e.g., 2024-04-22T15:28:03+00:00), where +00:00 specifies the timezone. It is UTC by default.
Specifies whether the transaction should proceed even if the source’s balance is insufficient. If enabled and the source has less than the required amount, the balance will become negative. See also: Overdrafts
Specifies that the transaction should be held until certain conditions are met. See also: Inflight transactions.
Specifies the date and time when an inflight transaction should expire. Once expired, the transaction is voided and the amount is rolled back.
Always format the date input as ‘YYYY-MM-DDTHH:MM:SS+00:00’ (e.g., 2024-04-22T15:28:03+00:00), where +00:00 specifies the timezone. It is UTC by default.
Defines the conversion rate to be applied when the transaction involves balances in different currencies. See also: Applying rates.
Additional metadata of the transaction.
Response
This is computed by amount x precision. Learn why this is important: Why use precision
Unique id of the transaction.
The transaction ID of the parent transaction. A parent transaction is one that impacts the creation of a new transaction, such as an inflight transaction, a scheduled transaction, or similar.
For instance, refunding a sample transaction A creates a new transaction B; therefore A is the parent transaction of B.
The status of the transaction. See the following: Transaction statuses.
SHA-256 hash of the transaction details. Learn more: Transaction hashing
Indicates the date & time the transaction was created.
Additional metadata of the transaction.
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.
Manage your Blnk Ledger and explore advanced features (access control & collaboration, anomaly detection, secure storage & file management, etc.) in one dashboard.
Was this page helpful?