Skip to main content
POST
/
transactions
Record Transaction
curl --request POST \
  --url http://localhost:5001/transactions \
  --header 'Content-Type: application/json' \
  --header 'X-blnk-key: <api-key>' \
  --data '
{
  "amount": 74000,
  "reference": "reference",
  "sources": [
    {
      "identifier": "bln_f2073f6b-905a-4e3e-b5a2-8d1b3dc2fb7f",
      "distribution": "10%",
      "narration": "Monthly contribution"
    },
    {
      "identifier": "bln_64c50fb5-32d5-4f78-9f4a-e8b01aaf025d",
      "distribution": "20000",
      "narration": "Monthly contribution"
    },
    {
      "identifier": "bln_7d98dfe9-5c3e-4c9b-b96a-65f6d9f7b89b",
      "distribution": "left",
      "narration": "Monthly contribution"
    }
  ],
  "destinations": [
    {
      "identifier": "bln_f2073f6b-905a-4e3e-b5a2-8d1b3dc2fb7f",
      "distribution": "20%",
      "narration": "For groceries"
    },
    {
      "identifier": "bln_64c50fb5-32d5-4f78-9f4a-e8b01aaf025d",
      "distribution": "10000",
      "narration": "For electricity bills"
    },
    {
      "identifier": "bln_7d98dfe9-5c3e-4c9b-b96a-65f6d9f7b89b",
      "distribution": "left",
      "narration": "For savings"
    }
  ],
  "currency": "NGN",
  "source": "@inflighttest6",
  "destination": "@inflighttest7",
  "allow_over_draft": true,
  "inflight": true
}
'
{
  "amount": 74000,
  "id": "txn_d0440bb5-e2c2-4937-bb4c-e91b50b7df22",
  "allow_overdraft": true,
  "infligt": true,
  "source": "@inflighttest6",
  "destination": "@inflighttest7",
  "reference": "reference",
  "currency": "NGN",
  "description": "",
  "status": "INFLIGHT",
  "hash": "89ba8954cd8e9215feed757be7cebe0a3ec9440be22139a5ba6a0499a52f4593",
  "group_ids": null,
  "created_at": "0001-01-01T00:00:00Z",
  "scheduled_for": "0001-01-01T00:00:00Z",
  "inflight_expiry_date": "0001-01-01T00:00:00Z",
  "inflight_commit_date": "0001-01-01T00:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-blnk-key
string
header
required

Body

application/json
​
amount
integer<int32>
required
​
reference
string
required
​
sources
Source · object[]
required
​
destinations
Destination · object[]
required
​
currency
string
required
​
source
string
required
​
destination
string
required
​
allow_over_draft
boolean
required
​
inflight
boolean
required
​
inflight_expiry_date
string

RFC3339 datetime with offset (e.g. 2024-04-22T15:28:03+00:00). When inflight is true, the transaction is voided after this time.

​
inflight_commit_date
string

RFC3339 datetime with offset. When inflight is true, Blnk automatically commits at this time. See /transactions/inflight docs.

Response

201 - application/json; charset=utf-8

Created

​
amount
integer<int32>
required
​
id
string
required
​
allow_overdraft
boolean
required
​
infligt
boolean
required
​
source
string
required
​
destination
string
required
​
reference
string
required
​
currency
string
required
​
description
string
required
​
status
string
required
​
hash
string
required
​
group_ids
string | null
required
​
created_at
string
required
​
scheduled_for
string
required
​
inflight_expiry_date
string

RFC3339 datetime with offset when unset shown as zero time.

​
inflight_commit_date
string

RFC3339 datetime with offset when unset shown as zero time; automatic commit when inflight.