Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Undo a Stored Value API transaction

Learn how to undo a previous transaction on a gift card or other stored-value card.

With a /voidTransaction call to our Stored Value API, you can undo transactions made with this API in the past 24 hours. The transaction to undo is identified by its pspReference. Transaction types you can undo are: issue, change status to active, load funds and merge balance. Undoing transactions is a synchronous operation.

You can't use the /voidTransaction call to cancel a payment.

Support

Web channel

Transaction Givex SVS ValueLink
Void (undo) other transaction -white_check_mark- -white_check_mark- -white_check_mark-

POS channel

Transaction Givex SVS ValueLink
Void (undo) other transaction -white_check_mark- -white_check_mark- -white_check_mark-

Undo a transaction

To undo a previous /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 https://pal-test.adyen.com/pal/servlet/StoredValue/v46/voidTransaction endpoint, specifying:

    • merchantAccount: ID of the merchant account that you want to process the transaction with.
    • store: Optional For transactions flagged as in-store, the ID of the physical store that you want to process the transaction for.
    • originalReference: The pspReference 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": "TestMerchant",
        "originalReference": "851564654294247B",
        "reference": "YOUR_REFERENCE"
    }    

Response

You receive a response containing:

  • currentBalance: The currency and total value 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 the Customer Area, you'll find these settings under Account > API URLs.

Sample response:

{
    "currentBalance": {
        "currency": "EUR",
        "value": 120000
    },
    "pspReference": "851564673300692A",
    "resultCode": "Success"
}

Related transactions

See also