Skip to main content
POST
/
transactions
/
inflight
/
bulk
/
void
curl -X POST "http://localhost:5001/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",
      "txn_7c91e4b2-3d8a-4f6e-b1c2-9a8d7e6f5b4a"
    ]
  }'

{
  "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",
      "message": "a commit or void is already queued for this transaction"
    }
  ]
}
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: Scoped API keys and Secure your Blnk server.
Available in version 0.14.2 and later.

​
Body

​
transaction_ids
string[]
required
Unique ids of the independently-created inflight transactions to void. Max number of transaction IDs allowed is 100.
​
skip_queue
boolean
default:"false"
When false (default), each item is enqueued for asynchronous processing. Per-item results return status: "queued" with code QUEUED or ALREADY_QUEUED, and both codes count toward succeeded. When true, Blnk processes each item synchronously and returns status: "succeeded" or "failed". See Commit & void inflight.

​
Response

​
succeeded
integer
required
Number of transactions voided or queued successfully. Items with QUEUED or ALREADY_QUEUED count here.
​
failed
integer
required
Number of transactions that failed.
​
results
object[]
required
Per-transaction result in the same order as the request.
curl -X POST "http://localhost:5001/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",
      "txn_7c91e4b2-3d8a-4f6e-b1c2-9a8d7e6f5b4a"
    ]
  }'

{
  "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",
      "message": "a commit or void is already queued for this 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.