Contents

Getting started

 

Follow these four steps

1
Here is an example HTML form that can be used as a template when redirecting your customers to the Payment Pages. Start by copying and pasting the below to a text file and save as an HTML form.

 


<html>
<body>
<form method="POST" action="<DOMAIN>/process/payments/choice">
<input type="hidden" name="sitereference" value="test_site12345">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="currencyiso3a" value="USD">
<input type="hidden" name="mainamount" value="100.00">
<input type="hidden" name="version" value="2">
<input type="submit" value="Pay">
</form>
</body>
</html>

Replace <DOMAIN> with a supported domain. Click here for a full list.

2
Change the site reference in the HTML to include the test site reference provided when you signed up. Update the other fields as needed, using the table below. For now, we’re only covering the required fields, but you can submit more fields if needed (click here for a full list).

 

Required fields Description
sitereference The unique reference that you receive when you sign up.
currencyiso3a The transaction currency code (in ISO3A format).
mainamount The amount of the transaction should be in main units.

Only include the amount value and the decimal place (no commas).

e.g. £10.99 would be submitted as 10.99

Currencies such as Japanese Yen which do not require a decimal place are submitted without. e.g. 1000 Yen would be 1000

version This value will be set to 2.
stprofile Used to specify the styling used to render the Payment Pages. When using the default appearance, this is set to “default” (click here for further information on profiles).

 

Note: We recommend that text submitted is encoded in UTF-8.
Special characters must be URL-encoded (e.g. “&” should be submitted as “%26”).

3
Save this as an HTML file. You can open this in your web browser, and a “Pay” button will be displayed. Click this button, and you will be redirected to your test site, where you can process test payments.

 

If you have configured the HTML above correctly, you should be able to view the following Payment Page hosted by Secure Trading:

 

4
When testing, you can use the following test card details to simulate a “Successful” response:

  • Visa card ‘4111 1111 1111 1111’ or Mastercard ‘5100 0000 0000 0511’
  • Set expiry date to any valid date in the future
  • Use security code “123”

 


 

Tick
Your progress

Now that you can process card payments, you are ready to add extra features and test your integration.

We recommend starting with setting up request site security, which protects your transactions against unauthorised modifications by the customer or other third parties.