less than a minute read • Updated 4 days ago
Editing, Voiding, Refunding Transactions
Please note that this feature is in private beta, and is only available for certain gateways. Please contact us at help@foxycart.com if you're interested in this feature.
Transaction editing is a store-level feature. Your store needs the allow_transaction_editing flag enabled (set via the API or API Browser) and it only works with certain payment gateways. Square supports it; PayPal does not. If you don't see the options below on a transaction, this flag may not be enabled for your store, or your gateway may not support it.
From a transaction's details, you can edit items, void the transaction, or issue a refund or capture. Some details can't be edited on the transaction: customer ID, email address, credit card number and expiration (editable on the customer record, not the transaction), transaction ID, and custom fields on the transaction.
Steps to edit an item
Price and Line item discount cover most partial-refund scenarios directly, so there's no need to apply a coupon to an existing transaction.
Once an item is edited, the transaction details show a Refundable amount separate from the order Total, with a note explaining that the refundable amount differs from the total because the transaction has been modified.
Void a transaction
Refund or capture a transaction
After editing an item, the same action button at the top of the transaction shows Refund or Capture, depending on whether your edit lowered or raised the amount owed.
Webhooks
A transaction webhook fires a transaction/modified event when you edit a transaction. It also fires when a transaction is refunded or voided, when a subscription is cancelled, or when an amount is captured.
To set one up:
Notes
Charging more after a transaction usually isn't supported, because of how authorization and capture work. An authorization holds an amount on the card; the capture takes the actual amount, and you can't capture more than you authorized. Most orders authorize and capture the same amount at once.
If you edit a transaction and increase the order amount, the Capture action lets you charge the difference, but only up to what was originally authorized. If your business regularly needs to charge more than that, contact Foxy support to discuss options.
Transaction editing support varies by gateway. If customers report they can't edit a transaction, check the payment method used before assuming the feature flag is the issue.