Contents

Workflows

 

After the customer agrees to a purchase on your checkout, the customer is redirected to the Payment Pages, hosted by Secure Trading. This section describes the main workflows available to you:

 

 

Workflow A

 

  • The customer is redirected to our secure servers, where they are presented with a choice between all payment methods enabled on your account.
  • The customer selects their preferred payment method and is then prompted for their payment details.

 

Click to learn more


 

Checkout experience

 


 

1. Payment choice

 

Click to enlarge

 

 

The customer is redirected to our servers, where they select from payment methods enabled on your account.

 

 


 

2. Payment details

 

Click to enlarge

 

 

The customer is displayed a form prompting for their payment details, billing address and delivery address.

This form displays the appropriate fields for the payment method selected.

 

The billing/delivery fields can be hidden by utilizing different profiles. Click here to learn more.

 

 


 

3. 3-D secure

 

Example of ACS pop-up prompting for authentication – Click to enlarge

 

If the customer’s card supports 3-D Secure, the Access Control Server (ACS) overlay will be displayed.

For customers deemed high-risk of fraud, they may be prompted to verify their identity (e.g. enter a passcode).

However, in most cases, the customer will briefly be shown a holding message before the payment is processed, without the need for additional authentication.

 

Click here for further information on 3-D Secure.

 

After this, the customer is redirected back to Secure Trading.

 


 

4. Response

 

Click to enlarge

 

 

Finally, the customer is displayed a success message, along with the amount, currency and payment type used.

Alternatively, you can opt to have the customer redirected back to your website following successful payment.

 

 


 

If a transaction is authorised, it is not guaranteed you will receive funds.

Funds are not transferred to your account until settlement.

 


 

Configuration

Here is a template HTML form for redirecting your customers to the Payment Pages:

 


<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.

 

Here are the required fields for the form above, along with their descriptions:

 

Required fields Description
sitereference The unique reference that you receive when you sign up.
currencyiso3a The transaction currency (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”).

 

 

Workflow B

 

  • The customer is redirected to our secure servers, where they enter their payment details (under default configuration, we prompt for card details).

 

Click to learn more


 

Checkout experience

 


 

1. Payment details

 

Click to enlarge

 

When posted to our servers, the customer is prompted for their payment details and billing /delivery addresses.

 

The billing/delivery fields can be hidden by utilizing different profiles. Click here to learn more.

 


 

2. 3-D secure

Example of ACS pop-up prompting for authentication – Click to enlarge

 

If the customer’s card supports 3-D Secure, the Access Control Server (ACS) overlay will be displayed.

For customers deemed high-risk of fraud, they may be prompted to verify their identity (e.g. enter a passcode).

However, in most cases, the customer will briefly be shown a holding message before the payment is processed, without the need for additional authentication.

 

Click here for further information on 3-D Secure.

 

After this, the customer is redirected back to Secure Trading.

 


 

3. Response

 

Click to enlarge

 

Finally, the customer is displayed a success message, along with the amount, currency and payment type used.

Alternatively, you can opt to have the customer redirected back to your website following successful payment.

 


 

If a transaction is authorised, it is not guaranteed you will receive funds.

Funds are not transferred to your account until settlement.

 


 

Configuration

Here is a template HTML form for redirecting your customers to the Payment Pages:

 


<html>
<body>
<form method="POST" action="<DOMAIN>/process/payments/details">
<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.

 

Here are the required fields for the form above, along with their descriptions:

 

Required fields Description
sitereference The unique reference that you receive when you sign up.
currencyiso3a The transaction currency (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”).