Virtual Terminal Integration V2.0 (Beta)

Updated 8 months ago by RM

Virtual Terminal (VT) Integration Guide

BCH payment processing solutions use a single web page to process card transactions with your Payment Service Provider (PSP), it can operate with all our Live Caller payment solutions and configured to your specific transaction requirements.

The VT is available as a standalone web page, allowing agents to login manually and process transactions, see User Guide.

If you want to remove the login process for the agent and transfer transaction information directly from your CRM solution into the VT payment fields you can use this Integration Guide to create a URL which can be called when a payment is required.

To configure the input fields presented to an agent when processing a payment please see the Virtual Terminal Field Setup page

For security, access to this method is restricted only to known IP addresses that have been pre-registered within the processing platform. IP Addresses can be added and removed via the Management Portal or by contact the support team.
URL: https://pci.telecomdata.co.uk/iLogin.aspx
Authentication Parameters
Parameter Name
Required
Description

ClientID

Yes

This is your unique Account ID, and will be supplied when your account is created. If you have multiple transaction requirements, business areas or merchant accounts please talk to our support team about creating a Master and Child accounts.

AgentID

Yes

Each user with your account must be uniquely identified in order to associate the login in with a call in progress. Agent can be added via the Management Portal Applications.

Hash

Yes

To ensure your account API password is not included in plain text SHA512 hash is used instead. See details here on how to create the Hash, or if this isn't possible to speak to our support team about alternative authentication options.

Transaction Parameters

Parameter Name

Required

Description

Value

Yes

The transaction value is pence (the minor unit of the currency)

OrderID

Yes

A unique identifier that can be used to identify a transaction throughout the payment process through to finance reconciliation.

Name

No

The Customers name as it appears on the payment card.

Address1-5

No

The Customers billing address

Postcode

No

The billing address postcode

Info1-4

No

These are special input fields that can be dynamically assigned to PSP transaction Fields. Needs to be configured with the Virtual Terminal Field Setup pages via the Management Portal

Currency

No

Default is GBP, additional currencies can be added upon request to specific PSPs

Merchant

No

Can be used to select different merchant accounts within your PSP.

SMSReceipt

No

Used to instigate the optional text message receipt sent to the customer.


How did we do?