eCheck Prenotification Credit Transactions (Batch Only)

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

eCheck Prenotification Credit Request

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

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

  <orderId>Order Id</orderId>

  <orderSource>Order Entry Source</orderSource>

  <billToAddress>

  <echeck>

  <merchantData>

</echeckPreNoteCredit>

Example: eCheck Prenotification Credit 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" numEcheckPreNoteCredit="1" merchantId="100">

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

    </echeckPreNoteCredit>

  </batchRequest>

</cnpRequest>

eCheck Prenotification Credit Response

The eCheck Prenotification Credit response has the following structure:

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

</echeckPreNoteCreditResponse>

Example:  eCheck Prenotification Credit 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">

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

    </echeckPreNoteCreditResponse>

  </batchResponse>

<cnpResponse>