The /voidTransaction
endpoint of our Stored Value API lets you undo transactions made with this API in the past 24 hours. Refer to Transaction per provider and channel to see what transactions you can and cannot undo. Undoing transactions is a synchronous operation.
Not for cancellations or refunds
Because /voidTransaction
is not related to a payment, you cannot use it to cancel a gift card payment or to make a refund to a gift card. Refer to:
Transaction | Link | |
---|---|---|
Cancel a gift card payment | Online | in-person payments |
Make a refund to a gift card | Online | in-person payments |
Transaction per provider and channel
Online
Transaction to void (undo) | Givex | SVS | Fiserv (formerly ValueLink) | Intersolve |
---|---|---|---|---|
Issue new | ||||
Activate | ||||
Activate and load amount | ||||
Deactivate (without amount) | ||||
Load amount | ||||
Merge balance |
In-person payments
Transaction to void (undo) | Givex | SVS | Fiserv (formerly ValueLink) | Intersolve |
---|---|---|---|---|
Issue new | ||||
Activate | ||||
Activate and load amount | ||||
Deactivate (without amount) | ||||
Load amount | ||||
Merge balance |
Undo a transaction
To undo an /issue
, /changeStatus
, /load
, or /mergeBalance
transaction made in the past 24 hours for a gift card or other stored-value card:
-
Make a POST request to the
/voidTransaction
endpoint, specifying:merchantAccount
: ID of the merchant account that you want to process the transaction with.store
:For transactions flagged as in-store, the ID of the physical store that you want to process the transaction for.OptionaloriginalReference
: ThepspReference
of the Stored Value API transaction that you want to undo.-
reference
: Your reference to uniquely identify this transaction. To provide multiple references for a transaction, separate them with hyphens ("-"). Maximum length: 80 characters.
Sample request:
{ "merchantAccount": "ADYEN_MERCHANT_ACCOUNT", "originalReference": "851564654294247B", "reference": "YOUR_REFERENCE" }
Response
You receive a response containing:
currentBalance
: Thecurrency
and totalvalue
of the funds stored on the card.pspReference
: Adyen's 16-character unique reference associated with the request.resultCode
: Indicates the state of the request. Refer to Result codes for the values that you can receive.
The response may include additional fields, depending on the additional data settings for your merchant account. In your Customer Area, you'll find these settings under Developers > Additional data.
Sample response:
{ "currentBalance": { "currency": "EUR", "value": 120000 }, "pspReference": "851564673300692A", "resultCode": "Success" }