9 posts / 0 new
Last post
tigersheepdevel...
Required info for eCheck API request

with the sandbox request payload I've noticed that the response will appear successful (it will have 'transaction_status: approved') even with some of the "required" information missing.

If I send:

{
"method": "tele_check",
"transaction_type": "purchase",
"amount": "500",
"currency_code": "USD",
"tele_check": {
"check_number": "0101",
"check_type": "C",
"routing_number": "BN1234567801234567890",
"account_number": "17101874",
"accountholder_name": "Tom Eck",
},
"billing_address": {
"street": "225 Liberty Street",
"city": "NYC",
"state_province": "NY",
"zip_postal_code": "10281",
"country": "US"
}
}

I get response:

{
"correlation_id":"228.1456962079204",
"transaction_status":"approved",
"validation_status":"success",
"transaction_type":"purchase",
"transaction_id":"ET139592",
"transaction_tag":"76802348",
"method":"tele_check",
"amount":"500",
"currency":"USD",
"bank_resp_code":"100",
"bank_message":"Approved",
"gateway_resp_code":"00",
"gateway_message":"Transaction Normal",
"tele_check":{
"accountholder_name":"Tom Eck",
"check_number":"0101",
"check_type":"C",
"account_number":"1874",
"routing_number":"BN1234567801234567890"
}
}

Even though it is missing the customer_id_number and customer_id_type and client_email from the request. Are those fields really required? Will customer transactions not process properly without that information in the request? Is billing address also required (I have left out billing address entirely and gotten a success response)?


rohitrajagopal3538
Re: Required info for eCheck API request

Hello,

While the API will accept transactions without the fields - customer_id_number, customer_id_type, client_email and billing address, the API will substitute and send a blank, non-null value to the telecheck system for those fields. Now, since the telecheck system uses these fields to make approval decisions, your transactions could get declined. So it is recommended that you send the data for those fields in your transactions.

Regards,

Payeezy
team


rickross3779
Re: Required info for eCheck API request

Ok.. but what are customer_id and customer_id_type? Where do we find the definitions for those fields? Who assigns and stores those ids?

Thanks,

Rick


rohitrajagopal3538
Re: Required info for eCheck API request

Customer_ID_Type

The type of ID used to validate the identity of the check holder. Allowed values are:

  • Driver's license: 0
  • Social Security Number: 1
  • Tax ID: 2
  • Military ID: 3

Customer_ID

Number on the type of identification specified in the previous property.

 

Regards,

Payeezy team


rickross3779
Re: Required info for eCheck API request

Thank you for that! Can you tell me where that was? It's not on the website is it?


rohitrajagopal3538
Re: Required info for eCheck API request

Hi Rick,

It was not on the website, sorry about that. We will add it.

Regards,

Payeezy team


brandshouter18042
Re: Required info for eCheck API request

A year and a half later, this is still not added to the API documentation, and would have saved me boat loads of time and headaches. There is absolutely no way of knowing what to send for customer_id_type and customer_id_number from the docs.


brandshouter18042
Re: Required info for eCheck API request

While I'm here, all the relevant error codes and description look to be copy and pasted from the credit card transaction post, cause they are of no help to an eCheck transaction.

https://developer.payeezy.com/payeezy-api/apis/post/transactions-10


christopherlord730
Re: Required info for eCheck API request

I apologize for the inconvenience. The bank response codes at the URL below are relevant for Telecheck and credit cards. However, the typical errors are 225 (invalid field data), 594 (other unidentifiable error) and 760 (ACH Non-participant). Other bank responses are possible but not too common.

https://support.payeezy.com/hc/en-us/articles/203730509-First-Data-Payeezy-Gateway-Bank-Response-Codes