Skip to main content
POST
/
transactions
/
inflight
/
bulk
/
commit
curl --request POST \
  --url http://localhost:5001/transactions/inflight/bulk/commit \
  --header 'X-blnk-key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "transactions": [
      {
        "transaction_id": "txn_11111111-1111-4111-8111-111111111111"
      },
      {
        "transaction_id": "txn_22222222-2222-4222-8222-222222222222",
        "amount": 40
      },
      {
        "transaction_id": "txn_33333333-3333-4333-8333-333333333333",
        "precise_amount": 125034
      }
    ]
  }'

{
  "succeeded": 2,
  "failed": 1,
  "results": [
    {
      "transaction_id": "txn_11111111-1111-4111-8111-111111111111",
      "status": "succeeded"
    },
    {
      "transaction_id": "txn_22222222-2222-4222-8222-222222222222",
      "status": "succeeded"
    },
    {
      "transaction_id": "txn_33333333-3333-4333-8333-333333333333",
      "status": "failed",
      "code": "INVALID_AMOUNT",
      "message": "cannot commit more than inflight amount"
    }
  ]
}
If you’re using the auto-provisioned Enterprise Core instance included with your Production License deployment, set the base URL to: https://ENTERPRISE_PUBLIC_URL/core.If you’re connecting to a different Core instance, use the publicly accessible base URL for that instance instead.

​
Authorization

If set, the API uses an API key for authentication. Include the following header in your requests: X-blnk-key: <api-key>. Replace <api-key> with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code. See also: Secure your Blnk server
Available in version 0.14.2 and later.

​
Body

​
transactions
object[]
required
Inflight transactions to commit. The request accepts up to 100 items.
​
transaction_id
string
required
The unique id of the independently-created inflight transaction.
​
amount
float
Optional amount to commit for a partial commit. When omitted or zero, Blnk commits the full remaining inflight amount.
​
precise_amount
integer
Optional precision-applied amount for a partial commit. When set, precise_amount takes precedence over amount.

​
Response

​
succeeded
integer
required
Number of transactions committed successfully.
​
failed
integer
required
Number of transactions that failed.
​
results
object[]
required
Per-transaction result in the same order as the request.
​
transaction_id
string
required
Transaction id from the request item.
​
status
string
required
succeeded or failed.
​
code
string
Stable failure code, such as NOT_FOUND, ALREADY_VOIDED, ALREADY_COMMITTED, NOT_INFLIGHT, INVALID_AMOUNT, LOCKED, or INTERNAL_ERROR.
​
message
string
Human-readable failure message.
curl --request POST \
  --url http://localhost:5001/transactions/inflight/bulk/commit \
  --header 'X-blnk-key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "transactions": [
      {
        "transaction_id": "txn_11111111-1111-4111-8111-111111111111"
      },
      {
        "transaction_id": "txn_22222222-2222-4222-8222-222222222222",
        "amount": 40
      },
      {
        "transaction_id": "txn_33333333-3333-4333-8333-333333333333",
        "precise_amount": 125034
      }
    ]
  }'

{
  "succeeded": 2,
  "failed": 1,
  "results": [
    {
      "transaction_id": "txn_11111111-1111-4111-8111-111111111111",
      "status": "succeeded"
    },
    {
      "transaction_id": "txn_22222222-2222-4222-8222-222222222222",
      "status": "succeeded"
    },
    {
      "transaction_id": "txn_33333333-3333-4333-8333-333333333333",
      "status": "failed",
      "code": "INVALID_AMOUNT",
      "message": "cannot commit more than inflight amount"
    }
  ]
}

​
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.