Skip to main content

Online payments

Virtual Terminal

Last updated: 16-Apr-2024

Overview

The Virtual Terminal is a tool that can be used to initiate payments for card-not-present (CNP) transactions. Virtual Terminal allows merchants to accept payments over the telephone or email. When the cardholder shares their card details over the phone or via email, the merchant must comply with PCI DSS obligations and  securely store the card details.

Payment triggered by the Virtual Terminal can be actions like captured, refunded, canceled or voided via the transaction details available in the Transaction Reports. 

The Virtual Terminal capabilities include pre-authorization which can be followed-up manually by a capture. Currently, supported service providers are ABS, EFTPOS NZ, and NETS.

Combining 3-D Secure and mail or telephone orders is not possible.

Requirements

   Before you start using the Virtual Terminal and in order to start accepting eCommerce transactions, you will need to generate a Secure Card Capture Key.

Access

Your level of access determines if you can process payments via the Virtual Terminal.

✅ Access:

  • Merchant Cashier — Initiate payment and cancel/void payment
  • Merchant Supervisor — Initiate payment, capture/refund/cancel/void payment

🚫 No access:

  • Merchant Admin
  • Merchant Reviewer
  • Merchant User

How to use the Virtual Terminal  

Payment settings

You must set the following configurations to initiate the payment: 

Virtual Terminal first screen

  1. Select your Organization. The Organization drop-down list is displayed only if your user has access to more than one organization and there are more than 20 applicable Payment Provider Contracts.

  2. Select the Payment Provider Contract (PPC) linked to your organization. The payment provider contract is configured to accept a set of payment methods. If the organization has only one PPC, the PPC drop-down list will not be displayed.

       For Virtual Terminal the Payment Provider Contract needs to have mail/telephone (MOTO) available as sales channel.
    If the Allow unmatched refunds option is enabled for your Payment Provide Contract, the Unlinked refund checkbox will be displayed. For more information check the Unmatched Refunds documentation.
  3. Select your Transaction Type. Depending on your Organization setup, you may have two options: Sale (for single purchases) and Recurring (see the Stored credentials documentation.)

  4. Select the Authorization Type (Authorization, Authorization with capture or PreAuthorization - see more details in Payment flow documentation). 

       Note: The transaction and authorization types are displayed only if they are  supported by the chosen processor. 
  5. Enter the value of the payment in the Amount field. The currency code will be determined based on the Payment Provider Contract. If a contract is configured to process multiple currencies, the currency code field will be a select box.

  6. The Merchant Reference (optional) is either an Order ID from the ordering system or a random string. The purpose for this field is to accommodate for the merchants' own administration. If no information is entered, a default value of DefaultMerch will be used.

  7. The Transaction Description (optional) is the information which will show up on the customers bank statement. Doing Business As (DBA name) — required when registering with the schemes. If the dynamic descriptor is not being used, the Doing Business As (DBA) name will be used as reference on the bank statement.

  8. For the Israel market, the Virtual Terminal also supports new transaction types: installments, sale preferred Isracard and Sale Direct Debit. Additional information on instalments can be found here.

  9. The Promo Code (optional) field can be completed with a code offered by the merchant to customers who can use it to receive a discounted price when buying products online.

  10. Once the configuration has been completed, click on Continue to Payment to proceed to the next step.

Payment form

On the next page, you will see the Payment form. Here, you input the customer's card number, expiration date, and CVV.

Payment form

   Make sure you store the Merchant Reference for your records. 
  1. Enter the Card Number, Expiration date, and CVV.
  2. Click on Pay to complete the transaction, or only authorize the funds.

Payment status

Once a transaction is completed successfully, a confirmation will be displayed.

VT transaction processed

You can now do the following: 

  • Click on New Transaction to start a new transaction
  • Click on More Details to review transaction details

The transaction can be found in Transactions report by searching for the Merchant Reference.

VT in reports

