Debt Posting Specs

Introduction

This document describes how to post tax 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=TAX&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 - TAX	Yes	String	&type=TAX
first_name	First Name	Yes	String	&first_name=Bob
last_name	Last Name	Yes	String	&last_name=New
state	2 Character State Abbreviation	Yes	String	&state=CA
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	Yes	Date	&lead_date=2017-11-09
field_1	Tax Payer's Debt Amount	Yes	Integer	&field_1=10000
ipaddress	Consumer's IP Address. The lead will be failed if Publisher's IP Address is used.	Yes	String	&ipaddress=127.0.0.1

Optional Fields

parameter	description	required	data type	example
city	City	No	String	&city=Temecula
zip	Zip	No	Integer	&zip=99999
street_address	Street Address	No	String	&street_address=123 Main St
street_address2	Street Address2	No	String	&street_address2=123 Main St
work_phone	Work Phone	No	String	&work_phone=5555555
work_ext	Work Extension	No	String	&work_ext=x456
include_in_market	Include in Market	No	String	&include_in_market=Y
field_2	Tax Notes	No	String	&field_2=Tax payer currently in audit
field_10	Lead ID from the publisher: a unique number from the publisher per lead	No	String	&field_10=RGR12345
field_11	TrustedForm Token	No	String	&field_11=https://cert.trustedform.com/9a8b7c6d5e4f3g2h1i
field_12	Student Loan Debt	No	String	&field_12=Y
field_13	Jornaya LeadiD Token - Token genated by Jornaya LeadiD	Yes - *unless* NOT required by RGR for the publisher	String	&field_13=A033EC88-9C9F-576D-C04B-9A3183B4FBD9
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
response	Response - Set to Yes if you want an HTTP response. If blank or No, then we serve our thank you page. Valid Values: Yes No *This is only used in posting.*	No	String	&response=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.