support@protx.com
 

Transaction / Payment Types (TxTypes) : Manual Payments
 
 
Quick Links:
 


 What is a Manual transaction?
 


A MANUAL transaction payment skips the normal payment process, in the sense that thisparticular transaction has not been authorised through the Protx VSP Systems. It allows you to directly settle the transaction with your bank.

Back to top


 When would I need to process a Manual transaction?
 


The most common reason for using this payment type would be when some transactions, for example high value transactions, will not be authorised immediately online by your acquiring bank. This is because the transaction is a REFERRAL, whereby the shopper's bank would like to perform further security checks on the card before authorising the transaction, or would like to speak to the shopper directly before allowing the authorisation to go through.

Other instances where you could use MANUAL Transaction are:

  •   When the authorisation of a PREAUTH transaction has not yet been reversed by the card   issuer and upon 'repeating' the PREAUTH transaction to complete the payment, it is   declined because of the shadow on the Shopper's card.

      Should this occur you will need to obtain the shopper's card details and the original   authorisation code from Protx and then process the transaction via your VSP terminal.   For more information on the PREAUTH / REPEAT payment type, please click here


  •   When you are completely satisfied with the fraud results and the authenticity of the   shopper, but, due to the AVS/CV2 checks and rule base the transaction was rejected.   In this instance you can request from your shopper to provide you with their card   details and then contact us to obtain the original bank authorisations code.

      N.B: This can only be done when the banks have ignored the online reversal and there is   still the original shadow on the shoppers account.
Back to top


 How does a manual transactions work?
 


Once you have obtained the bank authorisation code from Protx for the original transaction, you can submit a manual transaction through the Protx VSP system which will then be settled like any other transaction made through Protx.

You will be required to send this transaction through our server again containing all the relevant information such as the shopper (CUSTOMER) name, card number, expiry date etc. Either through the VSP terminal interface within the admin area, or through a server side POST to Protx (for VSP Server and VSP Direct vendors only).

Once the transaction has been processed, it will appear under the relevant heading:

      


Back to top


 How do I set up my site to use the Manual transaction type?
 


If you wish to use this payment type you need to request to have it enabled on your Protx account by emailing the support team, stating your VSP Vendor name.

To perform this task automatically, you will be required to obtain payment details from the shopper.

With this additional information you simply send a MANUAL POST request to our servers from yours. The mandatory information which needs to be captured and sent is as follows:


Name Values Comments
VPSProtocol
2.22 in this release

Default or incorrect value is taken to be 2.00

TxType
MANUAL

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 the original transaction.

Amount
Amount for the Transaction containing minor digits formatted to 2 decimal places where appropriate

Must be positive and numeric, and may include a decimal place where appropriate. Minor digits should be formatted to two decimal places. e.g. 5.10, or 3.29. Values such as 3.235 and 2.3 will be rejected.

Currency
Three-letter currency code to ISO 4217 Examples: 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 goods or services being purchased

The description of goods purchased is displayed in the Administrative screens for your future reference.

CardHolder
The card holder's name

This should be the name displayed on the card.

CardNumber
The credit or debit card number with no spaces

The full card number is required.

ExpiryDate
The Expiry date (required for ALL cards) in MMYY format

The expiry date MUST be in MMYY format i.e. 1206 for December 2006. No other characters should be included.

CardType
VISA, MC, DELTA, SOLO, SWITCH, UKE, AMEX or DC

MC is MasterCard, UKE is Visa Electron. AMEX (American Express) and DC (Diners Club) can only be accepted if you have additional merchant accounts with those acquirers.



(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 perform a Manual transaction with the VSP Terminal?
 


If you wish to use this payment type you need to request to have it enabled on your Protx account by emailing the support team, stating your VSP Vendor name.

A MANUAL payment can also be performed via the VSP admin area, by simply selecting the MANUAL payment type from the transaction type drop down menu on the VSP Terminal Interface.

      


This is the second page of the VSP Terminal transaction registration page where the manual authorisation code is entered:


      

Back to top


 Are there limitations to Manual transactions?
 


  •   AVS/CV2 checks will not be carried out and manual transactions bypass the   authorisation process.


  •   Manual payment transactions can be VOIDED, if done on the same day, however, you   will NOT be able to REFUND these payments through the protx VSP system. This is   because the transaction bypassed the authorisation process and no additional   information regarding the authorisation is stored within our database for this transaction.


  •   If a refund is required, you will need to request this from your acquiring bank.


  •   There is no guarantee that you will obtain the funds should the shopper/bank provide   you with an incorrect authorisation number for that transaction.

Back to top