If you are using Woodforest or Worldpay US as an acquirer, the Payment status page will also include the Authorization code.

    If the transaction failed, the page would look like this:

    VT Transaction failed

    Merchant action scenarios

    Once all the payment settings are configured, you enter the card number. The card number is the customer's card number. After typing in the first six digits, the form displays which brand the card is.

    Here is an overview of the various scenarios:

    Card type Card validated Portal display Merchant actions Additional actions
    Single brand Y Card brand provided Fill in the expiration date of the customer's card If the transaction is authorized, a confirmation screen is shown.
    Single brand N

    An error message is displayed. 

    If the expiration date is in the past, an error message explains what is wrong with the input.

    Choose to ask for the CVV or not.

    • Store how the card details were received (Telephone/Mail)
    • Initiate the payment

    If the CVV check is negative, highlight the result.

    Example: The CVV does not match the required length.

    Ask the user which payment action should be taken - cancel or refund.

    Dual-branded Y
    • If the PPC is configured for one of the brands and the brand that is not configured cannot be selected.
    • If the PPC is configured for both brands, the cashier can ask the cardholder which scheme to process the transaction.

    Choose to ask for the CVV or not.

    • Store how the card details were received (Telephone/Mail)
    • Initiate the payment
    If the transaction is authorized, a confirmation screen is shown
    Dual-branded N If the bin lookup fails, an error message is shown to the user Choose to ask for the CVV or not

    The user initiates the payment.

    If the CVV check is negative, highlight the result.

    Ask the user which payment action should be taken - cancel or refund.

    Transactions with Stored Credentials

    Stored Credential Payments through the Virtual Terminal follow the same flow as any other Payments through the Virtual Terminal.

    There are two types of recurring transactions: SIGN-UP and CHARGE.

    The Sign-up transaction is the initial transaction used to actually enroll the shopper for a recurring sequence.

    The Charge transaction is (one of) the transactions done with a re-use token, which was created with the Sign-up transaction.

    Verifone's Virtual Terminal allows merchants in Israel to do Stored Credential Transactions via UI. The Virtual Terminal UI enables filling out Stored Credential Framework-specific fields as part of MOTO Transactions.

    ABS transactions - functional aspects

    Virtual Terminal supports recurring transactions using ABS WEB provider. 

    The following Stored Credentials Framework-specific functionality is present on the Payment settings page. You need to perform the following steps:

    1. Select Transaction Type Recurring.

    2. Use the checkbox to indicate if the Transaction intended to be done is a Sign-up Transaction. If it is ticked, the following Stored Credential-specific fields are shown:

      • Token scope: As a drop-down menu, the possibility to select the Token Scope to be used for this Transaction
      • Total number of payments: An optional field asking for the count of total number of payments, where the field accepts any number value without validation
      • Total value: An optional field asking for the total value of all the Transactions following this Sign-up Transaction. The amount field accepts any number value without validation.
      • Processing model: A radio button offering a selection between the available Stored Credential processing models, which can be:
        • Recurring
          • If the Recurring processing model is selected, then the following additional field is shown:
            • Frequency: A field asking for the frequency of the following Charge Transactions. The amount field accepts any number value without validation up to a maximum of 52.
        • None
          • If the None processing model is selected, then the following additional field is shown:
            • Merchant sign-up code: An optional field asking for the Merchant sign-up code.
      • Amount: A field asking for the Transaction amount. If it is a Sign-up Transaction for ABS, the Transaction amount is fixed 0.01.
         For ABS, a Sign-up Transaction is a Pre-Authorization Transaction that should not be Captured.
    3. Leave the box unchecked if the Transaction intended is a Charge Transaction. If it is unticked, the following Stored Credential-specific fields are shown:

      • Sign-up reference: A field asking for the reference received for a Sign-up Transaction, which can be:
        • ABS UID
        • Verifone Stored Credential Reference
      • Standing order number: An optional field asking for the sequence number of this Charge Transaction. The field accepts any number value without validation.
      • Processing model: A radio button offering a selection between the available Stored Credential processing models, which can be:
        • Recurring
        • Unscheduled Credential on File

    Woodforest and Worldpay US transactions - functional aspects

    Virtual Terminal supports recurring transactions using the Woodforest and Worldpay US providers. The sign up transaction must be created using ecommerce API.

    The following Stored Credentials Framework-specific functionality is present on the Payment settings page. You need to perform the following steps:

    1. Select Transaction Type Recurring.

    2. Use the checkbox to indicate if the Transaction intended to be done is a Sign-up Transaction. If it is ticked, the following Stored Credential-specific fields are shown:

      Details on use cases for stored credentials can be found in the article located here.

      • Amount: A field asking for the Transaction amount
      • Amount is taxable: A checkbox you need to click on if the amount is to be taxed. 
      • Tax Amount: The amount of tax to be paid on the purchase. This is only displayed if the Amount is taxable checkbox is checked. 
      • PO Number (Purchase Order Number): The number of the purchase as assigned by you. 
      • Merchant Reference: Optional field that can be used to pass an internal reference ID
      • Transaction Description: Optional field that can be used to pass information directly on the customer's bank statement
    3. Leave the box unchecked if the Transaction intended is a Charge Transaction. If it is unticked, the following Stored Credential-specific fields are shown:

      • Sign-up reference: A field asking for the reference received for a Sign-up Transaction, which can be:
        • Verifone Stored Credential Reference
      • Processing model: A radio button offering a selection between the available Stored Credential processing models, which can be:
        • Credential on File
        • Recurring
        • Unscheduled Credential on File

    VT Recurring

    Need help?

    Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

    Not yet a Verifone customer?

    We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

    Verifone logo