Freelancer

Description

osCommerce FirstACH payment module

Description:
Develop an osCommerce payment module for FirstACH.

------------------------------------------------------
PLEASE DO NOT BID UNLESS YOU LOOK AT THE ATTACHED PDF!
------------------------------------------------------

1. The FirstACH payment system hosts the e-check form.
NO ACCOUNT INFO IS COLLECTED ON THE OSCOMMERCE SITE.
2. The osCommerce site will pass customer and amount information from checkout_process.php via a form-post to the hosted payment form.
3. After payment confirmation, FirstACH will send a confirmation string back to the osCommerce site.
4. Confirmation information must be saved with the order information.
5. Configuration Variables to be installed with = default value
> MODULE_PAYMENT_FIRSTACH_STATUS = false
> MODULE_PAYMENT_FIRSTACH_MERCHANT_ID = NULL
> MODULE_PAYMENT_FIRSTACH_FORM_TARGET = https://www.firstach.com/vc/dispatch2.asp
> MODULE_PAYMENT_FIRSTACH_SORT_ORDER = NULL
6. NOTES:
> You may copy/adapt one of the existing osCommerce e-check modules for fast development.
> Language file must include a definition where I can insert pre-checkout instructions like the PayPal IPN does so I can easily show people what to expect when they pay by echeck. This must display on the checkout_payment.php page.
define('FIRSTACH_HELP_PRECHECKOUT','bla bla bla');

More information

Sample form code
Below is a sample of the form code provided by FirstACH.
<form name="achdebit" method="post" action="https://www.firstach.com/vc/dispatch2.asp" target="_blank" >
<div align="center"><input type=submit value="CheckOut!" name="btnSubmit"></div>
<input type="hidden" name="MID" value="<MyMerchantId>">
<input type="hidden" name="fName" value="<MyCustomersFirstName>">
<input type="hidden" name="lName" value="<MyCustomersLastName>">
<input type="hidden" name="address" value="<MyCustomersStreetAddress>">
<input type="hidden" name="city" value="<MyCustomersCity>">
<input type="hidden" name="state" value="<MyCustomersState>">
<input type="hidden" name="zip" value="<MyCustomersZip>">
<input type="hidden" name="phone" value="<MyCustomersPhone>">
<input type="hidden" name="email" value="<MyCustomersEmail>">
<input type="hidden" name="cusID" value="<MyCustomersIDNumber>"><!-- osC cID -->
<input type="hidden" name="amt" value="<MyDollarAmount>"></form>





Working Example
I have modified the above code and submitted the form so you can see and example of the results.
<form name="achdebit" method="post" action="FIRSTACH_FORM_TARGET" target="_blank" >
<div align="center"><input type=submit value="CheckOut!" name="btnSubmit"></div>
<input type="hidden" name="MID" value="FIRSTACH_MERCHANT_ID">
<input type="hidden" name="fName" value="John">
<input type="hidden" name="lName" value="Doe">
<input type="hidden" name="address" value="1234-56th Ave.">
<input type="hidden" name="city" value="Seattle">
<input type="hidden" name="state" value="WA">
<input type="hidden" name="zip" value="98125">
<input type="hidden" name="phone" value="206-555-5555">
<input type="hidden" name="email" value="jdoe at example dot com">
<input type="hidden" name="cusID" value="8675309">
<input type="hidden" name="amt" value="9.95"></form>

Hosted Payment Form Looks Like <SEE ATTACHED PDF>
When the above form is submitted, the hosted payment form looks like below.
To Submit the payment the customer must:
1. Select Account Type
2. Enter routing number
3. Enter account number
4. Check authorization box.

Payment Confirmation Returned to osCommerce
After the payment is confirmed, FirstACH sends a confirmation string back to checkout_process.php.
The string will look like:
http://osCommerceSite.com/checkout_process.php?tranID=1082730&confNum=UEWZLOAP080719&customer_ID=8675309&amountPer=0.25&effecDate=7/22/2008

This information must to be logged into the order in osCommerce.

* Transaction ID
* Confirmation Number
* Effective Date


Additional files submitted:
osCommerce FirstACH payment module.pdf