eCheck Credit Request Against a Worldpay Transaction

To request an eCheck Credit against an eCheck Sale that had been settled by us, you only need to specify the <cnpTxnId> element. When you specify this element, the application uses the <cnpTxnId> to look up the referenced echeckSale transaction and obtain the necessary information. In this case, the <amount> element is optional, but should be included if the credit amount is less than the captured amount. If you do not include the <amount> element, the system assumes the credit to be for the total amount of the referenced transaction.

When requesting a echeckCredit against an echeckSale that occurred within our system, specify the Credit request as follows:

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

  <cnpTxnId>Transaction Id</cnpTxnId>

  <amount>Credit Amount</amount>

  <secondaryAmount>Secondary Amount</secondaryAmount>

  <customBilling> (Do not use)

  <customIdentifier>

</echeckCredit>

Example:  eCheck Credit Request

The eCheck Credit batch request shown below contains three <echeckCredit> elements. The first two use a Transaction Id as a reference. The third, which you would use for a sale occurring outside of our system, uses the <orderId>, <amount>, <billToAddress>, and <echeck> elements to provide the required information.

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

  <authentication>

    <user>userName</user>

    <password>password</password>

  </authentication>

  <batchRequest id="xmlbat01" numEcheckCredit="3" echeckCreditAmount="12100" merchantId="000053">

  <echeckCredit id="credit1" reportGroup="new53" customerId="53">

    <cnpTxnId>4455667788</cnpTxnId>

    <amount>1000</amount>

  </echeckCredit>

  <echeckCredit reportGroup="new53">

    <cnpTxnId>4455667789</cnpTxnId>

    <amount>1100</amount>

  </echeckCredit>

  <echeckCredit reportGroup="new53">

    <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>

      <echeck>

        <accType>Checking</accType>

        <accNum>5186005800001012</accNum>

        <routingNum>000010101</routingNum>

        <checkNum>1104</checkNum>

      </echeck>

    </echeckCredit>

  </batchRequest>

</cnpRequest>