Bulk Commit & Void Inflight

Available in version 0.14.2 and later.

Use the bulk inflight endpoints to commit or void many independently-created inflight transactions in one request. For a single inflight transaction, use the Update inflight API instead. Important distinction: Bulk inflight updates are for multiple individual transactions. If you created inflight transactions through the Bulk transactions API, commit them using that batch’s batch_id via the single update endpoint, not the bulk inflight endpoints.

Bulk commit

To bulk commit in one request, use:

Bulk commit inflight

POST /transactions/inflight/bulk/commit

Each request accepts a maximum of 100 items in the transactions array.

Using the queue
Skipped queue

From Blnk Core 0.15.0, bulk commit and void go through the queue by default.

When using the queue, Blnk validates each inflight transaction and enqueues a commit job. The response returns immediately; the queued status means the job is queued, not committed. Parents stay INFLIGHT until workers create APPLIED children.Per item results:

Status	Code	Meaning
`queued`	`QUEUED`	New commit job added.
`queued`	`ALREADY_QUEUED`	Has already been queued; duplicate skipped.

Failures are per-item. One does not block the batch.

curl -X POST "http://YOUR_BLNK_INSTANCE_URL/transactions/inflight/bulk/commit" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "transactions": [
      {
        "transaction_id": "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94"
      },
      {
        "transaction_id": "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
        "precise_amount": 4000
      }
    ]
  }'

const response = await blnk.Transactions.bulkCommitInflight({
  transactions: [
    {
      transaction_id: 'txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94',
    },
    {
      transaction_id: 'txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30',
      precise_amount: 4000,
    },
  ],
});

result, resp, err := client.Transaction.BulkCommitInflight(blnkgo.BulkCommitInflightRequest{
    Transactions: []blnkgo.BulkCommitInflightItem{
        {
            TransactionID: "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
        },
        {
            TransactionID: "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
            PreciseAmount: big.NewInt(4000),
        },
    },
})

response = blnk.transactions.bulk_commit_inflight({
  "transactions": [
    {
      "transaction_id": "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
    },
    {
      "transaction_id": "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
      "precise_amount": 4000,
    },
  ],
})

ApiResponse<JsonNode> response = blnk.transactions().bulkCommitInflight(
    BulkCommitInflightRequest.create()
        .transactions(List.of(
            BulkCommitInflightItem.create()
            .transactionId("txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94"),
            BulkCommitInflightItem.create()
            .transactionId("txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30")
            .preciseAmount(4000)
        )));

200 Queued

{
  "succeeded": 2,
  "failed": 0,
  "results": [
    {
      "transaction_id": "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
      "status": "queued",
      "code": "QUEUED"
    },
    {
      "transaction_id": "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
      "status": "queued",
      "code": "ALREADY_QUEUED"
    }
  ]
}

The worker later creates APPLIED child records for each committed item. Verify outcomes with webhooks or polling - same as single commit and void.

Set skip_queue: true to process each item immediately. The response reflects the final outcome for each inflight transaction.Per item results:

Status	Code	Meaning
`succeeded`	-	Inflight committed in this response.
`failed`	`NOT_FOUND`	Transaction ID does not exist.
`failed`	`ALREADY_COMMITTED`	Inflight was already committed.
`failed`	`ALREADY_VOIDED`	Inflight was already voided.
`failed`	`NOT_INFLIGHT`	Transaction is not in `INFLIGHT` status.
`failed`	`INVALID_AMOUNT`	Partial commit amount exceeds the remaining inflight amount.
`failed`	`LOCKED`	Concurrent operation on the same transaction (for example duplicate IDs in one request).
`failed`	`INTERNAL_ERROR`	Unexpected server failure for this item.

Failures are per-item. One does not block the batch.

curl -X POST "http://YOUR_BLNK_INSTANCE_URL/transactions/inflight/bulk/commit" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "skip_queue": true,
    "transactions": [
      {
        "transaction_id": "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94"
      },
      {
        "transaction_id": "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
        "precise_amount": 4000
      }
    ]
  }'

const response = await blnk.Transactions.bulkCommitInflight({
  skip_queue: true,
  transactions: [
    {
      transaction_id: 'txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94',
    },
    {
      transaction_id: 'txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30',
      precise_amount: 4000,
    },
  ],
});

result, resp, err := client.Transaction.BulkCommitInflight(blnkgo.BulkCommitInflightRequest{
    SkipQueue: true,
    Transactions: []blnkgo.BulkCommitInflightItem{
        {
            TransactionID: "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
        },
        {
            TransactionID: "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
            PreciseAmount: big.NewInt(4000),
        },
    },
})

response = blnk.transactions.bulk_commit_inflight({
  "skip_queue": True,
  "transactions": [
    {
      "transaction_id": "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
    },
    {
      "transaction_id": "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
      "precise_amount": 4000,
    },
  ],
})

ApiResponse<JsonNode> response = blnk.transactions().bulkCommitInflight(
    BulkCommitInflightRequest.create()
        .skipQueue(true)
        .transactions(List.of(
            BulkCommitInflightItem.create()
            .transactionId("txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94"),
            BulkCommitInflightItem.create()
            .transactionId("txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30")
            .preciseAmount(4000)
        )));

200 Skipped queue

{
  "succeeded": 2,
  "failed": 0,
  "results": [
    {
      "transaction_id": "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
      "status": "succeeded"
    },
    {
      "transaction_id": "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
      "status": "succeeded"
    }
  ]
}

Bulk void

To bulk void in one request, use:

Bulk void inflight

POST /transactions/inflight/bulk/void

Bulk void expects a transaction_ids array, not the transactions shape used by bulk commit. Each request accepts a maximum of 100 IDs in the transaction_ids array.

