Virtual Terminal Integration V2.0 (Beta)
Updated
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
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. |
