eCheck Prenotification Sale Transactions (Batch Only)

You use this non-monetary transaction to verify the consumer’s account information prior to submitting an eCheck Sale transaction (also see eCheck Prenotification). This transaction type is only supported for US transactions.

eCheck Prenotification Sale Request

You must specify the eCheck Prenotification Credit request using the following format:

<echeckPreNoteSale id="eCheck PreNote Id" reportGroup="iQ Report Group" customerId="Customer Id">

  <orderId>Order Id</orderId>

  <orderSource>Order Entry Source</orderSource>

  <billToAddress>

  <echeck>

  <merchantData>

</echeckPreNotesale>

Example: eCheck Prenotification Sale Request

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

  <authentication>

    <user>userName</user>

    <password>password</password>

  </authentication>

  <batchRequest id="654321" numEcheckPreNoteSale="1" merchantId="100">

    <echeckPreNoteSale id="AX54321678" reportGroup="RG27" customerId="53">

      <orderId>12z58743y1</orderId>

      <orderSource>telephone</orderSource>

      <billToAddress>

        <firstName>John</firstName>

        <lastName>Doe</lastName>

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

    </echeckPreNoteSale>

  </batchRequest>

</cnpRequest>

eCheck Prenotification Sale Response

The eCheck Prenotification Sale response has the following structure:

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

  <cnpTxnId>Transaction Id</cnpTxnId>

  <orderIdOrder Id</orderId>

  <response>Response Code</response>

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

  <message>Response Message</message>

</echeckPreNoteSaleResponse>

Example: eCheck Prenotification Sale Response

<cnpResponse version="12.0" xmlns="http://www.vantivcnp.com/schema" id="123" response="0" message="Valid Format" cnpSessionId="987654321">

  <batchResponse id="01234567" cnpBatchId="4455667788" merchantId="100">

    <echeckPreNoteSaleResponse id="AX54321678" reportGroup="RG27" customerId="53">

      <cnpTxnId>84568456</cnpTxnId>

      <orderId>12z58743y1</orderId>

      <response>000</response>

      <responseTime>2017-03-01T10:24:31</responseTime>

      <message>Approved</message>

    </echeckPreNoteCreditResponse>

    <echeckPreNoteCreditResponse id="AX54325432" reportGroup="RG12">

      <cnpTxnId>84568457</cnpTxnId>

      <orderId>12z58743y7</orderId>

      <response>000</response>

      <responseTime>2017-03-01T10:24:31</responseTime>

      <message>Approved</message>

    </echeckPreNoteSaleResponse>

  </batchResponse>

</cnpResponse>