Givex - Gift cards

Givex provides gift cards used by retailers for their shoppers. Adyen allows you to process Givex as a payment method, giving your customers more flexibility.

The structure of the payment and the endpoints remain the same. 

Use the number field to enter the gift card number.

You can choose to ask your shopper for the PIN while making the payment. Use the cvc field to enter the gift card PIN.

If you choose to ask for PIN for gift cards then you should set the requirement per acquirer account. It must then be used for all the transactions.

For more info on fields, see Givex.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soap:Body>
      <ns1:authorise xmlns:ns1="http://payment.services.adyen.com">
         <ns1:paymentRequest>
            <amount xmlns="http://payment.services.adyen.com">
               <currency xmlns="http://common.services.adyen.com">GBP</currency>
               <value xmlns="http://common.services.adyen.com">0</value>
            </amount>
            <billingAddress xmlns="http://payment.services.adyen.com" xsi:nil="true" />
            <card xmlns="http://payment.services.adyen.com">
               <billingAddress xsi:nil="true" />
               <cvc>1234</cvc>
               <expiryMonth>12</expiryMonth>
               <expiryYear>2018</expiryYear>
               <holderName>John Smith</holderName>
               <issueNumber xsi:nil="true" />
               <number>6036283997595793321</number>
               <startMonth xsi:nil="true" />
               <startYear xsi:nil="true" />
            </card>
            <deliveryDate xmlns="http://payment.services.adyen.com">2017-04-13T02:00:00+02:00</deliveryDate>
            <merchantAccount xmlns="http://payment.services.adyen.com">TestMerchant</merchantAccount>
            <merchantOrderReference xmlns="http://payment.services.adyen.com" xsi:nil="true" />
            <selectedBrand xmlns="http://payment.services.adyen.com">givex</selectedBrand>
            <sessionId xmlns="http://payment.services.adyen.com">P0f1FeojPyAzWPUarSFZ1G3BJ0I=</sessionId>
            <shopperEmail xmlns="http://payment.services.adyen.com" xsi:nil="true" />
            <shopperIP xmlns="http://payment.services.adyen.com">80.113.16.26</shopperIP>
            <shopperLocale xmlns="http://payment.services.adyen.com">en_GB</shopperLocale>
         </ns1:paymentRequest>
      </ns1:authorise>
   </soap:Body>
</soap:Envelope>

If you suspect the card is lost/stolen, you can make a zero-value auth call adding the additionalData object to deactivate the card.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance">
   <soap:Body>
      <ns1:authorise xmlns:ns1="http://payment.services.adyen.com">
         <ns1:paymentRequest>
            <amount xmlns="http://payment.services.adyen.com">
               <currency xmlns="http://common.services.adyen.com">EUR</currency>
               <value xmlns="http://common.services.adyen.com">0</value>
            </amount>
            <card xmlns="http://payment.services.adyen.com">
               <cvc>1234</cvc>
               <expiryMonth>12</expiryMonth>
               <expiryYear>2018</expiryYear>
               <holderName>John Smith</holderName>
               <number>6036283997595793321</number>
            </card>
            <additionalData xmlns="http://payment.services.adyen.com">
               <entry>
                  <key xsi:type="xsd:string">stored_value_redemption_type</key>
                  <value xsi:type="xsd:string">deactivate</value>
               </entry>
            </additionalData>
            <merchantAccount xmlns="http://payment.services.adyen.com">TestMerchant</merchantAccount>
            <reference xmlns="http://payment.services.adyen.com">Your Reference Here</reference>
            <shopperEmail xmlns="http://payment.services.adyen.com">s.hopper@test.com</shopperEmail>
            <shopperReference xmlns="http://payment.services.adyen.com">Simon Hopper</shopperReference>
         </ns1:paymentRequest>
      </ns1:authorise>
   </soap:Body>
</soap:Envelope>