Refi Semi Posting Specs

Introduction

This document describes how to post refi semi 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=REFI SEMI&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 - REFI SEMI	Yes	String	&type=REFI SEMI
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.
work_phone	Work Phone without any dashes or parentheses	Yes	Integer	&home_phone=3105551234
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
lead_date	Date of Submission in the format: YYYY-MM-DD	No	Date	&lead_date=2017-01-01
field_1	House Type. Valid values: Single Family Condominium Town Home Multi-Family Dwelling Unit Duplex	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
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
work_ext	Work extension. Can contain characters and numbers.	No	String	&work_ext=x110
soldtimes	Sold Times.	No	Integer	&soldtimes=1
soldto	The list of lender id's we have in common that you sold this lead to. We will provide you with a list of lender id's. You must send them in the following format: X\|X\|X with no leading 0's or extra padding.	No	String	&soldto=21\|7
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_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_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

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.