Update an existing transaction_bundle by id

curl --request PATCH \
  --url https://incoming.qomon.app/v1/transaction_bundles/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "id": 123,
    "transactions": [
      {
        "id": 123,
        "amount": 123,
        "currency": "<string>",
        "payment_method_kind": "<string>",
        "payment_method": {},
        "contact_id": 123,
        "date": "2023-11-07T05:31:56Z",
        "code_campaign": "<string>",
        "delivered_at": "2023-11-07T05:31:56Z",
        "delivery_token": "<string>",
        "comment": "<string>",
        "comment_date": "2023-11-07T05:31:56Z",
        "reimbursed_amount": 123,
        "unpaid_amount": 123,
        "external_transaction_id": 123,
        "status_id": 123
      }
    ],
    "memberships": [
      {
        "id": 123,
        "contact_id": 123,
        "start_date": "2023-11-07T05:31:56Z",
        "end_date": "2023-11-07T05:31:56Z",
        "membership_price_id": 123,
        "amount": 123,
        "amount_initial": 123,
        "currency": "<string>",
        "comment": "<string>",
        "rolling_year": true
      }
    ],
    "donations": [
      {
        "id": 123,
        "contact_id": 123,
        "date": "2023-11-07T05:31:56Z",
        "amount": 123,
        "initial_amount": 123,
        "currency": "<string>",
        "donation_price_id": 123,
        "affectation": "<string>",
        "comment": "<string>"
      }
    ],
    "summary": {
      "transactions_count": 123,
      "memberships_count": 123,
      "donations_count": 123
    }
  }
}
'

{
  "status": "success",
  "data": {
    "id": 123,
    "transactions": [
      {
        "id": 123,
        "amount": 123,
        "currency": "<string>",
        "payment_method_kind": "<string>",
        "payment_method": {},
        "contact_id": 123,
        "date": "2023-11-07T05:31:56Z",
        "code_campaign": "<string>",
        "delivered_at": "2023-11-07T05:31:56Z",
        "delivery_token": "<string>",
        "comment": "<string>",
        "comment_date": "2023-11-07T05:31:56Z",
        "reimbursed_amount": 123,
        "unpaid_amount": 123,
        "external_transaction_id": 123,
        "status_id": 123
      }
    ],
    "memberships": [
      {
        "id": 123,
        "contact_id": 123,
        "start_date": "2023-11-07T05:31:56Z",
        "end_date": "2023-11-07T05:31:56Z",
        "membership_price_id": 123,
        "amount": 123,
        "amount_initial": 123,
        "currency": "<string>",
        "comment": "<string>",
        "rolling_year": true
      }
    ],
    "donations": [
      {
        "id": 123,
        "contact_id": 123,
        "date": "2023-11-07T05:31:56Z",
        "amount": 123,
        "initial_amount": 123,
        "currency": "<string>",
        "donation_price_id": 123,
        "affectation": "<string>",
        "comment": "<string>"
      }
    ],
    "summary": {
      "transactions_count": 123,
      "memberships_count": 123,
      "donations_count": 123
    }
  }
}

Transaction bundles

Update an existing transaction_bundle by id

Update an existing transaction bundle. Updates are additive for arrays — items not included in the request remain in the bundle unchanged.

Rules:

To update an existing transaction/membership/donation: include its id plus ALL its required fields (not just the changed ones — omitted required fields may be cleared)
To add a new item: omit id — a new item will be created and added to the bundle
Items not included in the request arrays are left unchanged
The bundle id in the path must match the id in the request body

Warning: Always send all required fields when updating an item, not just the fields you want to change. Missing required fields on an updated item may be reset to empty/zero values.

Refund workflow For a partial refund (e.g. 10€ back on a 20€ transaction):

Get the transaction id and membership/donation id from GET /v1/transaction_bundles/{id}
PATCH with the reimbursed status, reimbursed_amount, and the updated membership/donation amount:

{
  "id": "<bundle_id>",
  "data": {
    "transactions": [
      {
        "id": "<transaction_id>",
        "contact_id": 123456,
        "amount": 2000,
        "currency": "eur",
        "payment_method_kind": "CB",
        "date": "2026-03-29T12:59:52+02:00",
        "external_transaction_id": 1001,
        "status_id": 2,
        "reimbursed_amount": 1000
      }
    ],
    "memberships": [
      {
        "id": "<membership_id>",
        "contact_id": 123456,
        "membership_price_id": 10,
        "start_date": "2026-01-01T00:00:00Z",
        "end_date": "2026-12-31T00:00:00Z",
        "amount": 1000,
        "amount_initial": 2000,
        "currency": "eur"
      }
    ]
  }
}

Use GET /v1/transaction_statuses to find the id of the “Reimbursed” and “Cancelled” statuses for your group.

For a full refund or cancellation, the cleanest approach is:

DELETE /v1/transaction_bundles/{id} to remove the bundle
POST /v1/transaction_bundles to recreate it with the corrected data

