support@protx.com
 

Transaction / Payment Types (TxTypes) : Repeat Transactions
 
 
Quick Links:
 


 What is a Repeat?
 


A REPEAT on transaction will use all the information provided within the transaction and go through the payment process again in the same way as a real-time payment (i.e. it will go for authorisation and be sent for settlement)

Back to top


 How do I Repeat a transaction via my website?
 


Repeating a transaction can be done automatically by your server should you process a large volume of transactions or wish to automate the transaction process. (for VSP Direct and VSP Server Users only)


To perform this task automatically, you will be required to capture and store additional information which is sent to you from Protx in regard to each transaction.

With this additional information you simply send a REPEAT POST request to our servers from yours:


Name Values Comments
VPSProtocol 2.22 in this release
Default or incorrect value is taken to be 2.00

TxType REPEAT or REPEATDEFERRED
Transaction type. Should be in Capital letters.

Vendor Vendor Login Name
Used to authenticate your site. This should contain the VSP Vendor Name supplied by Protx when your account was created.

VendorTxCode Vendor Transaction Code
This should be your own reference code to this REPEAT transaction. Your servers should provide a completely unique VendorTxCode for each transaction.

Amount Amount to REPEAT
  You can take a REPEAT transaction for any amount, irrespective of the amount of the original transaction.

Currency Three-letter currency code to ISO 4217 e.g: GBP, EUR and USD
The currency must be supported by one of your VSP merchant accounts or the transaction will be rejected. You can REPEAT a currency that is active on your account, irrespective of the currency of the original transaction.

Description Free text description of reason for REPEAT
Stored against the REPEAT for your future reference via the VSP Admin screens.

RelatedVPSTxId Transaction ID of the original Transaction
VPSTxId from the previous Transaction against which the REPEAT is required.

  RelatedVendorTxCode     Vendor Transaction   Code of original transaction
VendorTxCode for the original payment Transaction to REPEAT against.

RelatedSecurityKey Security Key for the original transaction
The SecurityKey of the original transaction sent back by the VSP System when the transaction was registered.

RelatedTxAuthNo Authorisation code for the original transaction
The TxAuthNo of the original transaction as returned by the VSP system when it was authorised.





(More information can be found by downloading the "VSP Server and Direct Shared Protocols" document)

N.B: This method is available ONLY to those that use our VSP Server or VSP Direct Payment solutions.

Back to top


 How do I Repeat a transaction via my VSP Admin area?
 


A REPEAT can also be performed via the VSP admin area for any AUTHORISED transaction.

Before logging on to your Protx VSP Admin account, you need to ensure that you have granted the Repeat privilege to your 'User' that you intend to use to perform the Repeat transaction.

Once logged on, you will need to find the Authorised transaction you wish to Repeat.

You can search for the transaction by using either of the search tools, 'The Daily transaction List' or the 'Find a Transaction', both from under 'Transactions' in the menu.

If you use the 'Daily Transaction List' as the search, then obviously you will need to have a fair idea of the date of the transaction and the name of the cardholder (shopper). The results of the search would then be displayed as shown below;





Click on the actual 'VendorTxCode' of the Authorised transaction that needs Repeating. If you wanted to Repeat Protx Test 4 (as per the screenshot above), then you would click on 'VSPT-testvendor-060815195015-543'

The full transaction detail will now be displayed in a new browser window - If you scroll to the bottom of the page you should see a section of further options called 'Actions' (see screenshot below)



Click on the 'Repeat' button

If the Repeat button is not displayed, it could mean one of two things;
  •   You have not granted the User account with the Repeat privilege.
  •   The transaction you are attmepting to Repeat is actually a Refund, Deferred or already failed transaction.
Once the Repeat button has been clicked you will be presented with a Repeat confirmation screen (screenshot shown below) - You will need to enter the amount you wish to Repeat (this can be for any amount between £1.00 and £100,000.00), the currency you wish to Repeat in (if you have multiple currencies available) and a short description (optional). Unlike Deferred transactions, Authorised transactions need to be Repeated individually. The reason being that a Authorised transaction can be Repeated for a sum greater than or less than the original authenticated amount.

Now just click the 'Repeat' button again

The Repeat request will be sent to your acquiring bank for authorisation and the result will be retuned as 'Authorised' or 'Declined'.





Once the Repeat has been sent to the acquiring bank for authorisation, depending on whether it was 'Authorised' or 'Declined', it will appear under 'Authorised Transactions' if the Repeat was successful or under the 'Failed Transactions' section if the Repeat was declined.

