--- title: "Activate or deactivate a gift card" description: "Change the status of a gift card or other stored-value card." url: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/change-status" source_url: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/change-status.md" canonical: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/change-status" last_modified: "2020-11-17T14:40:00+01:00" language: "en" --- # Activate or deactivate a gift card Change the status of a gift card or other stored-value card. [View source](/payment-methods/gift-cards/stored-value-api/change-status.md) The `/changeStatus` endpoint of our [Stored Value API](/payment-methods/gift-cards/stored-value-api) lets you activate or deactivate a gift card or other stored-value card and optionally load funds to it while activating. ### Activate Changing the status to **active** makes the funds stored on the card available to the shopper.\ There's no need to activate virtual cards: they are activated automatically when you issue them.\ You can activate plastic cards with or without specifying an amount that you want to load to the card. If you do not add an amount now, you can do so later with a [`/load` ](/payment-methods/gift-cards/stored-value-api/load)request. Some providers load funds to the card when it is issued. When you activate such a preloaded card, you either do not specify an amount, or exactly specify the preloaded amount. ### Deactivate Changing the status to **inactive** is something you'd do when you suspect fraud, for example when the gift card is lost or stolen. This is an end state, a deactivated card cannot be used again. Any value remaining on the card is no longer available to the shopper. ### Transactions per provider and channel #### Online | Transaction | Givex | SVS | Fiserv (formerly ValueLink) | Intersolve | | --------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- | | Activate | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | | Activate and load amount | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | | Deactivate (without amount) | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | #### In-person payments | Transaction | Givex | SVS | Fiserv (formerly ValueLink) | Intersolve | | --------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Activate | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Activate and load amount | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | | Deactivate (without amount) | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ![-x-](/user/data/smileys/emoji/x.png "-x-") | ## Activate a card To activate a gift card or other stored-value card: * Make a POST request to the [`/changeStatus` endpoint](/payment-methods/gift-cards/stored-value-api#sv-api-endpoints) endpoint, specifying: * `status`: **active** * `amount`: Optional The `currency` and `value` of the funds you want to load to the card. The supported currencies differ per provider.\ When activating a preloaded card, do not specify an amount or exactly specify the preloaded amount. * `merchantAccount`: Name of the merchant account that you want to process the transaction with. * `store`: Optional Only applicable to in-person payments. For transactions flagged as in-store, the ID of the physical store that you want to process the transaction for. Maximum length: 16 characters. * `paymentMethod` object with: * `type`: Name or brand of the card. Accepted values: **givex**, **svs**, **valuelink**, **[any Intersolve-supported card type](/payment-methods/gift-cards#supported-gift-cards)**. * `number`: Card number that identifies the card that you want to activate. * `securityCode`: If the card has a PIN code or other type of security code, obtain it from the shopper and provide it here. * `expiryMonth`: Optional Expiry month of the card. * `expiryYear`: Optional Expiry year of the card. * `holderName`: Optional Name of the shopper that the card belongs to. * `reference`: Your reference to uniquely identify the transaction. To provide multiple references for a transaction, separate them with hyphens ("-"). Maximum length: 80 characters. This request activates an SVS gift card and loads USD 10 to the card: ```json { "status": "active", "amount": { "currency": "USD", "value": 1000 }, "merchantAccount": "ADYEN_MERCHANT_ACCOUNT", "store":"YOUR_STORE_ID", "paymentMethod": { "type": "svs", "number": "6006491286999921374", "securityCode": "1111" }, "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. **Success** means the status change has been carried out. Refer to [Result codes](/payment-methods/gift-cards/stored-value-api#result-codes) for other 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](https://ca-test.adyen.com/), you'll find these settings under **Developers** > **Additional data**. Sample response: ```json { "currentBalance": { "currency": "USD", "value": 1000 }, "pspReference": "851564652149588K", "resultCode": "Success" } ``` ## Deactivate a card When you deactivate a gift card or other stored-value card, the way to specify the card details depends on whether you [tokenized](/online-payments/tokenization) a payment that the shopper made with this card. ### Tab: Without token To deactivate a gift card or other stored-value card that has not been tokenized: * Make a POST request to the [`changeStatus` endpoint](/payment-methods/gift-cards/stored-value-api#sv-api-endpoints) endpoint, specifying: * `status`: **inactive** * `merchantAccount`: Name 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. Maximum length: 16 characters. * `paymentMethod` object with: * `type`: Name or brand of the card. Accepted values: **givex**, **svs**, **valuelink**. * `number`: Card number that identifies the card. * `securityCode`: If the card has a PIN code or other type of security code, obtain it from the shopper and provide it here. * `expiryMonth`: Optional Expiry month of the card. * `expiryYear`: Optional Expiry year of the card. * `holderName`: Optional Name of the shopper that the card belongs to. * `reference`: Your reference to uniquely identify the transaction. To provide multiple references for a transaction, separate them with hyphens ("-"). Maximum length: 80 characters. This request deactivates a Givex gift card using the card number and no PIN: ```json { "status": "inactive", "merchantAccount": "ADYEN_MERCHANT_ACCOUNT", "store":"YOUR_STORE_ID", "paymentMethod": { "type": "givex", "number": "6036280000000000000" }, "shopperInteraction": "Ecommerce", "reference": "YOUR_REFERENCE" } ``` #### Response You receive a response containing: * `currentBalance`: The `currency` and total `value` of the funds stored on the card. Any value remaining on the card is no longer available to the shopper. * `pspReference`: Adyen's 16-character unique reference associated with the request. * `resultCode`: Indicates the state of the request. **Success** means the status change has been carried out. Refer to [Result codes](/payment-methods/gift-cards/stored-value-api#result-codes) for other 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](https://ca-test.adyen.com/), you'll find these settings under **Developers** > **Additional data**. ### Tab: With token To deactivate a gift card or other stored-value card that has been tokenized: * Make a POST request to the [`changeStatus` endpoint](/payment-methods/gift-cards/stored-value-api#sv-api-endpoints), specifying: * `status`: **inactive** * `merchantAccount`: Name 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. Maximum length: 16 characters. * `paymentMethod.type`: Name or brand of the card. Accepted values: **givex**, **svs**, **valuelink**. * `recurringDetailReference`: The token that identifies the card. This was returned in the response when you tokenized the card. * `shopperReference`: Your unique ID for this shopper. This is the `shopperReference` that you used when you created the token. * `shopperInteraction`: Specifies the sales channel through which the shopper provided their details. Accepted values: **Ecommerce** (default for online transactions), **ContAuth** (online, using previously stored details), **Moto** (via email or telephone) or **POS** (using an in-store terminal). * `reference`: Your reference to uniquely identify the transaction. To provide multiple references for a transaction, separate them with hyphens ("-"). Maximum length: 80 characters. This request deactivates a tokenized Givex gift card: ```json { "status": "inactive", "merchantAccount": "ADYEN_MERCHANT_ACCOUNT", "store":"YOUR_STORE_ID", "paymentMethod": { "type": "givex" }, "recurringDetailReference": "7219627091701347", "shopperReference": "YOUR_UNIQUE_SHOPPER_ID_P3fW3k9D2tvXFu6l", "shopperInteraction": "Ecommerce", "reference": "YOUR_REFERENCE" } ``` #### Response You receive a response containing: * `currentBalance`: The `currency` and total `value` of the funds stored on the card. Any value remaining on the card is no longer available to the shopper. * `pspReference`: Adyen's 16-character unique reference associated with the request. * `resultCode`: Indicates the state of the request. **Success** means the status change has been carried out. Refer to [Result codes](/payment-methods/gift-cards/stored-value-api#result-codes) for other 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](https://ca-test.adyen.com/), you'll find these settings under **Developers** > **Additional data**. ## Next steps ###### [Load](/payment-methods/gift-cards/stored-value-api/load) [Add funds to a gift card.](/payment-methods/gift-cards/stored-value-api/load) ###### [Check balance](/payment-methods/gift-cards/stored-value-api/check-balance) [Check the value stored on a gift card.](/payment-methods/gift-cards/stored-value-api/check-balance) ## See also * [Issue a new gift card](/payment-methods/gift-cards/stored-value-api/issue) * [Transfer the value from one gift card to another](/payment-methods/gift-cards/stored-value-api/merge-balance) * [Undo a previous Stored Value API transaction from the last 24 hours](/payment-methods/gift-cards/stored-value-api/void) * [Stored Value API](/payment-methods/gift-cards/stored-value-api)