How to add ImpulsePay to your website

We’ve tried to keep our set up code simple and usable,
making it straightforward for you to get started

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.

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.

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.

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 540px (w) by 420px (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=

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 (developer method only) and Status will be one of the following:

Status Codes

0	Request initialized
10	RouteID Missing
11	Session error (please notify us)
100	Purchase completed successfully
199	Service partner error (please notify us)
200	Session timed out
203	Purchase cancelled by user
204	Subscriber has insufficient funds or is barred
205	Network level error (please notify us)
206	User barred by ImpulsePay for fraudulent activity
207	Unknown network operator
208	Something generic went wrong... please notify us
209	Transaction blocked for suspicious activity

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

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