Refinance Posting Specs

Introduction

This document describes how to post refinance leads to RGR Marketing. We accept both POST and GET requests.

Posting URL

https://www.reallygreatrate.com/formdov.php

Example Request Structure

A lead can be submitted via GET request. A well-formatted request looks like:

https://www.reallygreatrate.com/formdov.php?publisher_id=X&type=REFINANCE&first_name=Really&last_name=Rate&city=LA&state=CA&zip=99999&street_address=111First&work_phone=5558585&home_phone=5559696&email_address=rate@hotmail.com&include_in_market=Y&upload_type=RGR&lead_date=2005-05-05&field_1=xxx&field_2=xxx&field_3=xxx&field_4=xxx&field_6=xxx&field_7=xxx&field_8=xxx&field_9=xxx&field_10=xxx&best_time_to_call=Morning&ipaddress=1.1.1.1&subid=89&response=Yes&rcid=412&date_generated=09102005&work_ext=x456

Note that all field names are lower case and must match exactly for fields to be processed correctly.

publisher_id will be assigned to you by RGR Marketing. publisher_id is required for any lead to be accepted – it must be present in the posting string in the following format publisher_id=XXX where XXX is your assigned number.

Request Fields

Required Fields

parameter	description	required	data type	example
publisher_id	Publisher ID assigned by RGR before testing a new campaign	Yes	Integer	&publisher_id=1
type	Type of lead being submitted in all caps - REFINANCE	Yes	String	&type=REFINANCE
first_name	First Name	Yes	String	&first_name=Bob
last_name	Last Name	Yes	String	&last_name=New
city	City	Yes	String	&city=Temecula
state	2 Character State Abbreviation	Yes	String	&state=CA
zip	5 Digit Zip Code	Yes	Integer	&zip=12345
street_address	Street Address	Yes	String	&street_address=123 Main St.
home_phone	Home Phone without any dashes or parentheses	Yes	Integer	&home_phone=3105551234
email_address	Email address with @ and a valid extension (.com, .net, .gov, etc.)	Yes	String	&email_address=bobnew@mail.com
upload_type	Upload Type should be defaulted to RGR for the publishers unless otherwise instructed.	Yes	String	&upload_type=RGR
field_1	House Type. Valid values: Single Family Condominium Town Home Multi-Family Dwelling Unit Duplex Mobile Home	Yes	String	&field_1=Single Family
field_2	House Value. Whole number. No commas.	Yes	Integer	&field_2=200000
field_4	First Mortgage Balance. Whole number. No commas.	Yes	Integer	&field_4=80000
field_6	Credit Status. Valid values: Excellent Good Fair Poor	Yes	String	&field_6=Good
field_8	Current Interest Rate of the customer.	Yes	Decimal	&field_8=4.75
field_9	Desired Loan Type. Valid values: Refinance Refinance - Cash Out Home Improvement Debt Consolidation Home Equity Loan Loan Modification	Yes	String	&field_9=Refinance - Cash Out
ipaddress	Consumer's IP Address. The lead will be failed if Publisher's IP Address is used.	Yes	String	&ipaddress=127.0.0.1
response	Response - Set to Yes for an HTTP response. Valid Values: Yes No	Yes	String	&response=Yes

Optional Fields