The below screenshot shows the Repeat, performed above, in the 'Authorised Transactions' section of the VSP Admin account.




 How do I Void a Repeat transaction?
 


If you are unable to fulfil the order or do not wish to continue with the transaction, you can VOID any repeat transactions made. This will fail the transaction which in turn will not be allowed to continue the payment process and therefore stop the transaction from being sent for settlement. This will mean the Shopper will never be charged, however the Shopper may still have an active bank shadow on their account.

Voiding a REPEAT transaction can be done either:

  •   Automatically by your server should you process a large volume of transactions or wish   to automate the transaction process (for VSP Direct and VSP Server Users only).


  •   Manually via the VSP admin area.


To perform this task automatically, you will be required to capture and store additional information which is sent to you from Protx with regards to each repeated transaction.

With this additional information you simply send a VOID POST request to our servers from yours:


Name Values Comments
VPSProtocol 2.22 in this release
Default or incorrect value is taken to be 2.00

TxType VOID
Transaction type. Should be in Capital letters.

Vendor Vendor Login Name
Used to authenticate your site. This should contain the VSP Vendor Name supplied by Protx when your account was created.

VendorTxCode Vendor Transaction Code of transaction to be VOIDED
Your servers previously provided the above VendorTxCode for the transaction you now wish to VOID.

VPSTxId The VPS Transaction ID for the original transaction
As sent back by the VSP system when the original transaction was registered.

SecurityKey Security Key for the original transaction
The SecurityKey of the original transaction sent back by the VSP System when the transaction was registered.

TxAuthNo Authorisation code for the original transaction
The TxAuthNo of the original transaction as returned by the VSP system when it was authorised.





(More information can be found by downloading the "VSP Server and Direct Shared Protocols" document)

N.B: This method is available ONLY to those that use our VSP Server or VSP Direct Payment solutions.

A VOID can also be performed via the VSP admin area, for information on how to perform a VOID, please click here

Back to top


 How do I Refund a Repeat transaction?
 


If the REPEAT transaction has been sent for settlement but you are unable to fulfill the order or wish to cancel the transaction, you will have to REFUND the repeat transaction. This will send a REFUND transaction for settlement to inform the acquiring bank to credit the funds back into the Shopper's account.

Refunding a REPEAT transaction can be done either:
  •   Automatically by your server should you process a large volume of transactions or wish   to automate the transaction process (for VSP Direct and VSP Server Users only).


  •   Manually via the VSP admin area.


To perform this task automatically, you will be required to capture and store additional information which is sent to you from Protx with regards to each repeat transaction.

With this additional information you simply send a REFUND POST request to our servers from yours:


Name Values Comments
VPSProtocol 2.22 in this release
Default or incorrect value is taken to be 2.00

TxType REFUND
Transaction type. Should be in Capital letters.

Vendor Vendor Login Name
Used to authenticate your site. This should contain the VSP Vendor Name supplied by Protx when your account was created.

VendorTxCode Vendor Transaction Code
This should be your own reference code to this REFUND transaction. Your servers should provide a completely unique VendorTxCode for each transaction.

Amount Amount to Refund
  IMPORTANT NOTE: You can make multiple   refunds against a single transaction but the   total value of all refunds CANNOT exceed the amount of the original transaction.

Currency Three-letter currency code to ISO 4217 e.g: GBP, EUR and USD
The currency must be supported by one of your   VSP merchant accounts or the transaction will   be rejected.

Description Free text description of reason for Refund
Stored against the refund for your future reference via the VSP Admin screens.

RelatedVPSTxId Transaction ID of the original Transaction
VPSTxId from the previous REPEAT Transaction against which the Refund is required.

  RelatedVendorTxCode     Vendor Transaction   Code of original REPEAT transaction
VendorTxCode for the original REPEAT Transaction to refund against.

RelatedSecurityKey Security Key for the original transaction
The SecurityKey of the original REPEAT transaction sent back by the VSP System when the transaction was registered.

RelatedTxAuthNo Authorisation code for the original transaction
The TxAuthNo of the original REPEAT transaction as returned by the VSP system when it was authorised.





(More information can be found by downloading the "VSP Server and Direct Shared Protocols" document)

N.B: This method is available ONLY to those that use our VSP Server or VSP Direct Payment solutions.

A REFUND can also be performed via the VSP admin area, for information on how to perform a REFUND, please click here

Back to top