|
|
|
Cash Advance Sales – Post Instructions
The Affnet Cash Advance Request Module allows Affnet partners with payday loan web sites to easily post visitor lead information and sell the cash advance service via the internet.
The request module works on standard http POST or GET form posts.
Parameters required as form fields:
|
|
Description |
Data Type (MaxLength) |
Parameter/Form Field Name |
Samples/Acceptable Values |
|
First Name |
String (50) |
FirstName |
John |
|
Last Name |
String (50) |
LastName |
Smith |
|
Date of Birth |
DateTime |
DateOfBirth |
01/15/1965 |
|
Gender |
String (1) |
Gender |
M/F/U |
|
Home Address |
String (50) |
Address |
123 Main St |
|
City |
String (50) |
City |
Irvine |
|
State |
String (2) |
State |
CA |
|
Country |
String (6) |
Country |
USA/CANADA |
|
Zip Code |
String (10) |
ZipCode |
92602 |
|
Language |
String (20) |
Language |
ENGLISH/CFR/FRENCH/FRA/DAN/DUT/ |
|
Best Phone # |
Numeric (10) |
HomePhone |
3332221111 |
|
Alternate Phone # |
Numeric (10) |
AltPhone |
3332221111 |
|
Email Address |
String (50) |
|
johnsmith@somedomain.com |
|
Visitor IP Address |
String (15) |
IPAddress |
222.111.44.1 |
|
Does lead have direct deposit? |
Bit (1) |
DirectDeposit |
0 = NO 1 = YES |
|
Monthly Income |
Numeric (5) |
NetIncome |
4000 |
|
Bank Routing Code |
Numeric (9) |
ABARouting |
123456789 |
|
Bank Account Number |
Numeric (15) |
AccountNumber |
33333333333 |
|
Bank Account Type |
Integer |
AccountType |
1 = CHECKING 2 = SAVINGS |
|
Primary Income Source |
Integer |
Source |
0 = Pension 1 = Disabilty_Benefits 2 = Social_Security 3 = Unemployed 4 = Employed 5 = Temp_Agency |
|
Payday Frequency |
Integer |
PayFrequency |
1 = None 2 = Weekly 3 = Bi_Weekly 4 = Monthly 5 = Twice_per_Month |
|
Next Paycheck date |
Date |
NextPayDate |
##/##/#### |
|
Last Paycheck date |
Date |
LastPayDate |
##/##/#### |
|
Bank Name |
String (35) |
BankName |
Wells Fargo
|
|
Social Security Number |
Numeric (9) |
SSN |
344556666 |
|
Drivers License # |
String (35) |
DriversLicense |
B67677a12 |
|
Reference First Name |
String (50) |
Reference1FirstName |
Suzy |
|
Reference Last Name |
String (50) |
Reference1LastName |
Williams |
|
Reference Phone # |
Numeric (10) |
Reference1Phone |
7228189999 |
|
Reference Relationship |
String (20) |
Reference1Relationship |
Friend |
|
Reference First Name |
String (50) |
Reference2FirstName |
Sam |
|
Reference Last Name |
String (50) |
Reference2LastName |
Smith |
|
Reference Phone # |
Numeric (10) |
Reference2Phone |
7229191999 |
|
Reference Relationship |
String (20) |
Reference2Relationship |
Brother |
|
User field assigned by Affnet |
String (20) |
user |
|
|
Id field assigned by Affnet |
String (20) |
id |
|
|
Domain/URL posting from |
String (50) |
Domain |
|
|
Test Post, 1 will always return ACCEPTED,REDIRECTURL if validation is passed |
Bit (1) |
TestServer |
0 = NO 1 = YES |
|
Company employed by |
String (50) |
Employer |
Sears |
|
Employment Position / Job Title |
String (50) |
EmploymentPosition |
Manager |
|
Work Phone # |
Numeric (10) |
WorkPhone |
7338889191 |
|
Owns or Rents home |
String (10) |
home_type |
Rent Own |
|
What tier of posting |
Numeric (1) |
tier |
1,2,3 or 4 |
These parameters are optional as form fields:
|
Description |
Data Type (MaxLength) |
Parameter/Form Field Name |
Sample/Acceptable values |
|
Work Extension |
Numeric (5) |
WorkExt |
211 |
|
Length of time at job |
String (20) |
JobDuration |
5 years |
|
BankAddress |
String (50) |
BankAddress |
44 main st |
|
BankPhone |
Numeric (10) |
BankPhone |
7338819199 |
|
Reference1Email |
String (35) |
Reference1Email |
suzywilliams@anydomain.com |
|
Reference2Email |
String (35) |
Reference2Email |
|
|
Apartment Number or Address 2 |
String (20) |
unitnumber |
Apt 12 |
|
SubID |
String |
SubID |
12345 |
|
Testing and Sample Code – one of the following methods may be used for posting in real time. HTTP or HTTPS (secure) may be used. $variables must be filled in using php or other server side language(s). |
PHP Sample – PHP cURL functionality. Requires cURL installed on server.
//url to post to
$url = "https://www.nationalfinancialadvance.com/cashtiers/httprequest.php";
//parameters
$str_post = "FirstName=".urlencode($FirstName);
$str_post .= "&LastName=".urlencode($LastName)."&Email=".urlencode($Email);
$str_post .= "&HomePhone=".urlencode($HomePhone)."&AltPhone=".urlencode($AltPhone);
$str_post .= "&DateOfBirth=".urlencode($DateOfBirth)."&unitnumber=".$unitnumber;
$str_post .= "&SSN=".urlencode($SSN)."&DriversLicense=".urlencode($DriversLicense);
$str_post .= "&Gender=".urlencode($Gender)."&Address=".urlencode($Address);
$str_post .= "&City=".urlencode($City)."&State=".urlencode($State);
$str_post .= "&Country=".urlencode($Country)."&ZipCode=".urlencode($ZipCode);
$str_post .= "&WorkPhone=".urlencode($WorkPhone)."&WorkExt=".urlencode($WorkExt);
$str_post .= "&EmploymentPosition=".urlencode($EmploymentPosition);
$str_post .= "&Employer=".urlencode($Employer)."&PayFrequency=".urlencode($PayFrequency);
$str_post .= "&NetIncome=".urlencode($NetIncome)."&LastPayDate=".urlencode($LastPayDate);
$str_post .= "&NextPayDate=".urlencode($NextPayDate)."&ABARouting=".urlencode($ABARouting);
$str_post .= "&AccountNumber=".urlencode($AccountNumber)."&BankName=".urlencode($BankName);
$str_post .= "&Reference1FirstName=".urlencode($Reference1FirstName);
$str_post .= "&Reference1LastName=".urlencode($Reference1LastName);
$str_post .= "&Reference1Phone=".urlencode($Reference1Phone);
$str_post .= "&Reference2FirstName=".urlencode($Reference2FirstName);
$str_post .= "&Reference2LastName=".urlencode($Reference2LastName);
$str_post .= "&Reference2Phone=".urlencode($Reference2Phone);
$str_post .= "&DirectDeposit=1;
$str_post .= "&Domain=".urlencode("http://www.yourdomainhere.com");
$str_post .= "&user=assigned&id=assigned&Language=ENGLISH&internal=no";
$str_post .= "&Source=".$Source."&AccountType=".$AccountType;
$str_post .= "&IPAddress=".urlencode($IPAddress)."&TestServer=1";
$str_post .= "&Reference1Relationship=".urlencode($Reference1Relationship);
$str_post .= "&Reference2Relationship=".urlencode($Reference2Relationship);
$str_post .= "&home_type=".urlencode($home_type);
//cURL
$user_agent = "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)";
$ch = curl_init();
curl_setopt($ch, CURLOPT_POST,1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $str_post);
curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($ch, CURLOPT_USERAGENT, $user_agent);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
// this line makes it work under https
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
$result=curl_exec ($ch);
curl_close ($ch);
//returns a unique ID - if 0 is returned there was an error
$postresult=$result;
------------------------------------------
|
Possible Return Sequences – Due to the variety of lenders that NationalFinancialAdvance has partnerships with the return values may differ based on lender criteria and where the lead is approved. There are four possible values returned from the http request module: |
|
Return String |
Description |
|
ACCEPTED, REDIRECTURL, PRICEPOINT, TRANSACTIONID |
Lead was qualified but must be redirected to online documents for an e-signature. |
|
DECLINED |
Lead was declined from NationalFinancialAdvance. |
|
DECLINED, ERROR STRING #1, ERROR STRING #2, ERROR STRING #3….. |
Lead could not be qualified because of form field validation errors or invalid data posted. |
Note: payouts from NationalFinancialAdvance are based on a completed application- including:
lead data is posted
lead redirects to e-signature page
Return string parameters:
REDIRECTURL – url to redirect the user to
PRICEPOINT – price point (payout) that Affnet pays out for the lead
TRANSACTIONID – internal unique number of the lead
