Get more secure payment processing with point-to-point encryption (P2PE) provided through devices from industry-leading hardware manufacturers. Express maximizes card data protection and transaction security from the point of swipe all the way to authorization. All of our EMV capable devices support P2PE. This document provides information on using an encrypted device via direct integration with the Express processing platform.
Worldpay is 2.0 P2PE validated with IDTech SecuRED and SREDKey and Verifone MX series and VX series. Developers looking to integrate equipment via triPOS will utilize the API specific to their distribution Direct, Cloud, or Mobile.
Developers Need To Know
- The device must be encrypted with an Express encryption key, and depending on your integration method, may or may not support keyboard-emulation.
- Encrypted Swiped/Keyed Data and Card Data Key Serial Number alpha characters should be capitalized when submitted to the Express platform.
Input Fields
Name | Value | I/O | Max | Object | Description |
|---|---|---|---|---|---|
EncryptedTrack1Data | String | I | 300 | Card | Encrypted Track 1 data |
EncryptedTrack2Data | String | I | 200 | Card | Encrypted Track 2 data |
EncryptedCardData | String | I | 200 | Card | Encrypted card (keyed) data |
CardDataKeySerialNumber | String | I | 26 | Card | Card data key serial number |
EncryptedFormat | Enum | I | 2 | Card | Terminal encryption format: XML input/SOAP input (description) ** 0/Default (Default) ** 1/Format1 (MagTek) ** 2/Format2 (IngenicoDPP) ** 3/Format3 (IngenicoOn-Guard) ** 4/Format4 (ID Tech) ** 5/Format5 (VerifoneVxdevices) ** 6/Format6 (IPC devices) ** 7/Format7 (VerifoneMxdevices) |
TerminalSerialNumber | String | I | 40 | Terminal | Device serial number |
Field Names and Attributes
Note All fields are listed for clarity. If a field is not used, it need not be present in the XML.
Field Name | Attributes |
|---|---|
DvcMsg | Ver= Device Message Version |
Dvc | App= Application Name AppVer= Application Version DvcType= Device Type DvcSN= Device Serial Number Entry=CardEntryMethod(SWIPE, MANUAL, ...) |
Card | ETrk1= Encrypted Track 1 ETrk2= Encrypted Track 2 ECData= Encrypted Card Data (Card Number=ExpDate=Security Code) CDataKSN= Card Data KSN DbtPINB= Debit PIN DbtKSN= Debit KSN MskPAN= Masked PAN Exp= Expiration Date CHolder= Cardholder Name EFormat= Encrypted Format |
Addr | AVSAddr= AVS Address AVSZip= AVSZipcode |
Tran | TranType= (CREDIT, DEBIT, ...) Amt= Amount TipAmt= Tip Amount SigCap= Signature Capture (Base64 encoded) CashBackAmt= Cash Back Amount |
XML Example - Credit Card Swipe
<DvcMsg Ver=”1.2”>
<Dvc
App=”EDGE”
AppVer=”2.2”
DvcType = “ElementPinPad”
DvcSN=”002044004256” Entry=”SWIPE”>
</Dvc>
<Card
ETrk2=” F753F933E3C1177DAA0BF09270365E1FE58C265E97EF44C752C3D94A3CA97471A371A95563C916DA”
CDataKSN=” A08B000C0000002000E6”
MskPAN="4003********6781"
CHolder="GLOBAL PAYMENTS TEST CARD/”>
</Card>
<Tran
TranType=”CREDIT”
TipAmt=”5.52”>
</Tran>
</DvcMsg>
CrLf
XML Example - Credit Card Manually Keyed
<DvcMsg Ver=”1.2”>
<Dvc
App=”EDGE”
AppVer=”2.2”
DvcType = “ElementPinPad”
DvcSN=”002044004256”
Entry=”MANUAL”>
</Dvc>
<Card
ECData=” D7DBAD35858E484D0CC7FF3DE0914CE4426B08FB04455B4D210F45C75AA1727CD58026F4333640E11244AA13C1D4B2F2”
CDataKSN=”A08B000C0000002000E6”
Exp=”1012”
MskPAN="4003********6781"
CHolder="GLOBAL PAYMENTS TEST CARD/"
DbtPINB =””
DbtKSN=””>
</Card>
<Addr
AVSAddr=”123”
AVSZip=”91111”>
</Addr>
<Tran
TranType=”CREDIT”
TipAmt=”5.52”>
</Tran>
</DvcMsg>
CrLf
XML Example - Debit Card Swipe
<DvcMsg Ver=”1.2”>
<Dvc
App=”EDGE”
AppVer=”2.2”
DvcType = “ElementPinPad”
DvcSN=”002044004256”
Entry=”SWIPE”>
</Dvc>
<Card
ETrk2=” F753F933E3C1177DAA0BF09270365E1FE58C265E97EF44C752C3D94A3CA97471A371A95563C916DA”
CDataKSN=”A08B000C0000002000E6”
Exp=”1012”
MskPAN="4003********6781"
CHolder="GLOBAL PAYMENTS TEST CARD/"
DbtPINB =” 785AB86460106585”
DbtKSN=” FFFF3D0100000480002F”>
</Card>
<Tran
TranType=”DEBIT”
TipAmt=”5.52”>
</Tran>
</DvcMsg>
CrLf
Mapping from XML to Express Interface Specification Fields
Transaction Type | XML | ExpressPayfield |
|---|---|---|
Credit Card Swipe | ETrk1 OR ETrk2 | EncryptedTrack1Data OR EncryptedTrack2Data |
CDataKSN | CardDataKeySerialNumber | |
EFormat | EncryptedFormat | |
DvcSN | TerminalSerialNumber | |
Credit Card Manually Keyed | ECData | EncryptedCardData |
CDataKSN | CardDataKeySerialNumber | |
EFormat | EncryptedFormat | |
DvcSN | TerminalSerialNumber | |
Debit Card Swipe | ETrk2 | EncryptedTrack2Data |
CDataKSN | CardDataKeySerialNumber | |
EFormat | EncryptedFormat | |
DbtPINB | PINBlock | |
DbtKSN | KeySerialNumber | |
DvcSN | TerminalSerialNumber |