SecureTrading

[darrenbale]

I have successfully implemented the SecureTrading gateway into my clients site, but they now wish to use it to process subscriptions as well as static payments.

Having spoken with SecureTrading, they do offer this facility and have provided a guide on how to implement it, but having had a read through, I am stumped as to how to get it to work with Cubecart.

Has anybody done this before?

Guide can be found at http://www.securetrading.com/download/XPay...ecification.pdf

[darrenbale]

A small update to this.

I have been sent the following guide from SecureTrading. still doesn't help me but may help one of you developers.

(sorry can't upload pdf's so here is the content of it)

ST Payment Pages

Subscription setup guide

Subscription

ST Payment Pages Subscription setup guide

Copyright

© SecureTrading® 2008. All rights reserved. No part of this document may be

photocopied, reproduced, stored in a retrieval system or transmitted in any form or by

any means whether electronic, mechanical or otherwise without the prior written

permission of SecureTrading Ltd.

Disclaimer

This document is for informational purposes only. SecureTrading make no warranties,

express or implied, through the distribution of this document. No warranty of accuracy

is given concerning the contents of the information contained in this publication. To

the extent permitted by law no liability (including liability to any person by reason of

negligence) will be accepted by SecureTrading, its subsidiaries or employees for any

direct or indirect loss or damage caused by omissions from or inaccuracies in this

document.

SecureTrading reserves the right to revise the content without obligation to notify any

person of such changes.

SecureTrading is the registered trademark of SecureTrading Group Ltd.

Document revised on 01-Dec-2008.

DOC_COM_ST-PAYMENT-PAGES-SUBSCRIPTION-SETUP-GUIDE   2 of 8

17 November 2008

ST Payment Pages Subscription setup guide

Contents

1	 Introduction ................................................................................

....................................................4

2	 Setting up SecureTrading Payment Pages...........................................................................

..5

   2.1	Form page configuration ................................................................................

...........................5

   2.2	Third level heading.........................................................................

............................................6

   2.3	Updating a Subscription....................................................................

.........................................6

3 View Screens ................................................................................

..................................................7

4 Further Information.....................................................................

.......................................................8

   4.1	Support ................................................................................

.......................................................8

   4.2	Further reading.........................................................................

..................................................8

DOC_COM_ST-PAYMENT-PAGES-SUBSCRIPTION-SETUP-GUIDE									3 of 8

17 November 2008

ST Payment Pages Subscription setup guide

1	   Introduction

This is a separate document to the ST Payment Pages setup guide (read the Further information

section) as there are extra fields required in order to process a subscription.

In order to process subscriptions you first need to obtain a Recurring or Subscription merchant id

from your acquiring bank and inform support via email at [email protected] your account

details.

You can only process Subscriptions on Visa branded cards and MasterCards only (Switch/Maestro and

Solo are exempt).

DOC_COM_ST-PAYMENT-PAGES-SUBSCRIPTION-SETUP-GUIDE			4 of 8

17 November 2008

ST Payment Pages Subscription setup guide

2 Setting up SecureTrading Payment Pages

You first need to create new payment page similar to the ones created to process normal

ecommerce orders, and enter the following hidden fields:

				page

2.1 Form page configuration

You first need to create new payment page similar to the ones created to process normal e-

commerce orders, and enter the following hidden fields:

<input type="hidden" name="transactiontype" value="$transactiontype">

<input type="hidden" name="st_unit" value="$st_unit">

<input type="hidden" name="st_howmany" value="$st_howmany">

<input type="hidden" name="st_period" value="$st_period">

<input type="hidden" name="st_begindate" value="$st_begindate">

$transactiontype, this can be one of two values;

			1= no subscription

			2= subscription

$st_units, this is whether the subscription is for a number of days or months,

		 e.g. you either enter “Day†or “Monthâ€Â

$st_howmany, how many transactions do they want to take? 10, 20 etc

$st_period, how many intervals should pass between each payment? If you have selected ‘days’ as

your ‘Intervals’ by entering 10 here, payment will be taken every 10 days.

$st_begindate, this needs to come from the merchants as the earliest any subscription can be

processed is the day after the subscription is generated. The first payment is taken when the

subscription is set up, so it’s when you want to take the second payment you are declaring here.

		 e.g. if today is the 2006-10-24 then earliest the subscription can be set is 2006-10-25