parameter	description	required	data type	example
field_31	Jornaya LeadiD Token - Token genated by Jornaya LeadiD	No - *unless* required by RGR for the publisher	String	&field_31=A033EC88-9C9F-576D-C04B-9A3183B4FBD9
field_32	Trustedform Token - Token genated by Trustedform	No - *unless* required by RGR for the publisher	String	&field_32=https://cert.trustedform.com/fe2a7393d7dcc5d14016e5aab73b28151d36206f
work_phone	Work Phone without any dashes or parentheses	No	Integer	&home_phone=3105556789
work_ext	Work extension. Can contain characters and numbers.	No	String	&work_ext=x110
lead_date	Date of Submission in the format: YYYY-MM-DD	No	Date	&lead_date=2017-01-01
include_in_market	Include in our future marketing campaigns. Y or N. Defaults to Y.	No	String	&include_in_market=Y
field_3	Loan Amount. Whole number. No commas.	No	Integer	&field_3=100000
field_7	Current Interest Rate Type. Valid values: Fixed Adjustable Defaults to Fixed	No	String	&field_7=Fixed
field_10	Publisher Lead ID - used for affiliate tracking and reporting.	No	String	&field_10=RGR12345
best_time_to_call	Best Time to Call. Valid values: Morning Afternoon Evening Defaults to Evening	No	String	&best_time_to_call=Morning
subid	Sub ID - used to track Publisher's marketing campaign/information.	No	String	&subid=Campaign123
rcid	Refer Code ID - used to validate the lead sent against a specific contract. Contact Matt Schaub for details and your specific RCID.	No	Integer	&rcid=1234
date_generated	The date you generated the lead in your system or the date the lead was captured by you.	No	Date	&date_generated=2017-01-01
field_11	Property Use. Valid values: Primary residence Second/Vacation home Investment property	No	String	&field_11=Investment property
field_12	Age of applicant. Valid values: 62 and over 50-61 40-49 30-39 20-29 19 and under	No	Date	&field_12=50-61
field_13	Reverse Mortgage - Are you interested in Reverse Mortgage? Valid values: yes no Only allowed to be yes if field_12 is: 62 and over	No	Date	&field_13=yes
field_14	Second Mortgage Balance. Whole number. No commas.	No	Integer	&field_14=80000
field_15	Mortgage Payment Status - How many late mortgage payments in the past 12 months / how far are you behind in your payments? Valid values: Current One Two Two or more	No	String	&field_15=Current
field_16	FHA Bankruptcy - Have you filed bankruptcy in the past 3 years? Valid values: Yes No	No	String	&field_16=No
field_17	FHA Income - Can you verify your income? Valid values: Yes No	No	String	&field_17=Yes
field_18	Annual Income	No	Integer	&field_18=100000
field_19	Mortgage Payment Amount - Amount of your first mortgage monthly payment	No	Integer	&field_19=3000
field_20	Name of Current Lender	No	String	&field_20=Wells Fargo
field_21	Tax Debt - Do you currently have tax debt? Valid Values: Yes No	No	String	&field_21=No
field_22	Comments - Any comments collected on your site	No	String	&field_22=I need help now!
field_23	FHA Loan - Do you currently have an FHA loan? Valid Values: Yes No D (Don't Know)	No	String	&field_23=No
field_24	Spouse First Name	No	String	&field_24=Dorothy
field_25	Spouse Last Name	No	String	&field_25=Mack
field_26	Spouse Age	No	Integer	&field_26=44
field_27	Information Requested For. Example: Myself My Parents Other Family Other	No	String	&field_25=Myself
field_28	Active Military - Are you or your spouse on active military duty or a veteran? Valid Values: Yes No	No	String	&field_28=Yes
field_29	VA Loan - Are you or your spouse in a VA loan? Valid Values: Yes No	No	String	&field_29=Yes
field_34	Employment Status - What is your employment? Valid Values: Employed Self-Employed Retired Other	No	String	&field_34=Employed
cash_out	Cash Out - Cash out with loan? Yes No	No	String/Integer	&cash_out=Yes

Responses

If you put &response=Yes in the post string, we will return an HTML response in the following format. If response is empty or equal to no, we will redirect you to the appropriate RGR thank you page.

Successful Response

The format of a successful post will be:

<html><body>status=success<br>id=1234567</body></html>

Failed Response

The format of a rejected lead will be:

<html><body>status=Failed<br>Reason=Duplicate from publisher<br>id=1234567</body></html>

The format of a flagged lead will be:

<html><body>status=Flagged<br>Reason=Address in correct<br>id=1234567</body></html>

Jornaya LeadiD Integration

You can check out Jornaya's guide on how to set up with Jornaya Intelligence (LeadiD Audit) here.

In order to implement Jornaya LeadiD on your landing pages:

Go to Jornaya and click "SIGN UP". Fill out the Signup form, and await your confirmation email.

Create a campaign in LeadID for your Landing Page.

Implement the hidden field for LeadID:

<input id="leadid_token" name="universal_leadid" type="hidden" value=""/>

Get the code for your newly created campaign and place before the closing body tag on each step of your form:
(Example Script – DO NOT USE)

<script id="LeadiDscript" type="text/javascript">
    (function() { 
        var s = document.createElement('script'); 
        s.id = 'LeadiDscript_campaign'; 
        s.type = 'text/javascript'; s.async = true; 
        s.src = (document.location.protocol + '//d1tp4234w7krrh.cloudfront.net/campaign/32121057-a216-ba9c-7121212-4ec1212121dfsafafdaf.js'); 
        var LeadiDscript = document.getElementById('LeadiDscript'); 
        LeadiDscript.parentNode.insertBefore(s, LeadiDscript);})();
</script>
<noscript><img src='//create.leadid.com/noscript.png?lac=23424-324234-324-23432-234234&lck=32daf057-343-343-32423-234234 /></noscript>

Place the Thank You Page Code on your form’s Thank You Page/Confirmation Page:
(Example Script – DO NOT USE)

<script id="LeadiDscript" type="text/javascript">
    (function() { 
        var s = document.createElement('script'); 
        s.id = 'LeadiDscript_campaign'; 
        s.type = 'text/javascript'; 
        s.async = true; 
        s.src = (document.location.protocol + '//234234.cloudfront.net/campaign/asdfasf-32424-23423-23432-324234324.js?f=submit'); 
        var LeadiDscript = document.getElementById('LeadiDscript'); 
        LeadiDscript.parentNode.insertBefore(s, LeadiDscript);})();
</script>
<noscript><img src='//create.leadid.com/noscript.png?lac=324324-234234-23423-23432-324234&lck=23432-23432-234-234-23423423 /></noscript>

Please reach out to RGR Tech Team at T--E--C--H (at) rgrmarketing.com (no hyphens) if you have further questions.

TrustedForm Integration

To get the most up-to-date script for TrustedForm Integration, go to this URL: Add and Verify the TrustedForm JavaScript in a form

In order to integrate TrustedForm with your form, install the following script on the last page of your form; before the closing body tag (the page that is actually submitting the lead):

<script type="text/javascript">
    (function() { 
        var field = 'xxTrustedFormCertUrl'; 
        var provideReferrer = false; 
        var tf = document.createElement('script'); 
        tf.type = 'text/javascript'; 
        tf.async = true; 
        tf.src = 'http' + ('https:' == document.location.protocol ? 's' : '') + '://api.trustedform.com/trustedform.js?provide_referrer=' + escape(provideReferrer) + '&field=' + escape(field) + '&l='+new Date().getTime()+Math.random(); 
        var s = document.getElementsByTagName('script')[0]; 
        s.parentNode.insertBefore(tf, s); } )(); 
</script> 
<noscript> <img src="http://api.trustedform.com/ns.gif" /> </noscript>

This script will automatically add xxTrustedFormCertUrl field to your form. Use the field variable to customize the name of the field that is inserted into your form.

Please reach out to RGR Tech Team at T--E--C--H (at) rgrmarketing.com (no hyphens) if you have further questions.