Sign in
Transactions

Updates a transaction (tags, allocations, or both)

patch/transactions/{transaction_ref}

Path parameters

transaction_refstring required

Transaction reference. Accepts either an encoded Fragment ID (txn_xxx) or an external ID.

Example:txn_abc123

Request body

current_transaction_versioninteger required

Current transaction version for optimistic concurrency control.

Example request

{
  "tags": {
    "update": [
      {
        "key": "region",
        "value": "eu-west-1"
      }
    ]
  },
  "allocations": {
    "create": [
      {
        "invoice_id": "inv_abc123",
        "amount": "1000",
        "type": "invoice_payin",
        "user": {
          "id": "user_abc123"
        }
      }
    ],
    "update": [
      {
        "id": "alloc_abc123",
        "amount": "2000"
      }
    ]
  }
}

Response

Success

Example response

{
  "data": {
    "id": "txn_dHhuX2ZyYWdfMDAx",
    "external_id": "bank_txn_123",
    "account": {
      "id": "ext_account_YWJjMTIz",
      "external_id": "acct_external_123"
    },
    "posted": "2026-02-12T00:00:00.000Z",
    "currency": "USD",
    "amount": "-1000",
    "allocations": [
      {
        "invoice_id": "inv_abc123",
        "amount": "1000",
        "type": "invoice_payin",
        "user": {
          "id": "user_abc123",
          "external_id": "user-ext-001"
        }
      }
    ],
    "tags": [
      {
        "key": "region",
        "value": "us-east"
      }
    ],
    "unallocated_amount": "-1000",
    "created": "2026-02-12T00:00:00.000Z",
    "modified": "2026-02-12T01:00:00.000Z",
    "version": 1
  }
}

Changes