Contents

Reports and notifications

Once your site has been set up to process subscriptions, it is recommended that you opt-in to receiving notifications to keep you informed of payments processed on your account by the subscription engine.

 

Subscription reports

If you would like to receive email reports that show subscription payments processed on your site, please contact our Support team.

 

Structure of email

If you have the email report enabled on your account, you will receive an email from no-reply@securetrading.com, for each day that subscription payments are processed. You will receive a maximum of one email per day. They are presented in the format of a table, with the following fields:

Field Comment
Subscription reference A unique Secure Trading reference for the subscription transaction.
Transaction reference A unique Secure Trading reference for the transaction.
Account This will match the accounttypedescription supplied within the request. This should be “RECUR”.
Request The requesttypedescription processed.
Currency The payment currency.
Settle status Indicates if the payment has settled. Click here to learn more about this field.
Auth code The authorisation code provided by the issuing bank, and will differ depending on which bank you use.
Error code Used to determine if the request was successful or not. Click here for a full list of errorcode values.
Base amount The amount in base units, with no commas or decimal points. For example, £10 would be shown as 1000.
Sitereference The sitereference identifies your individual account.
Subscription frequency The interval between payments.
Subscription number This represents the position of the transaction within a series of subscription payments. E.g. 5/10 would represent the 5th transaction out of 10.
Subscription type This is the type of subscription: “RECURRING” or “INSTALLMENT”.
(Optional) Acquirer advice code A numeric value returned, indicating if further payments can be processed. As this field is only supported by certain acquiring banks, you will need to ask our Support Team to add this to your report.

 

The following is a screenshot of an example subscription report email:

Warning
The email will be sent from no-reply@securetrading.com, with the subject “Subscription Report for [date in YYYY-MM-DD]”.

Please add a rule or filter to your email client to prevent the emails from being classified as junk mail / spam.

 

Error reports

If you would like to receive an email if a subscription transaction processed on your site returns an error, please contact our Support team.

 

Structure of email

If you have the email report enabled on your account, you will receive an email from no-reply@securetrading.com, whenever errors are encountered while processing subscription payments. You will receive a maximum of one email per day. More than one subscription can appear in one email, and are separated by spaces.

Here is an example of a subscription error email report (in this case, the customer’s card has been declined):


Problem with processing transaction 3-64-56 – 70000 Decline subscriptionnumber:2

 

Warning
The email will be sent from no-reply@securetrading.com, with the subject “STPP Subscription runsubscriptions problems”.

Please add a rule or filter to your email client to prevent the emails from being classified as junk mail / spam.

 

URL notifications

It is possible to configure URL notifications to be submitted to your system, following each payment processed on your site by the subscription engine. (One notification per transaction)

To configure this, sign in to MyST and navigate to the “Rule manager”.

If you are new to the Rule Manager, we recommend reading this information in conjunction with our Rule manager documentation.

 

1
Choose the site

Select the site through which you are processing subscriptions and the action type “URL Notification”, then click “Change”.

2
Create the condition

Create a condition for completed requests, with the following properties:

  • Account type is “RECUR”.
  • Request type is “AUTH”.
  • Select all payment types, currencies and settle statuses.
  • Error code is “0”.
3
Create the action

If you haven’t already, create a new action with the URL of your server and include the fields you would like to be included in the notification.

4
Create the rule

Using the Rule manager, assign the condition to the action, and click “Save”. Ensure the checkbox in the “Active” column in ticked, indicating the new rule is active.

5
Respond to the notification

You must configure your system to respond to a notification with an HTTP 200 OK response.

For example: “HTTP/1.0 200 OK”.

Your system must reply within 8 seconds of receiving a notification.

Click here for further information on URL notifications.

Info
Ensure you have tested the rule on your test site before applying it to your live site.