Modify transactions

Learn how to update a previously initiated transaction.

A modification is the action of updating a transaction that has been initiated, but not fully processed yet.

The possible modifications are:

  • Capture: transfer authorised funds to your account and complete the transaction.
  • Refund: return funds to a customer from a purchase transaction.
  • Incremental authorisation: increase the authorised amount of a transaction. For example, if the price of goods has changed.
  • Void: cancel a transaction that has been authorised, but not captured.

To modify a transaction, you'll need to supply its associated systemTransactionIdas part of the URL path. If your request is successful, you'll receive a response containing a new systemTransactionId that can be used for tracking and reconciliation purposes. Depending on your modification, the transaction's state might change. For example, if you capture a transaction, "state": "Approved" will be updated to "state": "Captured".

ℹ️

You should always supply the first systemTransactionId that was returned for the authorisation or purchase that you're modifying. This ensures that the correct one is referenced for any subsequent operations.