Easy Method

For those with minimal HTML coding knowledge or experience

Just add this line to your website and all the necessary code will be automatically generated. You can have multiple tariffs on the same page without problems, just grab the code for each one and add it on.

<script src="http://uk.ImpulsePay.com/XX" data-label-XX="Buy Now" type="text/javascript"></script>

Change the XX to the RouteID number, as shown under the relavent tariff on the "Add, edit or view price tariffs" page.

To change the text on the button, just edit the Buy Now part of data-label-XX="Buy Now" to your new text. This may contain any alphanumeric character or punctuation except for speech marks (").

Web Link Method

Quickly redirect customers to pay using a simple hyperlink

You can link to your payment page using a standard hyperlink. Just add the correct RouteID to the URL, then when they click through they are taken to the payment gateway for payment.

<a href="http://uk.ImpulsePay.com/payforit?RouteID=XX">Pay Now</a>

Change the XX to the RouteID number, as shown under the relavent tariff on the "Add, edit or view price tariffs" page.

You can also include a note with your payment request by adding &Note=ABC123 to the end of the URL. This note will be added to the notification URL (if configured), along with the success and failure URL's.

Developer's Method

For those doing a more integrated setup or using custom branding

Place this form on your page to accept payments. You can edit the form to include additional data or make a call to it via a web service. CSS styling can be used and you can use an image instead of a button to better fit with your sites design.

<form action="http://uk.ImpulsePay.com/payforit" method="post">
<input name="Button" type="submit" value="Pay with your mobile" />
<input name="RouteID" type="hidden" value="XX" />
<input name="Note" type="hidden" value="ABCD12345" /> <!-- optional -->
</form>

Change the XX to the RouteID number, as shown under the relavent tariff on the "Add, edit or view price tariffs" page.

You can include a 255 character alphanumeric string in the Note option which will be passed back to you in notification alerts and redirects after a transaction occurs. The data is passed back in a Note= field, appended to your URL.

Server-side Method

Embed our payment gateway into your site

A server-side request allows you to get the URL for the payment gateway and load this in an iFrame on your website, as the page loads up. This can optimize your payment process by removing unnecessary steps.

URL Syntax:
http://uk.ImpulsePay.com/payforit?RouteID=XX&URL=Y

Change the XX to the RouteID number, as shown under the relavent tariff on the "Add, edit or view price tariffs" page. Click here or here for help on how to call a URL from your server.

The payment window will not show any ImpulsePay branding or FAQs when it loads. The window has been optimized to fit an iFrame of 520px (w) by 530px (h).

Notification URL

Alerts sent to you when a transaction occurs

This is optional for both methods and sends a payment notification to your server via an HTTP Get request, letting you know if a payment was accepted or declined.

URL Syntax:
http://www.yourcompany.com/service?xyz=123&Mobile=&Operator=&SessionID=&Note=&Status=&Tariff=

To enable notifications, just specify the blue part of the URL in the "Notification URL" field on the "Add, edit or view price tariffs" page when you log in.

URLs can include any number of additional parameters to help process requests. These will be passed back to your server unchanged, when we send a notification (like the "XYZ=123" in the example). We will append a Mobile, SessionID, Note and Status parameter to the end of each request.

The Mobile parameter is the 12 digit mobile phone number (eg 447123123123) of the person making the purchase and Operator is their mobile phone network. SessionID is a unique 20 character string identifier for this purchase, Note (255 character alphanumeric string) is the notes field you pass into the initial request,Tariff is the amount charged and Status will be one of the following:

Status Codes

0

Request initialized

  

204

Subscriber has insufficient funds or is barred

10

RouteID Missing

  

205

Network level error (please notify us)

11

Session error (please notify us)

  

206

User barred by ImpulsePay for fraudulent activity

100

Purchase completed successfully

  

207

Unknown network operator

199

Service partner error (please notify us)

  

208

Something generic went wrong... please notify us

200

Session timed out

  

209

Transaction blocked for suspicious activity

203

Purchase cancelled by user

      

Operator Values: O2, Orange, Three, T-Mobile, Virgin, Vodafone

Additionally, the same Status, Note and Operator fields are appended to the success/failure redirect after a payment has been attempted.

Customise your request

Optional parameters to help customise requests

You can append these parameters to your URL and allow additional information to be passed into your request. If the data passed in is incorrect then the parameter will be ignored.

&Mobile=07811111111
This allows you to pre-populate the mobile number field with a valid UK mobile number.

&Force=Mobile
This will display the mobile optimised version of the payment gateway rather than attempting to detect it automatically.

&ServiceDesc=Picture2
This will override the “Service Name” of the tariff with the value passed in, which must be less than 35 alphanumeric characters.

&Tariff=50
This allows you to dynamically update the amount to charge with the amount specified.

The allowed values (in pence) are:
50, 100, 150, 200, 250, 300, 350, 400, 450, 500, 550, 600, 650, 700, 750, 800, 850, 900, 950, 1000,
1050, 1100, 1150, 1200, 1250, 1300, 1350, 1400, 1450, 1500, 1550, 1600, 1650, 1700, 1750, 1800, 1850, 1900, 1950, 2000,
2050, 2100, 2150, 2200, 2250, 2300, 2350, 2400, 2450, 2500, 2550, 2600, 2650, 2700, 2750, 2800, 2850, 2900, 2950, 3000.

All tariffs higher than 500 with the exception of 1000 use multi-billing to reach the full amount.

Transaction Status

Check the transaction status in real time

Look up the status of your transaction at any time to confirm if it has been successfully billed. This is useful to call from your success page to ensure billing has been completed correctly.

URL Syntax:
http://www.impulsepay.com/lookup?SessionID=<SessionID>

Replace <SessionID> with the value passed to you on the success or failure redirects or in the notification request. The value returned is the current status of the transaction.

Multi-billing Tariffs

Allows you to charge higher amounts

For tariffs that are not available on an operator we can make multiple charges to reach the desired amount, for instance charging £5 and £3 to bill £8.

If we are able to bill the initial £5 but the £3 charge fails (typically due to insufficient credit), we will send you a successful billing notification and retry the £3 charge for 14 consecutive days. After this point, we are not able to retry the transaction any further and you will not receive funds for the £3.

Due to the retry strategy we recommend that any cost of sales be covered by the initial £5 charge (or £10 on payments above £10.50), which will always fail the entire transaction should this payment fail.