How To Activate A Stolen Gift Card

Activate or deactivate a gift carte

Change the status of a gift card or other stored-value carte.

The /changeStatus endpoint of our Stored Value API lets you lot activate or deactivate a gift card or other stored-value card and optionally load funds to it while activating.

Actuate

Irresolute the condition 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 outcome them.
You can activate plastic cards with or without specifying an amount that you want to load to the menu. If you don't add an amount now, you tin exercise so afterward with a /load asking. Some providers load funds to the card when it is issued. When yous actuate such a preloaded card, you lot either do not specify an amount, or exactly specify the preloaded amount.

Deactivate

Irresolute the status to inactive is something you'd practise when you suspect fraud, for example when the souvenir bill of fare is lost or stolen. This is an end state, a deactivated bill of fare can't exist used over again. Any value remaining on the carte du jour is no longer available to the shopper.

Transactions per provider and channel

Activate a card

To activate a gift card or other stored-value card:

• Make a Post request to the /changeStatus endpoint 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: Proper noun of the merchant account that you want to procedure the transaction with.

  • store: Optional Only applicable to in-person payments. For transactions flagged equally in-shop, the ID of the physical store that you desire to process the transaction for. Maximum length: xvi characters.

  • paymentMethod object with:

    • type: Name or brand of the card. Accustomed values: givex, svs, valuelink, any Intersolve-supported card type.
    • number: Bill of fare number that identifies the card that yous want to activate.
    • securityCode: If the card has a PIN code or other blazon 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 carte.

    • holderName: Optional Proper noun of the shopper that the bill of fare 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 x USD to the card:

                {     "status": "active",     "amount": {         "currency": "USD",         "value": 1000     },     "merchantAccount": "YOUR_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'southward sixteen-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 for other values that you can receive.

The response may include boosted fields, depending on the Additional data settings for your merchant account. In your Customer Area, y'all'll find these settings nether Developers > Additional information settings.

Sample response:

          {     "currentBalance": {         "currency": "USD",         "value": 1000     },     "pspReference": "851564652149588K",     "resultCode": "Success" }        

Deactivate a carte du jour

When y'all deactivate a gift card or other stored-value card, the way to specify the card details depends on whether you lot tokenized a payment that the shopper fabricated with this carte du jour.

To deactivate a gift carte du jour or other stored-value card that has non been tokenized:

• Brand a Post request to the changeStatus endpoint endpoint, specifying:

  • condition: inactive

  • merchantAccount: Name of the merchant account that you desire to process the transaction with.

  • store: Optional For transactions flagged as in-store, the ID of the physical store that you lot want to process the transaction for. Maximum length: 16 characters.

  • paymentMethod object with:

    • type: Proper name or brand of the card. Accepted values: givex, svs, valuelink.
    • number: Carte du jour number that identifies the carte.
    • securityCode: If the carte du jour has a PIN code or other type of security code, obtain it from the shopper and provide it here.
    • expiryMonth: Optional Expiry calendar month of the card.
    • expiryYear: Optional Expiry yr of the card.

    • holderName: Optional Proper name of the shopper that the card belongs to.

  • reference: Your reference to uniquely place the transaction. To provide multiple references for a transaction, split up them with hyphens ("-"). Maximum length: lxxx characters.

  This request deactivates a tokenized Givex gift card:

                    {     "condition": "inactive",     "merchantAccount": "YOUR_MERCHANT_ACCOUNT",     "shop":"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 full value of the funds stored on the card. Any value remaining on the card is no longer bachelor to the shopper.
• pspReference: Adyen's sixteen-graphic symbol 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 for other values that you lot can receive.

The response may include additional fields, depending on the Boosted data settings for your merchant account. In your Client Surface area, you'll observe these settings under Developers > Additional information settings.

To conciliate a gift carte or other stored-value card that has been tokenized:

• Make a Mail service asking to the changeStatus endpoint, specifying:

  • status: inactive
  • merchantAccount: Name of the merchant account that yous want to procedure the transaction with.
  • store: Optional For transactions flagged as in-store, the ID of the physical shop that you want to process the transaction for. Maximum length: 16 characters.
  • paymentMethod.blazon: Proper noun or make 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 bill of fare.
  • shopperReference: Your unique ID for this shopper. This is the shopperReference that yous used when y'all 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-shop terminal).
  • reference: Your reference to uniquely identify the transaction. To provide multiple references for a transaction, carve up them with hyphens ("-"). Maximum length: fourscore characters.

  This request deactivates a tokenized Givex gift carte:

                    {     "status": "inactive",     "merchantAccount": "YOUR_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 bill of fare. Any value remaining on the card is no longer available to the shopper.
• pspReference: Adyen's xvi-grapheme unique reference associated with the request.
• resultCode: Indicates the state of the asking. Success ways the status change has been carried out. Refer to Effect codes for other values that yous can receive.

The response may include boosted fields, depending on the Boosted data settings for your merchant account. In your Customer Area, you'll find these settings nether Developers > Additional data settings.

Next steps

Meet also

• Effect a new gift carte
• Transfer the value from i gift menu to some other
• Undo a previous Stored Value API transaction from the concluding 24 hours
• Stored Value API

Source: https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/change-status

Share this post