About First Data Virtual Terminal:
The Global Gateway Virtual Terminal is an online payment application that allows you to accept credit cards and other payment types using your PC. The Virtual Terminal also acts as your Global Gateway account management application and allows you to view gateway processing reports, edit fraud settings, manage users, and more.
Implemented Features:
Feature |
Level of Support |
Auth |
Implemented |
Sale (Auth+Capture) |
Implemented |
Capture |
Implemented |
Void |
Implemented |
Credit |
Implemented |
Authentication and Security Credentials:
Supported Parameters:
Key Name |
Format |
Mandatory |
Descriptions |
apiVersion |
Numerical |
Required |
“1.0.1” |
apiType |
Alphabetical |
Required |
“pxyhpci” |
userName |
Alphanumeric |
Required |
API Username |
userPassKey |
Alphanumeric |
Required |
API PassKey |
pxyCreditCard.creditCardNumber |
Numerical |
Required |
HostedPCI Token Representing Credit Card |
pxy.CreditCard.cardCodeVerification |
Numerical |
Optional |
HostedPCI Token Representing CVV Code |
pxyCreditCard.expirationMonth |
Numerical |
Required |
Expiration month with 2 digits for example, for December use “12” |
pxyCreditCard.expirationYear |
Numerical |
Required |
Expiration year with 4 digits for example, for 2025, use “2025” |
pxyTransaction.txnCurISO |
Alphabetical |
Required |
3 letter ISO Currency Code for example, “USD” or “CAD” |
pxyTransaction.txnAmount |
Numerical |
Required |
Amount to Authorize, for example for $10.50 use 10.50 |
pxyTransaction.merchantRefId |
Numerical |
Required |
Merchant reference number can be order id or invoice id |
pxyTransaction.txnPayName |
Alphanumeric |
Required |
HostedPCI payment profile name, for example “DEF” |
pxyTransaction.txnComment |
Alphabetical |
Optional |
Short comment |
pxyCustomerInfo.email |
Alphanumeric |
Optional |
Customer’s Email Address |
pxyLocation.companyName |
Alphanumeric |
Optional |
Company Name |
pxyLocation.firstName |
Alphabetical |
Optional |
Customer’s First Name |
pxyLocation.lastName |
Alphabetical |
Optional |
Customer’s Last Name |
pxyLocation.phoneNumber |
Numerical |
Optional |
Customer Phone Number |
pxyLocation.fax |
Numerical |
Optional |
Fax Number |
pxyLocation.addressNumber |
Numerical |
Optional |
Customer Street Number |
pxyLocation.address |
Alphabetical |
Optional |
Customer’s Street Name |
pxyLocation.address2 |
Alphanumeric |
Optional |
Secondary Billing Address |
pxyLocation.city |
Alphabetical |
Optional |
Billing City |
pxyLocation.state |
Alphabetical |
Optional |
Billing State/Province |
pxyLocation.country |
Alphabetical |
Optional |
Billing Country |
API Endpoint URL:
https://[HPCI_API_HOSTENAME]/iSynSApp/paymentAuth.action
API Request Body:
apiVersion=1.0.1&apiType=pxyhpci&userName=[APIuserName]&userPassKey=[APIPassKey]&pxyCreditCard.creditCardNumber=[CreditCardToken]&pxyCreditCard.cardCodeVerification=[CVVToken]&pxyCreditCard.expirationMonth=[ExpiryMonth]&pxyCreditCard.expirationYear=[ExpiryYear]&pxyTransaction.txnCurISO=[Currency]&pxyTransaction.txnAmount=[Amount]&pxyTransaction.merchantRefId=[UniqueMerchantRefID]&pxyTransaction.txnPayName=[ProfileName]&pxyTransaction.txnComment=[ShortComment]&pxyCustomerInfo.billingLocation.firstName=[CustomerFirstName]&pxyCustomerInfo.billingLocation.lastName=[CustomerLastName]&pxyCustomerInfo.billingLocation.address=[BillingStreetAddress]&pxyCustomerInfo.billingLocation.city=[BillingCity]&pxyCustomerInfo.billingLocation.state=[State/Province]&pxyCustomerInfo.billingLocation.zipCode=[ZipCode/PostalCode]&pxyCustomerInfo.billingLocation.country=[Country]&pxyCustomerInfo.shippingLocation.firstName=[ShippingFirstName]&pxyCustomerInfo.shippingLocation.lastName=[ShippingLastName]&pxyCustomerInfo.shippingLocation.address=[ShippingStreetAddress]&pxyCustomerInfo.shippingLocation.city=[ShippingCity]&pxyCustomerInfo.shippingLocation.state=[ShippingState/Province]&pxyCustomerInfo.shippingLocation.zipCode=[ShippingZipCode/PostalCode]&pxyCustomerInfo.shippingLocation.country=[ShippingCountry]