Please Note: the date within SecureTrading is declared as YYYY-MM-DD. Any variation on this will

cause the subscription to fail.

e.g. of code being sent for a subscription;

<input   type=â€Âhiddenâ€Â		 name=â€Âtransactiontype†value=â€Â2â€Â>

<input   type=â€Âhiddenâ€Â		 name=â€Âst_unit†value=â€ÂMonthâ€Â>

<input   type=â€Âhiddenâ€Â		 name=â€Âst_howmany†value=â€Â12â€Â>

<input   type=â€Âhiddenâ€Â		 name=â€Âst_period†value=â€Â1â€Â>

<input   type=â€Âhiddenâ€Â		 name=â€Âst_begindate†value=â€Â2006-10-25â€Â>

																					   th

So here a subscription is to be run every month for 12 months starting on the 25 October 2006

			All these fields are required to process a subscription. If any are left it could cause your

			subscription to fail.

DOC_COM_ST-PAYMENT-PAGES-SUBSCRIPTION-SETUP-GUIDE		   5 of 8

17 November 2008

ST Payment Pages Subscription setup guide

2.2 Third level heading

You can display to the customer either the success.html page with details of their subscription, or

return them to a page on your site via callback. You’ll want to send the fields;

			$st_unit,

			$st_howmany,

			$st_period

			$st_begindate

These can also be added to the customeremail.txt and merchantemail.txt files

	   Updating

2.3 Updating a Subscription

The only current issue with processing subscriptions via payment pages is that you can’t update a

subscription yourself, but you can cancel them by searching in to the future and cancelling the

subscription.

Should you need to make a change to the amount/card number/expiry date, you’ll need to contact

Support on either [email protected] or 01248 672050 and provide them with the

necessary details required in order for them to make the change

DOC_COM_ST-PAYMENT-PAGES-SUBSCRIPTION-SETUP-GUIDE		  6 of 8

17 November 2008

ST Payment Pages Subscription setup guide

3 View Screens

When you now log in to My-ST when you go to “transactions†you can see there will be the auth

type “SubscriptionAuth†and any subsequent payments will be a “ContinuousAuthâ€Â.

You can keep track of what subscriptions are due to go through by selecting the “Subscriptionsâ€Â

option and you can then view when your next batch of subscriptions are due to run.

DOC_COM_ST-PAYMENT-PAGES-SUBSCRIPTION-SETUP-GUIDE		7 of 8

17 November 2008

ST Payment Pages Subscription setup guide

4 Further Information

This section contains contact information relevant to SecureTrading Payment Pages

4.1 Support

SecureTrading provides support for its software and the operation of its payment service.

If you require technical support, first ensure that you have read and understood all relevant

documentation.

If the problem persists, please email [email protected], quoting your SecureTrading

sitereference and concisely stating the nature of your problem.

Note: Before sending any information to SecureTrading, care should be taken to remove any

sensitive information, such as the credit card number.

SecureTrading additional contact details:

Phone: 01248 672 050

Fax:	 01248 672 099

4.2 Further reading

For further information please refer to the following documents:

In the general setup guides (http://www.securetrading.com/general-setup-guides.html) section of

the SecureTrading website:

			Going live document

In the ST Payment Pages documents (http://www.securetrading.com/payment-pages.html ) section

of the SecureTrading website:

			SecureTrading Payment Pages setup guide

DOC_COM_ST-PAYMENT-PAGES-SUBSCRIPTION-SETUP-GUIDE		   8 of 8

17 November 2008

[vokf]

I have successfully implemented the SecureTrading gateway into my clients site, but they now wish to use it to process subscriptions as well as static payments.

Having spoken with SecureTrading, they do offer this facility and have provided a guide on how to implement it, but having had a read through, I am stumped as to how to get it to work with Cubecart.

Has anybody done this before?

Guide can be found at http://www.securetrading.com/download/XPay...ecification.pdf

Darren,

you will need to get a 3rd party developer (or code it yourself) to do this for you.

This type of work is not discussed here, and you'll find commercial devlopers over at cubecartforums.org (link in my signature)

Thanks,

Jason

[darrenbale]

HI Jason,

I've put it up at cubecartforums.org as well as here. Was just hoping someone may have done it already.

Cheers

Darren