Using the queue
Skipped queue

By default, Blnk uses the queue to process each item. The response returns immediately; the queued status means the job is queued, not committed. Parents stay INFLIGHT until workers create APPLIED children.Per item results:

Status	Code	Meaning
`queued`	`QUEUED`	New void job added.
`queued`	`ALREADY_QUEUED`	Has already been queued; duplicate skipped.

curl -X POST "http://YOUR_BLNK_INSTANCE_URL/transactions/inflight/bulk/void" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_ids": [
      "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
      "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30"
    ]
  }'

const response = await blnk.Transactions.bulkVoidInflight({
  transaction_ids: [
    'txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94',
    'txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30',
  ],
});

result, resp, err := client.Transaction.BulkVoidInflight(blnkgo.BulkVoidInflightRequest{
    TransactionIDs: []string{
        "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
        "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
    },
})

response = blnk.transactions.bulk_void_inflight({
  "transaction_ids": [
    "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
    "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
  ],
})

ApiResponse<JsonNode> response = blnk.transactions().bulkVoidInflight(
    BulkVoidInflightRequest.create()
        .transactionIds(List.of(
            "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
            "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30"
        )));

200 Queued

{
  "succeeded": 2,
  "failed": 0,
  "results": [
    {
      "transaction_id": "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
      "status": "queued",
      "code": "QUEUED"
    },
    {
      "transaction_id": "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
      "status": "queued",
      "code": "QUEUED"
    }
  ]
}

Set skip_queue: true to process each item immediately. The response reflects the final outcome for each inflight transaction.Bulk void expects a transaction_ids array (not the transactions shape used by bulk commit).Per item results:

Status	Code	Meaning
`succeeded`	-	Inflight voided in this response.
`failed`	`NOT_FOUND`	Transaction ID does not exist.
`failed`	`ALREADY_COMMITTED`	Inflight was already committed.
`failed`	`ALREADY_VOIDED`	Inflight was already voided.
`failed`	`NOT_INFLIGHT`	Transaction is not in `INFLIGHT` status.
`failed`	`LOCKED`	Concurrent operation on the same transaction (for example duplicate IDs in one request).
`failed`	`INTERNAL_ERROR`	Unexpected server failure for this item.

Failures are per-item. One does not block the batch.

curl -X POST "http://YOUR_BLNK_INSTANCE_URL/transactions/inflight/bulk/void" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "skip_queue": true,
    "transaction_ids": [
      "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
      "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30"
    ]
  }'

const response = await blnk.Transactions.bulkVoidInflight({
  skip_queue: true,
  transaction_ids: [
    'txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94',
    'txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30',
  ],
});

result, resp, err := client.Transaction.BulkVoidInflight(blnkgo.BulkVoidInflightRequest{
    SkipQueue: true,
    TransactionIDs: []string{
        "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
        "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
    },
})

response = blnk.transactions.bulk_void_inflight({
  "skip_queue": True,
  "transaction_ids": [
    "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
    "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
  ],
})

ApiResponse<JsonNode> response = blnk.transactions().bulkVoidInflight(
    BulkVoidInflightRequest.create()
        .skipQueue(true)
        .transactionIds(List.of(
            "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
            "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30"
        )));

200 Skipped queue

{
  "succeeded": 2,
  "failed": 0,
  "results": [
    {
      "transaction_id": "txn_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
      "status": "succeeded"
    },
    {
      "transaction_id": "txn_c5d9e2a1-7b4f-4a3c-9e8d-1f6a2b4c8d30",
      "status": "succeeded"
    }
  ]
}

Error handling

Structured errors are available from Blnk Core 0.15.0 and later.

Bulk inflight endpoints return 400 when the request body fails validation before processing starts. Per-item failures return 200 with failed entries in results[]; one failed item does not block the batch.

Request validation
Per-item results

Code	When it happens
`TXN_BULK_EMPTY`	`transactions` or `transaction_ids` is missing, empty, or the wrong shape for the endpoint.
`TXN_BULK_LIMIT_EXCEEDED`	More than 100 items in one bulk commit or void request.

Bulk commit expects a transactions array. Bulk void expects transaction_ids. Sending the wrong shape returns TXN_BULK_EMPTY because unrecognized fields are dropped.

400 Bad Request

{
  "error_detail": {
    "code": "TXN_BULK_EMPTY",
    "message": "transactions array is required and cannot be empty"
  },
  "errors": "transactions array is required and cannot be empty"
}

To resolve the error:

Code	What to do
`TXN_BULK_EMPTY`	Add at least one item. Use `transactions` for bulk commit and `transaction_ids` for bulk void.
`TXN_BULK_LIMIT_EXCEEDED`	Split the request into batches of 100 or fewer items.

On the default queued path, ALREADY_QUEUED counts toward succeeded (idempotent success, not a new queue job). On the skipped-queue path, per-item failed codes such as NOT_FOUND, ALREADY_COMMITTED, ALREADY_VOIDED, NOT_INFLIGHT, and INVALID_AMOUNT are listed in the tabs above.

Single inflight commit and void errors like TXN_COMMIT_AMOUNT_EXCEEDED apply when you use Update inflight instead of these bulk endpoints. See Commit & void inflight - Error handling and API error codes.

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.

Start Here

Ledgers

Ledger balances

Transactions

Reconciliation

Identities

Metadata

Search

Webhooks

API keys

Guides

Configuration

Advanced

Migration guides

Bulk commit

Bulk void

Error handling

Need help?

​Bulk commit

​Bulk void

​Error handling

​Need help?

Bulk commit

Bulk void

Error handling

Need help?