Gift Card Auth Reversal Transactions

The Gift Card Auth Reversal transaction allows you to reverse an authorization against a closed-loop gift card; thereby, removing the funds hold established by the authorization.

Gift Card Auth Reversal Request

You must specify the Gift Card Auth Reversal request as follows. The structure of the request is identical for either an Online or a Batch submission.

<giftCardAuthReversal id="Id" reportGroup="iQ Report Group" customerId="Customer Id">

  <cnpTxnId>Transaction Id from Auth Response</cnpTxnId>

  <card>

  <originalRefCode>Auth Code from Auth Response</originalRefCode>

  <originalAmount>Amount from Auth Response</originalAmount>

  <originalTxnTime>txnTime from Auth Response</originalTxnTime>

  <originalSystemTraceId>systemTraceId from Auth Rsp</originalSystemTraceId>

  <originalSequenceNumber>sequenceNumber from Auth Rsp</originalSequenceNumber>

</giftCardAuthReversal>

Example: Online Gift Card Auth Reversal

<cnpOnlineRequest version="12.0" xmlns="http://www.vantivcnp.com/schema" merchantId="100">

  <authentication>

    <user>User Name</user>

    <password>Password</password>

  </authentication>

  <giftCardAuthReversal id="834262" reportGroup="ABC Division" customerId="038945">

    <cnpTxnId>82823534116454002</cnpTxnId>

    <card>

      <type>GC</type>

      <number>9000000000000001</number>

      <PIN>1234</PIN>

    </card>

    <originalRefCode>123456</originalRefCode>

    <originalAmount>40000</originalAmount>

    <originalTxnTime>2016-07-25T15:13:43</originalTxnTime>

    <originalSystemTraceId>654321</originalSystemTraceId>

    <originalSequenceNumber>456789</originalSequenceNumber>

  </giftCardAuthReversal>

</cnpOnlineRequest>

Gift Card Auth Reversal Response

A Gift Card Auth Reversal response has the following structure. The response message is identical for Online and Batch transactions except Online includes the <postDate> element.

<giftCardAuthReversalResponse id="Load Id" reportGroup="iQ Report Group" customerId="Customer Id">

  <cnpTxnId>Transaction Id</cnpTxnId>

  <response>Response Code</response>

  <responseTime>Date and Time in GMT</responseTime>

  <postDate>Date transaction posted</postDate> (Online Only)

  <message>Response Message</message>

  <location>Processing Location</location>

  <giftCardResponse>

</giftCardAuthReversalResponse>

Example:

<cnpOnlineResponse version="12.0" xmlns="http://www.vantivcnp.com/schema" response="0" message="Valid Format">

  <giftCardAuthReversalResponse id="834262" reportGroup="ABC Division">

  <cnpTxnId>84568456</cnpTxnId>

  <response>000</response>

  <responseTime>2020-03-25T15:13:37</responseTime>

  <postDate>2020-03-25</postDate> (Online Only)

  <message>Approved</message>

  <location>Processing Location</location>

    <giftCardResponse>

      <txnTime>2020-03-25T15:13:38</txnTime>

      <refCode>123456</refCode>

      <systemTraceId>123456</systemTraceId>

      <sequenceNumber>123456</sequenceNumber>

      <availableBalance>5000</availableBalance>

    </giftCardResponse>

  </giftCardAuthReversalResponse>

</cnpOnlineResponse>