Credit Request for a Non-Worldpay Processed Transaction

You must specify the Credit request for a Non-Worldpay processed transaction as follows. The structure of the request is identical for either an Online or a Batch submission.

Although the schema shows <paypal> as an optional element for a Credit against a non-Worldpay processed transaction, refunds of this type are not supported for PayPal. If you need to refund non-Worldpay processed transactions and have not maintained a temporary relationship with your former processor for this purpose, please ask your Relationship Manager for alternative options.

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

  <orderId>Order Id</orderId>

  <amount>Authorization Amount</amount>

  <secondaryAmount>Secondary Amount</secondaryAmount>

<surchargeAmount>Amount of Surcharge</surchargeAmount>

  <orderSource>Order Entry Source</orderSource>

  <billToAddress>

<additionalCOFData>

  [ <card> | <token> | <paypage> | <mpos> ]

  <customBilling>

  <taxType>payment or fee</taxType>

  <enhancedData>

  <lodgingInfo>

  <processingInstructions>

  <pos>

  <merchantData>

  <actionReason>SUSPECT_FRAUD</actionReason>

  <businessIndicator>consumerBillPayment</businessIndicator>

<accountFundingTransactionData>

</credit>

Example: Batch Credit Request for a Non-Worldpay Processed Transaction

If the sale occurred outside of our system, you must specify the following elements in your Credit request: <orderId>, <amount>, and <card>, or <token> (<paypal> is not supported for this transaction type).

<cnpRequest version="12.0" xmlns="http://www.vantivcnp.com/schema" id="123" numBatchRequests="1">

  <authentication>

    <user>userName</user>

    <password>password</password>

  </authentication>

  <batchRequest id="01234567" numCredits="1" creditAmount="10000" merchantId="100">

    <credit id="AX54321678" reportGroup="RG27">

      <orderId>12z58743y1</orderId>

      <amount>10000</amount>

      <orderSource>ecommerce</orderSource>

      <billToAddress>

        <name>John Doe</name>

        <addressLine1>123 4th street</addressLine1>

        <addressLine2>Apt. 20</addressLine2>

        <addressLine3>second floor</addressLine3>

        <city>San Jose</city>

        <state>CA</state>

        <zip>95032</zip>

        <country>USA</country>

        <email>jdoe@isp.com</email>

        <phone>408-555-1212</phone>

      </billToAddress>

      <card>

        <type>MC</type>

        <number>5186005800001012</number>

        <expDate>1110</expDate>

      </card>

      <enhancedData>

        <customerReference>PO12345</customerReference>

        <salesTax>125</salesTax>

        <taxExempt>false</taxExempt>

        <discountAmount>0</discountAmount>

        <shippingAmount>495</shippingAmount>

        <dutyAmount>0</dutyAmount>

        <shipFromPostalCode>01851</shipFromPostalCode>

        <destinationPostalCode>01851</destinationPostalCode>

        <destinationCountryCode>USA</destinationCountryCode>

        <invoiceReferenceNumber>123456</invoiceReferenceNumber>

        <orderDate>2016-09-14</orderDate>

        <detailTax>

          <taxIncludedInTotal>true</taxIncludedInTotal>

          <taxAmount>55</taxAmount>

          <taxRate>0.0059</taxRate>

          <taxTypeIdentifier>00</taxTypeIdentifier>

          <cardAcceptorTaxId>011234567</cardAcceptorTaxId>

        </detailTax>

        <lineItemData>

          <itemSequenceNumber>1</itemSequenceNumber>

          <itemDescription>chair</itemDescription>

          <productCode>CH123</productCode>

          <quantity>1</quantity>

          <unitOfMeasure>EACH</unitOfMeasure>

          <taxAmount>125</taxAmount>

          <lineItemTotal>9380</lineItemTotal>

          <lineItemTotalWithTax>9505</lineItemTotalWithTax>

          <itemDiscountAmount>0</itemDiscountAmount>

          <commodityCode>300</commodityCode>

          <unitCost>93.80</unitCost>

        </lineItemData>

      </enhancedData>

    </credit>

  </batchRequest>

</cnpRequest>

Example: Online Credit Request for a Non-Worldpay Processed Transaction

If the sale occurred outside of our system, you must specify the following elements in your Credit request: <orderId>, <amount>, and <card>, or <token> (<paypal> not supported for this transaction type).

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

  <authentication>

    <user>User Name</user>

    <password>password</password>

  </authentication>

  <credit id="2" reportGroup="ABC Division" customerId="038945">

    <orderId>56789</orderId>

    <amount>10000</amount>

    <orderSource>ecommerce</orderSource>

    <billToAddress>

      <name>Mike J. Hammer</name>

      <addressLine1>Two Main Street</addressLine1>

      <addressLine2>Apartment 222</addressLine2>

      <addressLine3></addressLine3>

      <city>Riverside</city>

      <state>RI</state>

      <zip>02915</zip>

      <country>US</country>

      <email>mike@sample.com</email>

      <phone>5555555555</phone>

    </billToAddress>

    <card>

      <type>VI</type>

      <number>4005550000081019</number>

      <expDate>0907</expDate>

    </card>

    <customBilling>

      <phone>5555555555</phone>

      <descriptor>descriptor</descriptor>

    </customBilling>

    <enhancedData>

      <customerReference>PO12345</customerReference>

      <salesTax>125</salesTax>

      <taxExempt>false</taxExempt>

      <discountAmount>0</discountAmount>

      <shippingAmount>495</shippingAmount>

      <dutyAmount>0</dutyAmount>

      <shipFromPostalCode>01851</shipFromPostalCode>

      <destinationPostalCode>01851</destinationPostalCode>

      <destinationCountryCode>USA</destinationCountryCode>

      <invoiceReferenceNumber>123456</invoiceReferenceNumber>

      <orderDate>2011-08-14</orderDate>

      <detailTax>

        <taxIncludedInTotal>true</taxIncludedInTotal>

        <taxAmount>55</taxAmount>

        <taxRate>0.0059</taxRate>

        <taxTypeIdentifier>00</taxTypeIdentifier>

        <cardAcceptorTaxId>011234567</cardAcceptorTaxId>

      </detailTax>

      <lineItemData>

        <itemSequenceNumber>1</itemSequenceNumber>

        <itemDescription>chair</itemDescription>

        <productCode>CH123</productCode>

        <quantity>1</quantity>

        <unitOfMeasure>EACH</unitOfMeasure>

        <taxAmount>125</taxAmount>

        <lineItemTotal>9380</lineItemTotal>

        <lineItemTotalWithTax>9505</lineItemTotalWithTax>

        <itemDiscountAmount>0</itemDiscountAmount>

        <commodityCode>300</commodityCode>

        <unitCost>93.80</unitCost>

      </lineItemData>

      <lineItemData>

        <itemSequenceNumber>2</itemSequenceNumber>

        <itemDescription>table</itemDescription>

        <productCode>TB123</productCode>

        <quantity>1</quantity>

        <unitOfMeasure>EACH</unitOfMeasure>

        <lineItemTotal>30000</lineItemTotal>

        <itemDiscountAmount>0</itemDiscountAmount>

        <commodityCode>300</commodityCode>

        <unitCost>300.00</unitCost>

      </lineItemData>

    </enhancedData>

  </credit>

</cnpOnlineRequest>