Forums/Hosted Payment Pages

Recurring - First Data Global Gateway e4℠ Payment Page Integration

First Data Support (LL)
posted this on January 20, 2011 13:30

This document outlines the procedures for setting up a First Data Global Gateway e4℠ Payment Page to submit Recurring transactions.

Payment Page Settings

The first step in setting up Recurring functionality for a Global Gateway e4℠ Payment Page is to enable the Recurring payments setting for a Global Gateway e4℠ Payment Page. To do this, log into the administration area, go to the "Payment Pages" area, and edit the Global Gateway e4℠ Payment Page you'd like to set up.

Click the "Recurring" tab, then click on the checkbox to "Enable Recurring Payments" setting. You may also add your customer agreement text here.

settings.png

Plan Settings

Now, you'll want to make sure you have a Plan set up to use with your Global Gateway e4℠ Payment Page. To do this, click the "Recurring" link while logged into the Global Gateway e4℠ Payment Pages administration interface. You can create a new plan to use with your Global Gateway e4℠ Payment Page or edit an existing one - just make sure the "Enable for Payment Page" setting is enabled when adjusting the settings for your Plan.

planupload.png

HCO Plan ID

At this point you will need to retrieve the Plan's HCO Plan ID, which is a value required for use on the Global Gateway e4℠ Payment Page form - this associates payments made through your Global Gateway e4℠ Payment Page to the desired Plan. This value can be obtained under the "Recurring" area by clicking "All Plans", then by clicking your desired Plan name. The value will be visible at the top of the page under the heading "HCO Plan ID (x_recurring_billing_id)".

recurringmain.png

Payment Form

Finally, you'll need to set up your payment form to enable Recurring payments. In addition to the essential Payment Page fields, you'll need to add the following:

  • x_recurring_billing_id - this field's value should be the HCO Plan ID from the previous step
  • x_recurring_billing_amount - the amount that the customer should be charged on a recurring basis
  • x_recurring_billing - should be set to TRUE to enable Recurring payments
  • x_type - must NOT be AUTH_TOKEN or PURCHASE_TOKEN

These fields are optional:

  • x_recurring_billing_start_date - the start date of the Recurring transaction (YYYY-MM-DD format)
  • x_recurring_billing_end_date - the end date of the Recurring transaction (YYYY-MM-DD format)

Example payment form code:

<form method="post" action="https://globalgatewaye4.firstdata.com">


<!-- Essential fields -->
<input type="hidden" name="x_login" value="HCO-RECURRING" />
<input type="hidden" name="x_fp_sequence" value="9297" />
<input type="hidden" name="x_fp_timestamp" value="1289255121" />
<input type="hidden" name="x_currency_code" value="CAD" />
<input type="hidden" name="x_amount" value="19.95" />
<input type="hidden" name="x_fp_hash" value="f4ff3bc3128c114d9857c30d6a0df3fc" />
<input type="hidden" name="x_show_form" value="PAYMENT_FORM" />
<input type="hidden" name="x_type" value="AUTH_TOKEN" />

<!-- Fields specific to Recurring -->
<input type="hidden" name="x_recurring_billing_amount" value="19.95" />
<input type="hidden" name="x_recurring_billing_id" value="MB-HOSTE-5-4" />
<input type="hidden" name="x_recurring_billing" value="TRUE" />
<input type="hidden" name="x_recurring_billing_start_date" value="2010-11-11" />
<input type="hidden" name="x_recurring_billing_end_date" value="2011-01-11" />

<input type="submit" name="submit" value="Checkout Now" />
</form>

Now that all of your settings have been adjusted and your payment form has been set up, you're ready to start creating Recurring payments through Global Gateway e4℠ Payment Pages.

 
Topic is closed for comments