WireCard Payment Integration

About Wirecard:

With 16 years of experience on the market, Wirecard AG offers more than 19,000 customers state-of-the-art technology, transparent real time reporting services, and support in developing their international payment strategies: offline, online or mobile.

The Wirecard Group has been supporting companies in accepting electronic payments from all sales channels. A global multi-channel platform bundles international payment acceptances and methods, flanked by fraud prevention solutions. When it comes to issuing their own payment instruments in the form of cards or mobile payment solutions, Wirecard provides companies with an end-to-end infrastructure, including the requisite issuing licenses for card and account products.

As a software and IT specialist, Wirecard is also constantly expanding its portfolio with innovative payment technologies.

Implemented Features:

Feature	Level of Support
Auth	Implemented
Sale (Auth+Capture)	Implemented
Capture	Implemented
Void	Implemented
Credit	Implemented
3DS Passthrough	Implemented

Authentication and Security Credentials:

• Username
• Password
• Merchant Account ID

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”
pxyCustomerInfo.email	Alphanumeric	Optional	Customer’s Email Address
pxyCustomerInfo.customerIP	Numerical	Optional	Customer’s IP Address
pxyCustomerInfo.billingLocation.firstName	Alphabetical	Required	Customer’s First Name
pxyCustomerInfo.billingLocation.lastName	Alphabetical	Required	Customer’s Last Name
pxyCustomerInfo.billingLocation.phoneNumber	Numerical	Optional	Billing Phone Number
pxyCustomerInfo.billingLocation.address	Alphanumeric	Optional	Customer’s Billing Address
pxyCustomerInfo.billingLocation.address2	Alphanumeric	Optional	Secondary Billing Address
pxyCustomerInfo.billingLocation.city	Alphabetical	Optional	Customer’s Billing City
pxyCustomerInfo.billingLocation.state	Alphabetical	Optional	Customer’s Billing State or Province
pxyCustomerInfo.billingLocation.zipCode	Numerical	Optional	Customer’s Billing Zip Code or Postal Code
pxyCustomerInfo.billingLocation.country	Alphabetical	Optional	Customer’s Billing Country

Additional Parameters

KEY NAME	FORMAT	DESCRIPTIONS
pxyTransaction.merchantAccountName	Alphabetical	Required for Soft Descriptors
pxyTransaction.merchantProductName	Alphabetical	Required for Soft Descriptors
pxyTransaction.merchantPhoneNum	Alphabetical	Required for Soft Descriptors

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]

Wirecard 3DS implementation with Cardinal Commerce

Wirecard has been implemented with Cardinal Commerce for 3DS pass-through Authentication.

In Order to implemented 3DS Authentication with Wirecard follow the Cardinal Commerce 3D Secure documentation page.

The parameters listed on the page are required along with the mandatory AUTH transaction parameters to make a successful 3DSecure transaction.

WireCard 3DS 2.0″verifyenroll” Required Parameters

PARAMETER	VALUES
pxyThreeDSecAuth.actionName	[verifyenroll]
pxyTransaction.txnPayName	[3ds payment profile name]
pxyThreeDSecAuth.callMode	[reportall]
pxyThreeDSecAuth.authSessionId	[cruiseSessionId returned within threeDSValuesObj in hpciSiteSuccessHandlerV4 and later versions]

Additional Parameter ‘verifyresp’ call

pxyThreeDSecAuth.authCAVV	[CAVV]
pxyThreeDSecAuth.authECI	[authECI]
pxyThreeDSecAuth.authStatus	[Y]
pxyThreeDSecAuth.authTxnId	[authTxnId]
pxyThreeDSecAuth.messageId	[pxyResponse.threeDSMessageId from verifyenroll call]
pxyThreeDSecAuth.protocolVersion	[pxyResponse.threeDSProtoVersion from verifyenroll call]