Note: A PATCH does NOT change the bundle’s position in GET /v1/transaction_bundles list — it stays at its original creation date position.

PATCH

transaction_bundles

{id}

Update an existing transaction_bundle by id

curl --request PATCH \
  --url https://incoming.qomon.app/v1/transaction_bundles/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "id": 123,
    "transactions": [
      {
        "id": 123,
        "amount": 123,
        "currency": "<string>",
        "payment_method_kind": "<string>",
        "payment_method": {},
        "contact_id": 123,
        "date": "2023-11-07T05:31:56Z",
        "code_campaign": "<string>",
        "delivered_at": "2023-11-07T05:31:56Z",
        "delivery_token": "<string>",
        "comment": "<string>",
        "comment_date": "2023-11-07T05:31:56Z",
        "reimbursed_amount": 123,
        "unpaid_amount": 123,
        "external_transaction_id": 123,
        "status_id": 123
      }
    ],
    "memberships": [
      {
        "id": 123,
        "contact_id": 123,
        "start_date": "2023-11-07T05:31:56Z",
        "end_date": "2023-11-07T05:31:56Z",
        "membership_price_id": 123,
        "amount": 123,
        "amount_initial": 123,
        "currency": "<string>",
        "comment": "<string>",
        "rolling_year": true
      }
    ],
    "donations": [
      {
        "id": 123,
        "contact_id": 123,
        "date": "2023-11-07T05:31:56Z",
        "amount": 123,
        "initial_amount": 123,
        "currency": "<string>",
        "donation_price_id": 123,
        "affectation": "<string>",
        "comment": "<string>"
      }
    ],
    "summary": {
      "transactions_count": 123,
      "memberships_count": 123,
      "donations_count": 123
    }
  }
}
'

{
  "status": "success",
  "data": {
    "id": 123,
    "transactions": [
      {
        "id": 123,
        "amount": 123,
        "currency": "<string>",
        "payment_method_kind": "<string>",
        "payment_method": {},
        "contact_id": 123,
        "date": "2023-11-07T05:31:56Z",
        "code_campaign": "<string>",
        "delivered_at": "2023-11-07T05:31:56Z",
        "delivery_token": "<string>",
        "comment": "<string>",
        "comment_date": "2023-11-07T05:31:56Z",
        "reimbursed_amount": 123,
        "unpaid_amount": 123,
        "external_transaction_id": 123,
        "status_id": 123
      }
    ],
    "memberships": [
      {
        "id": 123,
        "contact_id": 123,
        "start_date": "2023-11-07T05:31:56Z",
        "end_date": "2023-11-07T05:31:56Z",
        "membership_price_id": 123,
        "amount": 123,
        "amount_initial": 123,
        "currency": "<string>",
        "comment": "<string>",
        "rolling_year": true
      }
    ],
    "donations": [
      {
        "id": 123,
        "contact_id": 123,
        "date": "2023-11-07T05:31:56Z",
        "amount": 123,
        "initial_amount": 123,
        "currency": "<string>",
        "donation_price_id": 123,
        "affectation": "<string>",
        "comment": "<string>"
      }
    ],
    "summary": {
      "transactions_count": 123,
      "memberships_count": 123,
      "donations_count": 123
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

integer

required

ID of transaction_bundle to update

Body

application/json

data

object

required

A transaction bundle groups together related financial operations (transactions, memberships, donations) that are part of a single payment event.

Structure:

transactions: Array of payment transactions (required - at least one)
memberships: Array of membership subscriptions (optional)
donations: Array of donation contributions (optional)
summary: Automatically calculated counts (read-only, returned in responses only)

When Creating:

Omit id field (auto-generated)
Omit summary (auto-calculated, returned in responses)
Include at least one transaction with required fields

When Updating:

Include id field matching the bundle ID in the URL
Include id for existing items you want to modify
Omit id for new items you want to add
Note: Updates are additive - items not included in the request remain in the bundle unchanged (they are not removed)

Show child attributes

Response

Successful operation

status

string

Example:

"success"

data

object

A transaction bundle groups together related financial operations (transactions, memberships, donations) that are part of a single payment event.

Structure:

transactions: Array of payment transactions (required - at least one)
memberships: Array of membership subscriptions (optional)
donations: Array of donation contributions (optional)
summary: Automatically calculated counts (read-only, returned in responses only)

When Creating:

Omit id field (auto-generated)
Omit summary (auto-calculated, returned in responses)
Include at least one transaction with required fields

When Updating:

Include id field matching the bundle ID in the URL
Include id for existing items you want to modify
Omit id for new items you want to add
Note: Updates are additive - items not included in the request remain in the bundle unchanged (they are not removed)

Show child attributes

Last modified on May 19, 2026

Delete a transaction bundle by id

Returns the history of the transaction bundle

Documentation Index

Authorizations

Path Parameters

Body

Response