Paypal Gateway 2012 Developers Guide Developer And Reference
Gateway - 2012 - Developer Guide and Reference PP_PayflowGateway_2012 Free User Guide for PayPal Software, Manual
2015-07-27
: Paypal Paypal-Gateway-2012-Developers-Guide-777943 paypal-gateway-2012-developers-guide-777943 paypal pdf
Open the PDF directly: View PDF .
Page Count: 230
Download | ![]() |
Open PDF In Browser | View PDF |
Gateway Developer Guide and Reference PayPal Payments Advanced PayPal Payments Pro Payflow Pro Payflow Link Last updated: 31 July 2012 Gateway Developer Guide and Reference Document Number: 200045.en_US-20120731 © 2012 PayPal, Inc. All rights reserved. PayPal is a registered trademark of PayPal, Inc. The PayPal logo is a trademark of PayPal, Inc. Other trademarks and brands are the property of their respective owners. The information in this document belongs to PayPal, Inc. It may not be used, reproduced or disclosed without the written approval of PayPal, Inc. Copyright © PayPal. All rights reserved. PayPal (Europe) S.à r.l. et Cie., S.C.A., Société en Commandite par Actions. Registered office: 22-24 Boulevard Royal, L-2449, Luxembourg, R.C.S. Luxembourg B 118 349. Consumer advisory: The PayPal™ payment service is regarded as a stored value facility under Singapore law. As such, it does not require the approval of the Monetary Authority of Singapore. You are advised to read the terms and conditions carefully. Notice of non-liability: PayPal, Inc. is providing the information in this document to you “AS-IS” with all faults. PayPal, Inc. makes no warranties of any kind (whether express, implied or statutory) with respect to the information contained herein. PayPal, Inc. assumes no liability for damages (whether direct or indirect), caused by errors or omissions, or resulting from the use of this document or the information contained in this document or resulting from the application or use of the product or service described herein. PayPal, Inc. reserves the right to make changes to any information herein without further notice. Content Chapter P Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Who Should Use This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Chapter 1 Introducing the Gateway Checkout Solutions . . . . . . . . 19 About the Gateway Checkout Solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Summary of the Gateway Checkout Solutions . . . . . . . . . . . . . . . . . . . . . 19 Gateway Product Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 About the Gateway Transaction Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 About Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Secure Token . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Hosted Checkout Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 PCI Compliance Without Hosted Pages: Transparent Redirect . . . . . . . . . . . . . 24 Processing Platforms Supporting Card-Present Transactions . . . . . . . . . . . . . . . . 24 Supported Payment Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Recurring Billing Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Chapter 2 Secure Token . . . . . . . . . . . . . . . . . . . . . . . . 27 About the Secure Token . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Integrating the Secure Token With the Hosted Checkout Pages . . . . . . . . . . . . . . 27 Integrating the Secure Token Without the Hosted Checkout Pages: Transparent Redirect . 28 Posting To the Hosted Checkout Page . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Chapter 3 Configuring Hosted Checkout Pages . . . . . . . . . . . . 31 Configuring Hosted Checkout Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Configuring Hosted Pages Using PayPal Manager . . . . . . . . . . . . . . . . . . . . . 31 Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Customize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Gateway Developer Guide and Reference 31 July 2012 3 Content Using a Secure Token and Dynamically Passing Form Post Variables . . . . . . . . . . . 36 Silent Posts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Force Silent Post Confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Data Returned by the Silent Post Features . . . . . . . . . . . . . . . . . . . . . . . 39 Chapter 4 Payflow SDK . . . . . . . . . . . . . . . . . . . . . . . . . 41 Preparing the Payflow Gateway Client Application . . . . . . . . . . . . . . . . . . . . . 41 Activating Your Payflow Gateway Account. . . . . . . . . . . . . . . . . . . . . . . . . . 42 Host URL Addresses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Chapter 5 Sending a Simple Transaction to the Server . . . . . . . . 43 About Name-Value Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Using Special Characters In Values . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Name-Value Parameter Syntax Guidelines . . . . . . . . . . . . . . . . . . . . . . . 44 Do Not URL Encode Name-Value Parameter Data . . . . . . . . . . . . . . . . . . . 44 Payflow Connection Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 User Parameter Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Sale Transaction Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Typical Sale Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Formatting Payflow Gateway Transactions . . . . . . . . . . . . . . . . . . . . . . . . . 46 Chapter 6 Submitting Credit Card Transactions . . . . . . . . . . . . 47 Obtaining an Internet Merchant Account . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 About Credit Card Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Credit Card Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Planning Your Gateway Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Complying With E-commerce Indicator . . . . . . . . . . . . . . . . . . . . . . . . . 50 Handling Credit Card Type Information . . . . . . . . . . . . . . . . . . . . . . . . . 50 Core Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Submitting Account Verifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 When To Use Account Verifications . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Required Account Verification Parameters . . . . . . . . . . . . . . . . . . . . . . . 54 Example Account Verification String . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Submitting Authorization/Delayed Capture Transactions . . . . . . . . . . . . . . . . . . 55 When to Use Authorization/Delayed Capture Transactions . . . . . . . . . . . . . . . 55 Required Authorization Transaction Parameters . . . . . . . . . . . . . . . . . . . . 56 Typical Authorization Transaction Parameter String . . . . . . . . . . . . . . . . . . . 56 4 31 July 2012 Gateway Developer Guide and Reference Content Submitting Balance Inquiry Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Processing Platforms Supporting Balance Inquiry Transactions . . . . . . . . . . . . 56 Required Balance Inquiry Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Example Balance Inquiry Transaction String . . . . . . . . . . . . . . . . . . . . . . 57 Submitting Card Present (SWIPE) Transactions. . . . . . . . . . . . . . . . . . . . . . . 57 Processing Platforms Supporting Card-Present Transactions. . . . . . . . . . . . . . 58 Card Present Transaction Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Submitting Credit Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Required Credit Transaction Parameters . . . . . . . . . . . . . . . . . . . . . . . . 59 Submitting Inquiry Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 When To Use an Inquiry Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Required Parameters When Using the PNREF . . . . . . . . . . . . . . . . . . . . . 61 Inquiry Transaction Parameter String Using the PNREF . . . . . . . . . . . . . . . . 62 Required Parameters When Using the CUSTREF . . . . . . . . . . . . . . . . . . . 62 Inquiry Transaction Parameter String Using the CUSTREF . . . . . . . . . . . . . . . 63 Required Parameters When Using the Secure Token . . . . . . . . . . . . . . . . . . 63 Inquiry Parameter String Using the Secure Token . . . . . . . . . . . . . . . . . . . . 63 Submitting Partial Authorizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 When To Use Partial Authorizations . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Required Partial Authorization Parameters . . . . . . . . . . . . . . . . . . . . . . . 64 Example Partial Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Submitting Purchasing Card Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Submitting Reference Transactions (Tokenization) . . . . . . . . . . . . . . . . . . . . . 66 When To Use a Reference Transaction . . . . . . . . . . . . . . . . . . . . . . . . . 66 Transaction Types That Can Be Used As the Original Transaction . . . . . . . . . . . 66 Fields Copied From Reference Transactions . . . . . . . . . . . . . . . . . . . . . . 67 Example Reference Transaction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Data Upload - Storing Credit Card Data on the Gateway Server . . . . . . . . . . . . 68 Submitting Sale Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 When To Use a Sale Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Additional Parameters For Sale Transactions . . . . . . . . . . . . . . . . . . . . . . 69 Typical Sale Transaction Parameter String . . . . . . . . . . . . . . . . . . . . . . . 69 Submitting Soft Merchant Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 About Soft Merchant Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Ways to Send Soft Merchant Information . . . . . . . . . . . . . . . . . . . . . . . . 70 Submitting Voice Authorization Transactions . . . . . . . . . . . . . . . . . . . . . . . . 71 When To Use a Voice Authorization Transaction . . . . . . . . . . . . . . . . . . . . 72 Required Voice Authorization Transaction Parameters . . . . . . . . . . . . . . . . . 72 Submitting Void Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Gateway Developer Guide and Reference 31 July 2012 5 Content When To Use a Void Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Required Void Transaction Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 73 Fields Copied From the Original Transaction Into the Void Transaction. . . . . . . . . 73 Example Void Transaction Parameter String . . . . . . . . . . . . . . . . . . . . . . 74 Using Address Verification Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Example Address Verification Service Parameter String . . . . . . . . . . . . . . . . 74 Using Card Security Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Chapter 7 Testing Transactions . . . . . . . . . . . . . . . . . . . . 77 Setting Up The Payflow Gateway Testing Environment . . . . . . . . . . . . . . . . . . . 77 Testing Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Processors Other Than PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Credit Card Numbers for Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Testing Address Verification Service. . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Testing Card Security Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 PayPal Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Credit Card Numbers for Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Result Values Based On Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Chapter 8 Transaction Responses . . . . . . . . . . . . . . . . . . . 87 Credit Card Transaction Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Address Verification Service Responses From PayPal . . . . . . . . . . . . . . . . . . . 90 Card Security Code Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Normalized Card Security Code Results . . . . . . . . . . . . . . . . . . . . . . . . 92 PayPal Card Security Code Results . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 BALAMT Response and Stored Value Cards . . . . . . . . . . . . . . . . . . . . . . . . 93 American Express Stored Value Card Example . . . . . . . . . . . . . . . . . . . . . 93 PNREF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 RESULT Values and RESPMSG Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 RESULT Values For Communications Errors . . . . . . . . . . . . . . . . . . . . . .100 Chapter A Processors Requiring Additional Transaction Parameters 103 American Express Additional Credit Card Parameters . . . . . . . . . . . . . . . . . . .103 Retail Transaction Advice Addendum (for SWIPE transactions) . . . . . . . . . . . .103 Internet Transaction Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104 Address Verification Service Parameters . . . . . . . . . . . . . . . . . . . . . . . .105 Location Transaction Advice Addendum Parameters . . . . . . . . . . . . . . . . . .105 6 31 July 2012 Gateway Developer Guide and Reference Content Transaction Advice Detail Parameters. . . . . . . . . . . . . . . . . . . . . . . . . .107 Airline Passenger Data Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . .107 American Express Other Parameters . . . . . . . . . . . . . . . . . . . . . . . . . .108 Elavon Additional Credit Card Parameters. . . . . . . . . . . . . . . . . . . . . . . . . .109 First Data Merchant Services Nashville, Additional Credit Card Parameters . . . . . . . . 110 First Data Merchant Services North, Additional Credit Card Parameters . . . . . . . . . . 110 Heartland, Additional Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . . 111 Litle Additional Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Merchant e-Solutions, Additional Credit Card Parameters. . . . . . . . . . . . . . . . . . 113 Paymentech Salem (New Hampshire) Additional Credit Card Parameters for American Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Internet Transaction Data Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 113 AVS Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Additional Credit Card Parameters for M Record . . . . . . . . . . . . . . . . . . . . 115 PayPal Credit Card Transaction Request Parameters . . . . . . . . . . . . . . . . . . . . 115 SecureNet Additional Credit Card Parameters for American Express . . . . . . . . . . . .120 Retail Transaction Advice Addendum (for SWIPE transactions) . . . . . . . . . . . .120 Internet Transaction Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121 AVS Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121 Location Transaction Advice Addendum Parameters . . . . . . . . . . . . . . . . . .122 Transaction Advice Detail Parameters. . . . . . . . . . . . . . . . . . . . . . . . . .123 Airline Passenger Data Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . .123 Other Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125 Vantiv Additional Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . . . .125 Additional Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . .125 Soft Merchant Descriptor Parameters . . . . . . . . . . . . . . . . . . . . . . . . . .126 WorldPay Additional Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . .127 Chapter B TeleCheck Electronic Check Processing . . . . . . . . . 129 TeleCheck NFTF Overview of Services . . . . . . . . . . . . . . . . . . . . . . . . . . .129 TeleCheck NFTF Processing Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .129 NFTF Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129 NFTF Processing Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . .131 NFTF Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131 TeleCheck Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132 Required TeleCheck Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . .133 Testing TeleCheck Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135 Example Test Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135 Gateway Developer Guide and Reference 31 July 2012 7 Content Preparing for TeleCheck Production Transactions . . . . . . . . . . . . . . . . . . . . . .136 Responses to TeleCheck Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . .136 Transaction Responses Common to All Tender Types . . . . . . . . . . . . . . . . .136 Response Code Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137 Sale Response Code Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137 Adjustment Code Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138 Response Codes For Status Response Packets . . . . . . . . . . . . . . . . . . . .138 TeleCheck Authorization Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . .139 Authorization – Sales Consent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139 Authorization – Sales Decline/Error . . . . . . . . . . . . . . . . . . . . . . . . . . .142 Chapter C Submitting Purchasing Card Level 2 and Level 3 Transactions 143 About Purchasing Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143 About Program Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143 Accepted BIN Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 About American Express Purchasing Card Transactions . . . . . . . . . . . . . . . . . .144 Supported Transaction Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 Avoiding Downgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145 Submitting Successful Level 3 Transactions . . . . . . . . . . . . . . . . . . . . . .145 Edit Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145 Accepted BIN Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146 American Express Purchasing Card Transaction Processing . . . . . . . . . . . . . . . .146 American Express Level 2 Parameters for American Express . . . . . . . . . . . . .146 Example American Express Level 2 Transaction Parameter String . . . . . . . . . . .149 American Express Level 3 Parameters . . . . . . . . . . . . . . . . . . . . . . . . .149 Example American Express Level 3 Transaction Parameter String . . . . . . . . . . .151 Elavon (Formerly Nova) Purchasing Card Transaction Processing . . . . . . . . . . . . .152 Elavon Level 2 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152 Elavon Additional Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152 Example Elavon Level 2 Transaction Parameter String . . . . . . . . . . . . . . . . .153 First Data Merchant Services (FDMS) Nashville Purchasing Card Transaction Processing.153 FDMS Nashville Commercial Card Parameters . . . . . . . . . . . . . . . . . . . . .153 First Data Merchant Services (FDMS) North Purchasing Card Transaction Processing . .154 FDMS North Purchasing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . .154 FDMS North Purchasing Card Line Item Parameters . . . . . . . . . . . . . . . . . .155 First Data Merchant Services South (FDMS) Purchasing Card Transaction Processing . .155 FDMS South Level 2 and Level 3 Purchasing Card Parameters . . . . . . . . . . . .156 FDMS South Line Item Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . .157 8 31 July 2012 Gateway Developer Guide and Reference Content Example FDMS South Purchasing Card Level 2 and 3 Parameter String . . . . . . . .158 Example FDMS South Line Item Parameter String . . . . . . . . . . . . . . . . . . .158 Global Payments - Central Purchasing Card Transaction Processing . . . . . . . . . . . .159 Global Payments - Central Level 2 Parameters . . . . . . . . . . . . . . . . . . . . .159 Global Payments - East Purchasing Card Transaction Processing . . . . . . . . . . . . .159 Global Payments - East Level 2 Parameters . . . . . . . . . . . . . . . . . . . . . .159 Example Global Payments - East Level 2 Visa or MasterCard Transaction Parameter String 160 Heartland Purchasing Card Transaction Processing. . . . . . . . . . . . . . . . . . . . .160 Heartland Level 2 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160 Heartland Level 3 MasterCard Parameters . . . . . . . . . . . . . . . . . . . . . . .161 Heartland Level 3 Visa Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . .163 Litle Purchasing Card Transaction Processing. . . . . . . . . . . . . . . . . . . . . . . .166 Litle Level 2 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166 Litle Level 3 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167 Merchant e-Solutions Purchasing Card Transaction Processing . . . . . . . . . . . . . .168 Merchant e-Solutions Level 2 Parameters. . . . . . . . . . . . . . . . . . . . . . . .169 Merchant e-Solutions Level 3 MasterCard Parameters . . . . . . . . . . . . . . . . .169 Merchant e-Solutions Level 3 Visa Parameters . . . . . . . . . . . . . . . . . . . . .172 Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing . . . . . .174 Paymentech Salem (New Hampshire) Level 2 Parameters for American Express . . .174 Paymentech Salem (New Hampshire) Level 3 Purchasing Card Parameters. . . . . .177 Paymentech Tampa Level 2 Purchasing Card Transaction Processing . . . . . . . . . . .180 Paymentech Tampa Level 2 Parameters . . . . . . . . . . . . . . . . . . . . . . . .181 Example Paymentech Tampa Level 2 Visa and MasterCard Transaction Parameter String 181 SecureNet Purchasing Card Transaction Processing . . . . . . . . . . . . . . . . . . . .181 SecureNet Level 2 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181 SecureNet Level 3 MasterCard Parameters . . . . . . . . . . . . . . . . . . . . . . .182 SecureNet Acquiring Solutions Level 3 Visa Parameters . . . . . . . . . . . . . . . .184 TSYS Acquiring Solutions Purchasing Card Transaction Processing . . . . . . . . . . . .187 TSYS Acquiring Solutions Level 2 Parameters . . . . . . . . . . . . . . . . . . . . .187 TSYS Acquiring Solutions Level 3 MasterCard Parameters. . . . . . . . . . . . . . .188 TSYS Acquiring Solutions Level 3 Visa Parameters. . . . . . . . . . . . . . . . . . .190 Vantiv Purchasing Card Transaction Processing . . . . . . . . . . . . . . . . . . . . . .193 Vantiv Purchasing Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193 Vantiv Purchasing Card Line Item Parameters . . . . . . . . . . . . . . . . . . . . .193 WorldPay Purchasing Cards Transaction Processing . . . . . . . . . . . . . . . . . . . .194 WorldPay Level 2 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194 WorldPay Level 3 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196 Gateway Developer Guide and Reference 31 July 2012 9 Content Chapter D VERBOSITY: Viewing Processor-Specific Transaction Results 199 Chapter E ISO Country Codes . . . . . . . . . . . . . . . . . . . . 201 Chapter F Codes Used by FDMS South Only . . . . . . . . . . . . . 203 MasterCard Country Codes for FDMS South Only . . . . . . . . . . . . . . . . . . . . .203 Visa Country Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210 Units of Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217 Chapter G PayPal Acquirer . . . . . . . . . . . . . . . . . . . . . . 225 Countries and Regions Supported by PayPal . . . . . . . . . . . . . . . . . . . . . . . .225 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225 PayPal Currency Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225 Chapter H Additional Processor Information . . . . . . . . . . . . . 227 Moneris Solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227 Chapter I Payflow Link Migration . . . . . . . . . . . . . . . . . . 229 Migrating from a legacy Payflow Link Integration . . . . . . . . . . . . . . . . . . . . . .229 10 31 July 2012 Gateway Developer Guide and Reference P Preface This guide describes the data parameters for the Gateway payments solutions. Scope This guide is a reference to the payment card data parameters available for submitting in transaction requests over the Gateway to multiple supported processors. It also covers the resulting response data parameters and errors. The guide describes the requirements of an ever growing list of processing platforms. It organizes parameters into a core set of request parameters supported by all processors, additional parameters unique to individual processors, and purchasing card parameters specialized to monitor credit card use in businesses. It also provides a section on response parameters and error codes (PNREF values that are not 0). Although this guide provides guidance on getting started with the SDK, setting up credit card processing, and testing your integration, its broad scope does not lend to use as a tutorial on integration. Refer to the PayPal Developer website and the Payflow Gateway SDK for detailed working examples and use cases. Related Documentation For additional information on the Gateway payments solutions: See PayPal Manager at: https://manager.paypal.com/ For more information on Payflow documentation, examples, and very current information, see the PayPal developer site at the following URL: https://www.x.com/developers/paypal Intended Audience This guide provides Gateway payments solutions to readers who: Are web or application developers Have a background in payments services Gateway Developer Guide and Reference 31 July 2012 11 P Preface Intended Audience Who Should Use This Document This comprehensive developer guide includes integration information for multiple Gateway solutions. Legacy Payflow Link features are not included in this guide. For legacy Payflow Link features refer to the Payflow Link User’s Guide. Additionally, all the Gateway features explained in this guide are not necessarily available to every Gateway customer. This section will help you determine whether you should use this document and which sections of the document are relevant to you. To view the Gateway solutions available to you, login to PayPal Manager at https://manager.paypal.com/. PayPal Manager displays your Gateway Services in the Service Summary box. Payflow Link Payflow Link customers can choose PayPal or another merchant bank to process their transactions via the Payflow Gateway. A) Legacy Payflow Link users will see the following in the Service Summary box in PayPal Manager: Payflow Link If you are a legacy Payflow Link user, do not use this guide; instead, use the Payflow Link User’s Guide. B) New Payflow Link users will see the following in the Service Summary box in PayPal Manager: Hosted Checkout Pages & Payflow SDK/API (Limited Access). (If PayPal Payments Advanced is also listed, then you are not a Payflow Link customer). 12 31 July 2012 Gateway Developer Guide and Reference Preface Intended Audience P New Payflow Link users who are using the Secure Token or the API should use this guide. However, new Payflow Link users who are using the legacy Payflow Link input tag integration should use the Payflow Link User’s Guide instead. Limited API Access means you can perform all API functions except for Sales and Authorization transactions. For Sales and Authorization type transactions you must use the Hosted Checkout Pages. Payflow Pro Payflow Pro customers can choose PayPal or another merchant bank to process their transactions via the Gateway. A) Legacy Payflow Pro users will see the following in the Service Summary box in PayPal Manager: Payflow Pro Legacy Payflow Pro users should use this guide; however, these users can only use the API integration and do not have the Hosted Checkout Pages service. If you are a legacy Payflow Pro user, you should skip the chapter on Hosted Checkout Pages - “Configuring Hosted Checkout Pages” on page 31. B) New Payflow Pro users can take advantage of all of the Gateway features including Hosted Checkout Pages. These users will see the following in the Service Summary box in PayPal Manager: Hosted Checkout Pages & Payflow SDK/API (Full Access) Gateway Developer Guide and Reference 31 July 2012 13 P Preface Intended Audience PayPal Payments Advanced Transactions submitted by PayPal Payments Advanced customers are processed through the Gateway with PayPal acting as the merchant bank. PayPal Payments Advanced users will see the following in the Service Summary box in PayPal Manager: PayPal Payments Advanced with Hosted Checkout Pages & Payflow SDK/API (Limited Access) Limited API Access means you can perform all API functions except for Sales and Authorization transactions. For Sales and Authorization type transactions you must use Hosted Checkout Pages. PayPal Payments Pro Transactions submitted by PayPal Payments Pro customers are processed through the Gateway with PayPal acting as the merchant bank. PayPal Payments Pro users can use all of the Gateway features supported by PayPal. These users will see the following in the Service Summary box in PayPal Manager: PayPal Payments Pro with Hosted Checkout Pages & Payflow SDK/API (Full Access) 14 31 July 2012 Gateway Developer Guide and Reference Preface Revision History P Revision History Revision History for the Gateway Developer Guide and Reference: Date Description 31 July 2012 Added a list of Setup Params and Customize Params. These parameters override PayPal Manager settings for Hosted Pages. Briefly explained the differences between Submitting Credit Transactions and Submitting Void Transactions. Updated the parameters in the Payflow Link legacy parameters and the equivalent Payflow parameters table. Added DATE_TO_SETTLE to Credit Card Transaction Responses parameters table. Added a note to the About Credit Card Processing section. 23 July 2012 Added the Bill Me Later feature to the Gateway Product Details section. 16 July 2012 Updated required value for BILLTOCITY, BILLTOSTATE & BILLTOCOUNTRY in PayPal Credit Card Transaction Request Parameters table. June 2012 Who Should Use This Document section added to the Preface. Integrating the Secure Token Without the Hosted Checkout Pages: Transparent Redirect section: corrected value of SILENTTRAN to “True” Silent Posts section added to Hosted Checkout Pages chapter. ISO Country Codes: removed the legacy paramater CORPCOUNTRY May 2012 Added new sections to the Testing Transactions chapter: Testing Address Verification ServiceTesting Card Security Code Added PayPal Acquirer chapter: Contains links to PayPal API Ref country and currency codes Gateway Developer Guide and Reference 31 July 2012 15 P Preface Revision History Date Description May 2012 (cont.) Document maintenance: Added cross-references and external links; reorganized content; removed no longer applicable content. April 2012 Added new transaction type: Balance Inquiry(TRXTYPE=B) can be used to obtain the balance of a pre-paid card. Updated TeleCheck chapter: Updated MICR values in Testing TeleCheck Transactions section Added TeleCheck Adjustment Response Code Values table Updated parameters and examples: Added a description for response parameters HOSTCODE, RESPTEXT, PROCCARDSECURE, ADDLMSGS and an explanation on how to use these parameters to obtain the processor’s raw response codes and response messages. Changed Litle parameters from STREET2,STREET3 to BILLTOSTREET2, BILLTOSTREET3 Corrected description of MERCHSVC parameter for FDMS North, Heartland, Litle, Merchant e-Solutions, Paymentech Salem Updated examples and removed legacy parameters to include:FIRSTNAME, LASTNAME, STREET, CITY, STATE, ZIP, COUNTRY Updated processor and entity names: Vantiv, previously known as Fifth Third Processing Solutions PayPal Australia, previously known as First Data Australia January 2012 Added new processors: First Third International Heartland Payment Systems Planet Payment SecureNet TeleCheck WorldPay Added new transaction types: TRXTYPE=L can be used to upload credit card data, easing PCI compliance. You can store the resulting PNREF locally for use in performing reference transactions. 16 31 July 2012 Gateway Developer Guide and Reference Preface Revision History Date Description January 2012 (cont.) Added request NVPs: ADDLAMTn ADDLAMTTYPEn AUTHDATE CATTYPE CONTACTLESS CUSTDATA CUSTOMERID CUSTOMERNUMBER DISCOUNT DUTYAMT DLNAME DLNUM DOB L_ALTTAXAMTn L_ALTTAXIDn L_ALTTAXRATEn L_CARRIERSERVICELEVELCODEn L_COMMCODEn L_EXTAMTn L_PRODCODEn L_TAXTYPEn ORDERID MERCHANTDESCR MERCHANTINVNUM MERCHANTNAME MERCHANTURL MERCHANTVATNUM MERCHANTZIP MISCDATA REPORTGROUP SILENTTRAN STREET3 VATINVNUM VATTAXAMT VATTAXRATE P Added response NVPs: DUPLICATE (response) EXTRMSG (response) Gateway Developer Guide and Reference 31 July 2012 17 P 18 Preface Revision History Date Description January 2012 (cont.) Added concepts: Gateway Product Solutions - PayPal Payments Advanced, PayPal Payments Pro, Payflow Pro, Payflow Link Transaction Flow Transparent Redirect February 2011 First publication. 31 July 2012 Gateway Developer Guide and Reference 1 Introducing the Gateway Checkout Solutions The Gateway provides checkout solutions for novice and advanced use. It provides merchants with a rich set of options to handle payment transactions. “About the Gateway Checkout Solutions” on page 19 “About the Gateway Transaction Flow” on page 21 “About Security” on page 22 “Processing Platforms Supporting Card-Present Transactions” on page 24 “Supported Payment Types” on page 25 “Recurring Billing Service” on page 26 About the Gateway Checkout Solutions Gateway checkout consists of the following four solutions: Payflow Link Payflow Pro PayPal Payments Advanced PayPal Payments Pro Summary of the Gateway Checkout Solutions Below is a basic comparison of the Gateway checkout solutions: Payflow Link uses hosted checkout pages to send transactions to a supported processor. Merchants can use the Payflow SDK APIs to perform all transactions except authorization and sale transactions. By using hosted pages with a secure token, the merchant adheres to compliance rules for handling customer data in a secure way: data is stored on PayPal so that it is not exposed to compromise. Payflow Pro can send transactions to a number of different supported processors, requirements for which are described in this documentation. Merchants select a supported processor and obtain an acquiring bank. Typically merchants integrate with, and have full access to, the Payflow SDK or use HTTPS to send transactions to the processor. Using hosted pages is an option. PayPal Payments Advanced uses web pages hosted by PayPal (also known as hosted checkout pages) to send transactions to the PayPal processor. With PayPal Payments Advanced, PayPal is the acquiring bank. By using hosted checkout pages with a secure Gateway Developer Guide and Reference 31 July 2012 19 1 Introducing the Gateway Checkout Solutions About the Gateway Checkout Solutions token, the merchant adheres to compliance rules for handling customer data in a secure way: data is stored on PayPal so that it is not exposed to compromise. Like PayPal Payments Advanced, PayPal Payments Pro sends transactions to the PayPal processor and PayPal is the acquiring bank. Using hosted checkout pages is an option. Typically merchants integrate with the Payflow SDK or use HTTPS to send transactions to the PayPal processor. NOT E : PayPal strongly recommends that all users of Gateway checkout solutions take advantage of the secure token and the hosted checkout pages. Doing so provides automatic compliance with processing card industry (PCI) standards for protecting cardholder data. Gateway Product Details The table below compares how the Gateway checkout solutions support payment processing features. PayPal Payments Advanced Payflow Link PayPal Payments Pro Payflow Pro Hosted checkout page (including an iFrame version) Yes Yes PayPal payments Included Optional Bill Me Later payments (Available to US merchants only on Hosted checkout pages.) Included Optional PayPal branding on full page templates Yes Optional Transparent Redirect No Yes Supports PayPal as a processor and an acquirer Yes Yes Credit and debit cards Yes Yes Level 2 and Level 3 purchase cards Yes Yes TeleCheck (guaranteed electronic checks) No Yes ACH (electronic checks) No Yes Virtual Terminal support, including card-present data passage Yes Yes Virtual Terminal Payflow Link only Yes API Limited access (no authorization or sale) Full access Feature 20 31 July 2012 Gateway Developer Guide and Reference Introducing the Gateway Checkout Solutions About the Gateway Transaction Flow Feature PayPal Payments Advanced Payflow Link PayPal Payments Pro Payflow Pro Reference transactions (Tokenization) Yes Yes Secure token to preset hosted checkout page Yes Yes Reporting APIs Yes Yes Desktop integration Yes Yes Recurring billing Yes Yes Basic fraud protection Yes Yes Advanced fraud protection Yes Yes Partner/channel distribution support (Partner Manager, registration, XML registration) resale and referral Yes Yes 1 About the Gateway Transaction Flow The traditional transaction flow is as follows. Numbers correspond to numbers in the figure. 1. At your website, the customer clicks Buy to purchase merchandise. 2. You send the transaction request to the Gateway server. 3. The Gateway sends the transaction to the payment processing network. 4. Your processor sends the response back to the Gateway server and processes the transaction (obtains the payment from the customer bank and deposits it in the merchant bank). 5. The Gateway server returns the response to your website. 6. Your website displays the result to the customer. Gateway Developer Guide and Reference 31 July 2012 21 1 Introducing the Gateway Checkout Solutions About Security You can use the core transaction parameters supported by all Gateway processors described in this dcumentation to send transaction data to your processor. In addition: Each Gateway processor may support various additional parameters beyond the core set that you can send in transaction requests. Your processor may also support purchasing cards (credit cards employers issue for business-related charges). Purchasing card Level 2 and Level 3 parameters provide specialized reporting so an employer can monitor card use. The parameter information may appear on the customer’s statement or describe line items in greater detail. Be sure to check for your processor’s Level 2 and 3 parameters in this documentation. The sections in this documentation describing the above parameters alphabetically organize parameters by processor name. About Security It is your responsibility to adhere to PCI compliance standards to protect personal information and implement security safeguards on your website when processing payment card transactions. Gateway solutions make available a secure token and hosted checkout pages to help you meet PCI compliance. Hosted pages are optional to PayPal Payments Pro and Payflow Pro users. If you do not use a secure token or hosted pages, you must provide your own means of meeting compliance requirements. NOT E : 22 PayPal Payments Advanced and Payflow Link merchants are required to use hosted pages. 31 July 2012 Gateway Developer Guide and Reference Introducing the Gateway Checkout Solutions About Security 1 Secure Token The secure token stores request transaction data on the Gateway server. It eliminates the need to resend the parameter data for display in a hosted checkout page where the data might be subject to compromise. Hosted Checkout Pages The Gateway enables the use of hosted checkout pages, which help you achieve PCI compliance. The hosted checkout pages enable you to pass transaction data securely to the server and to collect credit card acceptance data. NOT E : You are required to use hosted pages with PayPal Payments Advanced and Payflow Link. The following figure shows the transaction flow when using hosted pages and a secure token. Numbers in the figure correspond to the numbered comments below: 1. The customer clicks Buy to purchase merchandise on your website. 2. You request a secure token by passing a token ID to the Gateway server. 3. The Gateway server returns the secure token and your token ID to your website. 4. You submit the secure token and token ID in an HTTP post to pages hosted on the Gateway server and redirect the customer’s browser to the hosted pages. 5. The Gateway server uses the secure token to retrieve the amount and other transaction data. The customer submits their credit card number, expiration date, and other sensitive data directly to the host pages rather than to your website, easing your PCI compliance requirements. Gateway Developer Guide and Reference 31 July 2012 23 1 Introducing the Gateway Checkout Solutions Processing Platforms Supporting Card-Present Transactions 6. The Gateway processes the payment through the payment processing network. 7. The Gateway server transparently returns the customer to the location on your website that you specified in the request to obtain a secure token. You display the results to the customer on your website. NOT E : If you do not get a response from the Gateway server, submit an Inquiry transaction, passing in the secure token to see if the transaction has completed. For details, see “Submitting Inquiry Transactions” on page 61. PCI Compliance Without Hosted Pages: Transparent Redirect PayPal Payments Pro and Payflow Pro merchants who want PCI compliance while maintaining full control over designing and hosting checkout pages on their website can use Transparent Redirect. Transparent Redirect posts payment details silently to the Gateway server, so this sensitive information never goes through the merchant’s website. Implementing Transparent Redirect is very similar to implementing hosted pages. It differs only in the steps shown in boldface below: 1. The customer clicks Buy to purchase merchandise on your website. 2. You request a secure token by passing a secure token ID to the Gateway server. In the request, you pass the name-value pair, SILENTTRAN=TRUE. This name-value pair prevents the hosted pages from displaying. 3. The Gateway server returns the secure token and your token ID to your website. 4. You display the credit card fields to the customer in a checkout page on your website. 5. The customer enters their credit card number, expiration date, and other sensitive data into the credit card fields and clicks Submit. The browser posts the payment data directly to the Gateway server, avoiding your website and easing your PCI compliance requirements. NOT E : To ensure that the post goes from the browser directly to PayPal and not back to your website, you should add scripting. 6. The Gateway processes the payment through the payment processing network. 7. The Gateway server transparently sends the customer to the location on your website that you specified in the request to obtain a secure token. You display the results to the customer on your website. Processing Platforms Supporting Card-Present Transactions The following processing platforms support card-present transactions. 24 31 July 2012 Gateway Developer Guide and Reference Introducing the Gateway Checkout Solutions Supported Payment Types 1 American Express American Express APAC Elavon Fifth Third Processing Solutions First Data Merchant Services (FDMS) Nashville First Data Merchant Services (FDMS) North First Data Merchant Services (FDMS) South Global Payments Central Global Payments East Heartland Payment Systems Litle Merchant e-Solutions Moneris Solutions Paymentech Salem Paymentech Tampa PayPal SecureNet TeleCheck TSYS Acquiring Solutions WorldPay Supported Payment Types Credit cards PayPal (supported by PayPal’s Express Checkout product) Pinless debit cards Electronic checks Check cards Purchasing cards (also referred to as commercial cards, corporate cards, procurement cards, or business cards) Level 2 and Level 3 Gateway Developer Guide and Reference 31 July 2012 25 1 Introducing the Gateway Checkout Solutions Recurring Billing Service Automated Clearing House (ACH). For information on performing ACH transactions, contact your PayPal Sales Representative. Recurring Billing Service The Recurring Billing Service is a scheduled payment solution that enables you to automatically bill your customers at regular intervals—for example, you can bill your customers a monthly fee of $42 for 36 months with an initial fee of $129. You enroll separately for the Recurring Billing Service. Using the Gateway to define and manage recurring transactions programmatically is described in Payflow Pro – Recurring Billing Service User’s Guide. You can manage Recurring Billing tasks in PayPal Manager. 26 31 July 2012 Gateway Developer Guide and Reference 2 Secure Token This section describes the secure token. “Secure Token” on page 27 “Integrating the Secure Token With the Hosted Checkout Pages” on page 27 “Integrating the Secure Token Without the Hosted Checkout Pages: Transparent Redirect” on page 28 “Posting To the Hosted Checkout Page” on page 29 About the Secure Token Use a secure token to send non-credit card transaction data to the Gateway server for safer storage. The secure token prevents anyone from intercepting or manipulating the data. You must use a secure token if you use hosted checkout pages. The token is good for a one-time transaction and is valid for 30 minutes. NOT E : PayPal Payments Pro and Payflow Pro merchants who do not use a secure token must host their own payment pages. When hosting your own pages, you are responsible for meeting PCI requirements by handling data securely. PayPal Payments Advanced and Payflow Link merchants must use a secure token with hosted checkout pages. To obtain a secure token, pass a unique, 36-character secure token ID and set CREATESECURETOKEN=Y in a request to the Gateway server. The Gateway server associates your ID with a secure token and returns the token as a string of up to 32 alphanumeric characters. To pass the transaction data to the hosted checkout page, you pass the secure token and secure token ID in an HTTP form post. The token and ID trigger the Gateway server to retrieve your data and display it for customer approval. NOT E : You cannot modify the data sent with a secure token, with one exception. You can configure PayPal Manager to allow you to modify billing and shipping information. Integrating the Secure Token With the Hosted Checkout Pages To create a secure token, pass all parameters that you need to process the transaction except for payment details parameters such as the credit card number, expiration date, and check number. For details on transaction parameters, see “Submitting Credit Card Transactions” on page 47. In addition, pass the following Payflow parameters to create the secure token. Gateway Developer Guide and Reference 31 July 2012 27 2 Secure Token Integrating the Secure Token Without the Hosted Checkout Pages: Transparent Redirect NOT E : The secure token is valid for 30 minutes, and you can only use it one time. If you attempt to use the token after the time limit has expired, your transaction will fail with Result value 7, “Secure Token Expired.” If you attempt to reuse the token, you receive an error. 1. Set SECURETOKENID to a unique alphanumeric value up to 36 characters in length. SECURETOKENID=9a9ea8208de1413abc3d60c86cb1f4c5 2. Set CREATESECURETOKEN to the value Y to request that Payflow gateway return a token. CREATESECURETOKEN=Y Secure Token Example The following is an example of a request parameter string that creates a secure token. TRXTYPE=A&BILLTOSTREET=123 Main St.&BILLTOZIP=95131&AMT=23.45&CURRENCY=USD& INVNUM=INV12345&PONUM=PO9876&CREATESECURETOKEN=Y&SECURETOKENID=9a9ea8208de1 413abc3d60c86cb1f4c5 The Gateway server returns SECURETOKEN and SECURETOKENID in the response. A tag follows the SECURETOKEN to indicate the length of the token value returned. RESULT=0&RESPMSG=Approved&SECURETOKEN[25]=Fj+1AFUWft0+I0CUFOKh5WA==&SECURET OKENID=9a9ea8208de1413abc3d60c86cb1f4c5 Integrating the Secure Token Without the Hosted Checkout Pages: Transparent Redirect To use your own checkout pages while complying with PCI guidelines (sending the customer’s sensitive data directly to the Gateway server), pass all parameters that you need to process the transaction except for sensitive payment details such as the credit card number, expiration date, and check number. For details on sending transactions, see “Submitting Credit Card Transactions” on page 47. In addition, pass the following 3 Payflow parameters in your request. The first 2 parameters obtain a secure token. The third parameter implements Transparent Redirect, which suppresses hosted pages. NOT E : The secure token is valid for 30 minutes, and you can only use it one time. If you attempt to use the token after the time limit has expired, your transaction will fail with Result value 7, “Secure Token Expired.” If you attempt to reuse the token, you receive an error. 1. Set SECURETOKENID to a unique alphanumeric value up to 36 characters in length. SECURETOKENID=9a9ea8208de1413abc3d60c86cb1f4c5 28 31 July 2012 Gateway Developer Guide and Reference Secure Token Posting To the Hosted Checkout Page 2 2. Set CREATESECURETOKEN to the value Y to request that the Gateway server return a token. CREATESECURETOKEN=Y 3. Set SILENTTRAN to the value TRUE to suppress the display of hosted pages. SILENTTRAN=TRUE Transparent Redirect Example The following is an example of an authorization parameter string that suppresses hosted pages. TRXTYPE=A&BILLTOSTREET=123 Main St.&BILLTOZIP=95131&AMT=24.35&INVNUM=INV123 45&PONUM=PO12345&CURRENCY=USD&CREATESECURETOKEN=Y&SECURETOKENID=9a9ea8208de 1413abc3d60c86cb1f4c5&SILENTTRAN=TRUE The Gateway server returns a SECURETOKEN and SECURETOKENID in the response. A tag follows the SECURETOKEN to indicate the length of the token value returned. RESULT=0&RESPMSG=Approved&SECURETOKEN[25]=Fj+1AFUWft0+I0CUFOKh5WA==&SECURET OKENID=9a9ea8208de1413abc3d60c86cb1f4c5 When the customer enters their sensitive data into the credit card fields on your website and clicks Submit, the browser posts the data to the Gateway server rather than to your website. NOT E : It is highly recommended that you add scripting to ensure the the browser posts the sensitive data directly to the PayPal Gateway server rather than to your website. Posting To the Hosted Checkout Page To display the transaction information to the Gateway hosted checkout page, you perform an HTTP form post. 1. Direct the HTTP post to the Gateway applications server at the following URL. https://payflowlink.paypal.com 2. Send the following parameter data: – SECURETOKEN returned in the transaction response – SECURETOKENID HTTP Form Post Examples The following is an example request string that displays the transaction information to the hosted checkout page. Gateway Developer Guide and Reference 31 July 2012 29 2 Secure Token Posting To the Hosted Checkout PageThe following example uses Payflow name-value pairs to pass values in a form post to the hosted checkout pages. For details on name-value pair strings, see “Sending a Simple Transaction to the Server” on page 43.PageTitle
-113
Unable to round and truncate the currency value simultaneously
31 July 2012
Gateway Developer Guide and Reference
A
Processors Requiring Additional
Transaction Parameters
Additional parameters are those required by individual processors beyond the core parameters.
Parameters are organized alphabetically by processor.
“American Express Additional Credit Card Parameters” on page 103
“Elavon Additional Credit Card Parameters” on page 109
“First Data Merchant Services Nashville, Additional Credit Card Parameters” on page 110
“First Data Merchant Services North, Additional Credit Card Parameters” on page 110
“Heartland, Additional Credit Card Parameters” on page 111
“Litle Additional Credit Card Parameters” on page 111
“Merchant e-Solutions, Additional Credit Card Parameters” on page 113
“Paymentech Salem (New Hampshire) Additional Credit Card Parameters for American
Express” on page 113
“PayPal Credit Card Transaction Request Parameters” on page 115
“SecureNet Additional Credit Card Parameters for American Express” on page 120
“Vantiv Additional Credit Card Parameters” on page 125
“WorldPay Additional Credit Card Parameters” on page 127
American Express Additional Credit Card Parameters
In addition to the core credit card parameters, American Express accepts the parameters
described below to meet AMEX reporting and statement requirements.
PayPal recommends that you include these parameters if you would like to impact what
appears on AMEX statements and reports.
NOT E :
The PayPal processor does not support SWIPE (card-present) transactions.
Retail Transaction Advice Addendum (for SWIPE transactions)
Field
Description
L_DESCn
(Optional) Description of this line-item (n is a line item number from 1 to 6).
Character length and limitations: 19 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
103
A
Processors Requiring Additional Transaction Parameters
American Express Additional Credit Card Parameters
Field
Description
L_AMTn
(Optional) Amount of this line-item (n is a line item number from 1 to 6).
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
L_QTYn
(Optional) Quantity of this line-item (n is a line item number from 1 to 6).
Character length and limitations: 3 numeric characters
Internet Transaction Data
104
Field
Description
BILLTOEMAIL
(Optional) Account holder’s email address.
Character length and limitations: 60 alphanumeric characters
BILLTOPHONENUM
(Optional) Account holder’s telephone number.
Character length and limitations: 10 characters
PHONETYPE
(Optional) Telephone company provided ANI information identifier digits indicating
the telephone call type. Examples: cellular (61-63), payphone (27)
Character length and limitations: 2 characters
CUSTHOSTNAME
(Optional) Name of the server that the account holder is connected to. Example:
PHX.QW.AOL.COM.
Character length and limitations: 60 alphanumeric and special characters
CUSTBROWSER
(Optional) Name of the server that the account holder is connected to. Example:
MOZILLA/4.0~(COMPATIBLE;~MSIE~5.0;~WINDOWS~95)
Character length and limitations: 60 alphanumeric and special characters
CUSTIP
(Optional) Account holder’s IP address.
Character length and limitations: 15 alphanumeric and special characters
SHIPTOCOUNTRY
(Optional) Numeric country code of ship-to country. Example: USA: 840.
Character length and limitations: 3 characters
SHIPMETHOD
(Optional) Shipping method code. The values are:
01 = Same day
02 = Overnight/next day
03 = Priority, 2 - 3 days
04 = Ground, 4 or more days
05 = Electronic delivery
06 - ZZ = Reserved for future use
SKU
(Optional) Merchant product SKU.
Character length and limitations: 15 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
American Express Additional Credit Card Parameters
A
Address Verification Service Parameters
Field
Description
BILLTOSTREET
(Optional) Account holder’s street address (number and street name).
Character length and limitations: 20 characters
BILLTOZIP
(Optional) Account holder’s 5- to 9-digit ZIP (postal) code excluding spaces,
dashes, and non-numeric characters. Example: 951121737
Character length and limitations: 9 characters
BILLTOPHONENUM
(Optional) Account holder’s telephone number. The formats are:
xxx-xxx-xxxx (US numbers)
+xxxxxxxxxxx (international numbers)
Character length and limitations: 10 characters
SHIPTOFIRSTNAME
(Optional) First name in the shipping address.
Character length and limitations: 30 characters
SHIPTOLASTNAME
(Optional) Last name in the shipping address.
Character length and limitations: 30 characters
SHIPTOSTREET
(Optional) Shipping street address.
Character length and limitations: 30 characters
SHIPTOCOUNTRY
(Optional) Numeric country code of ship-to country. Example: USA: 840.
Character length and limitations: 3 alphanumeric characters
SHIPTOZIP
(Optional) Shipping 5- to 9-digit zip (postal) code excluding spaces, dashes, and
non-numeric characters. Example: 951121737
Character length and limitations: 9 alphanumeric characters
SHIPTOPHONENUM
(Optional) Shipping telephone number.
Character length and limitations: 10 alphanumeric characters
Location Transaction Advice Addendum Parameters
Field
Description
MERCHANTNAME
(Optional) Name of merchant.
Character length and limitations: 38 alphanumeric characters
MERCHANTSTREET
(Optional) Merchant’s street address (number and street name).
Character length and limitations: 38 alphanumeric characters. If more than 38
characters, use proper and meaningful abbreviation. Do not truncate.
Gateway Developer Guide and Reference
31 July 2012
105
A
Processors Requiring Additional Transaction Parameters
American Express Additional Credit Card Parameters
Field
Description
MERCHANTCITY
(Optional) The name of the city were the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another
entity), you must enter the name of the city in which the seller is located.
If you are a mail order, phone order, or internet industry, you may substitute the
name of the city in which the merchant’s order processing facility is located.
Character length and limitations: 21 alphanumeric characters. If more than 21
characters, use proper and meaningful abbreviation. Do not truncate.
MERCHANTSTATE
(Optional) The region code that corresponds to the state, province, or country
subdivision of the merchant location where the transaction took place.
Region code examples:
CA = California, USA
NS = Nova Scotia, Canada
COS = Colima Mexico
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the region code that corresponds to the state, province, or country
subdivision in which the seller is located.
Character length and limitations: 3 alphanumeric characters
MERCHANTZIP
(Optional) The 5- to 9-digit zip (postal) code excluding spaces, dashes, and nonnumeric characters where the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the postal code that corresponds to the seller’s location.
Character length and limitations: 15 alphanumeric characters
MERCHANTCOUNTRYCODE
(Optional) Country code of the location where the transaction took place.
Character length and limitations: 3 alphanumeric characters
MERCHANTLOCATIONID
(Optional)Merchant-assigned store or location number (or name) that uniquely
identifies where the transaction took place.
Character length and limitations: 15 alphanumeric characters
MERCHANTID
(Required) American Express-assigned service establishment number used to identify
and facilitate payments to merchants.
Character length and limitations: 15 alphanumeric characters.
MERCHANTCONTACTINFO
(Optional) Merchant’s telephone number or web address. (URLs and e-mail addresses
may be lowercase, as appropriate.) This entry may appear on the descriptive bill on
the card-member’s statement, or may be used to resolve billing inquiries and disputes.
N O TE :
American Express strongly recommends that aggregators (third-parties who
bill for goods or services rendered by another entity) always fill in this field
with the URL, e-mail address, or telephone number of the contact responsible
for resolving disputes or inquiries.
Character length and limitations: 40 alphanumeric characters
106
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
American Express Additional Credit Card Parameters
A
Transaction Advice Detail Parameters
Field
Description
ADDLAMTn
(Optional) Detail of a charge where n is a value from 1 - 5. Use for additional
breakdown of the amount.
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
ADDLAMTTYPEn
(Optional) A 3-digit code indicating the type of the corresponding charge detail,
where n is a value from 1 - 5.
Character length and limitations: 3 numeric characters
Airline Passenger Data Parameters
Field
Description
AIR-DEPARTUREDATE
(Optional) Departure date in the format YYYYMMDD.
Character length and limitations: 8 alphanumeric characters
AIR-PASSENGERNAME
(Optional) Name of the passenger in the following format with fields separated by a
space: surname firstname middleinitial title
Character length and limitations: 60 alphanumeric characters
AIR-ORIGIN
(Optional) Airport code of the originating airport. For a list of airport codes, see
http://www.world-airport-codes.com/alphabetical/airport-code/a.html.
N O TE :
Present day airport codes are three characters in length. The five character
length is designed to allow for future expansion
Character length and limitations: 5 alphanumeric characters
AIR-DESTINATION
(Optional) Destination airport code for the first segment of the trip; this is not
necessarily the final destination. For example, if a passenger flies from STL to MIA
with a layover at JFK, the destination airport is JFK For a list of airport codes, see
http://www.world-airport-codes.com/alphabetical/airport-code/a.html.
N O TE :
Present day airport codes are three characters in length. The five character
length is designed to allow for future expansion
Character length and limitations: 5 alphanumeric characters
AIR-NUMBEROFCITIES
(Optional) Number of unique cities in this trip including the cities of origin and
destination, where a maximum value of 10 is allowed. For example, AIRNUMBEROFCITIES is 3 for the following trip:
DEN to LAX
LAX to SFO
SFO to DEN
If not provided, this value is equal to the number of AIR-ROUTINGCITYn parameters.
Gateway Developer Guide and Reference
31 July 2012
107
A
Processors Requiring Additional Transaction Parameters
American Express Additional Credit Card Parameters
Field
Description
AIR-ROUTINGCITYn
(Optional) Airport codes of each city in this flight including cities of origin and
destination, where n is a value from 1 to 10.
Character length and limitations: 5 alphanumeric characters
AIR-CARRIERn
(Optional) Two character airline code for each unique airline in this flight, where n is
a value from 1 to 10.
If the same carrier is used for multiple segments of the trip, it is passed only once. For
example, the two AIR-CARRIERn values for the following trip are UA and AA:
UA flight from IAD to DEN
UA flight from DEN to LAX
UA flight from LAX to SFO
AA flight from SFO to DFW
For information about airlines codes, see http://en.wikipedia.org/wiki/Airline_codesAll
Character length and limitations: 24 alphanumeric characters
AIR-FAREBASIS
(Optional) List discounts associated with the travel.
Character length and limitations: 24 alphanumeric characters
AIRNUMBEROFPASSENGERS
(Optional) Number of passengers on this trip.
Character length and limitations: numeric
AIR-ISETICKET
(Optional) If this is an electronic ticket. The values are:
Y = yes
N = no
Character length and limitations: 1 alphanumeric character
AIR-RESERVATIONCODE
(Optional) Code assigned to the travel reservation before the ticket was purchased.
Character length and limitations: 15 alphanumeric characters
American Express Other Parameters
Field
Description
BILLTOFIRSTNAME
(Optional) Account holder's first and last name.
N O TE :
Even though the parameter name indicates only the first name, this single
parameter holds all of the person's name information (both first and last
name, at a minimum).
Character length and limitations: 13 alphanumeric characters
BILLTOLASTNAME
108
(Optional) Account holder's last name.
Character length and limitations: 13 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
Elavon Additional Credit Card Parameters
Field
Description
INVNUM
(Optional) Merchant invoice number. The merchant invoice number is used for
authorizations and settlements and, depending on your merchant bank, will appear on
your customer's credit card statement and your bank reconciliation report. If you do
not provide an invoice number, the transaction ID (PNREF) will be submitted.
Character length and limitations: 9 alphanumeric characters
ORDERDATE
(Optional) Specifies an order date.
Character length and limitations: 6 numeric characters
Format: mmddyy (with no slashes or dashes). For example, July 28, 2003 is 072803.
ORDERDATETIME
(Optional) Specifies an order time and date.
Character length and limitations: 19 alphanumeric characters
Format is either YYYY-MM-DD or YYYY-MM-DD HH:MI:SS
(where HH is in 24-hour time). If the value does not conform to one of the formats or
if the date is not valid (for example, 2004-17-35), then the transaction is rejected
with: RESULT=7(SIG_FIELD_ERR) RESPMSG=Invalid ORDERTIME
A truncated version of the ORDERTIME value (up to 7 characters) overwrites any
value provided by ORDERDATE. If no value is provided, a NULL value is stored.
A
Elavon Additional Credit Card Parameters
In addition to the core credit card parameters, Elavon (formerly Nova) accepts the parameter
described below.
Field
Description
RECURRING
(Optional) Identifies the transaction as recurring. This value does not activate the
Payflow Recurring Billing Service API.
If the RECURRING parameter was set to Y for the original transaction, then the setting
is ignored when forming credit, void, and force transactions.
If you subscribe to Payflow Fraud Protection Services:
To avoid charging you to filter recurring transactions that you know are reliable,
the fraud filters do not screen recurring transactions.
To screen a prospective recurring customer, submit the transaction data using
PayPal Manager’s Manual Transactions page. The filters screen the transaction in
the normal manner. If the transaction triggers a filter, then you can follow the
normal process to review the filter results.
Character length and limitations: 1 alphanumeric character (Y or N)
Gateway Developer Guide and Reference
31 July 2012
109
A
Processors Requiring Additional Transaction Parameters
First Data Merchant Services Nashville, Additional Credit Card Parameters
First Data Merchant Services Nashville, Additional Credit Card
Parameters
In addition to the core credit card parameters, First Data Merchant Services (FDMS) Nashville
accepts the parameters described below.
Field
Description
INVNUM
(Optional) Merchant invoice number. The merchant invoice number is used for
authorizations and settlements and, depending on your merchant bank, will appear on
your customer's credit card statement and your bank reconciliation report. If you do
not provide an invoice number, the transaction ID (PNREF) will be submitted.
Character length and limitations: 9 alphanumeric characters
First Data Merchant Services North, Additional Credit Card
Parameters
In addition to the core credit card parameters, First Data Merchant Services (FDMS) North
accepts the parameters described
Field
Description
DESC
(Optional) Use the DESC* parameters to pass in your DBA name and other data
describing the transaction. This information will be displayed in the account holder’s
statement.
N O TE :
Note: FDMS North passes the descriptive data to the card associations with
the following character lengths:
Visa: 25
MasterCard: 22
AMEX: 20
DISC: 22
Some card associations truncate the value to 19 characters. If you have questions,
consult the card association.
Character length and limitations: 25 alphanumeric characters
MERCHDESCR
110
(Optional) Use this parameter to pass in your DBA name and other data describing
the transaction. This information is usually displayed in the account holder’s
statement.
Character length and limitations: 25 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
Heartland, Additional Credit Card Parameters
Field
Description
MERCHSVC
(Optional) Defaults to the city where the merchant outlet is located for retail and to
the merchant’s phone number for non-retail. For example, 800 111-1111. This
information is usually displayed in the account holder’s statement.
Character length and limitations: 13 alphanumeric characters
A
Heartland, Additional Credit Card Parameters
In addition to the core credit card parameters, Heartland accepts the parameters described
below.
Field
Description
INVNUM
(Optional) Merchant invoice number. The merchant invoice number is used for
authorizations and settlements and, depending on your merchant bank, will appear on
your customer's credit card statement and your bank reconciliation report. If you do
not provide an invoice number, the transaction ID (PNREF) will be submitted.
N O TE :
Not supported by Payflow Link.
Character length and limitations: 17 alphanumeric characters
MERCHDESCR
(Optional) Use this parameter to pass in your DBA name and other data describing
the transaction (default: merchant name). This information is usually displayed in the
account holder’s statement.
Character length and limitations: 25 alphanumeric characters
MERCHSVC
(Optional) Defaults to the city where the merchant outlet is located for retail and to
the merchant’s phone number for non-retail. For example, 800 111-1111. This
information is usually displayed in the account holder’s statement.
Character length and limitations: 13 alphanumeric characters
Litle Additional Credit Card Parameters
Field
Description
AUTHDATE
Required for Force transactions. Authorization date.
Character length and limitations: 11alphanumeric characters
CUSTOMERID
(Optional) Customer identification.
Character length and limitations: 18 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
111
A
Processors Requiring Additional Transaction Parameters
Litle Additional Credit Card Parameters
Field
Description
INVNUM
(Optional) Merchant invoice number. The merchant invoice number is used for
authorizations. If you do not provide an invoice number, the transaction ID (PNREF)
will be submitted.
Character length and limitations: 20 alphanumeric characters
MERCHANTCITY
(Optional) The name of the city were the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another
entity), you must enter the name of the city in which the seller is located.
If you are a mail order, phone order, or internet industry, you may substitute the
name of the city in which the merchant’s order processing facility is located.
Character length and limitations: 21 alphanumeric characters
MERCHANTURL
(Optional) Merchant’s website. This information is usually displayed in the account
holder’s statement.
Character length and limitations: 40 alphanumeric characters
MERCHDESCR
(Optional) Use this parameter to pass in your DBA name and other data describing
the transaction. This information is usually displayed in the account holder’s
statement.
Character length and limitations: 25 alphanumeric characters
MERCHSVC
(Optional) Defaults to the city where the merchant outlet is located for retail and to
the merchant’s phone number for non-retail. For example, 800 111-1111. This
information is usually displayed in the account holder’s statement.
Character length and limitations: 13 alphanumeric characters
PONUM
(Optional) Purchase order number.
Character length and limitations: 25 alphanumeric characters
REPORTGROUP
(Optional) Category that the transaction is in, for example, coffee mugs. This field is
for your own use.
Character length and limitations: 25 alphanumeric characters
BILLTOSTREET2
(Optional) Second street address.
Character length and limitations: 35 alphanumeric characters
BILLTOSTREET3
(Optional) Third street address.
Character length and limitations: 35 alphanumeric characters
TAXAMT
(Optional) Total tax amount.
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
TAXEXEMPT
(Optional) Indicates whether the customer is tax exempt. It is one of the following
values:
Y – The customer is tax exempt.
N – The customer is not tax exempt (default).
Character length and limitations: 1 alpha character
112
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
Merchant e-Solutions, Additional Credit Card Parameters
A
Merchant e-Solutions, Additional Credit Card Parameters
In addition to the core credit card parameters, Merchant e-Solutions accepts the parameters
described below.
Field
Description
INVNUM
(Optional) Merchant invoice number. The merchant invoice number is used for
authorizations and settlements and, depending on your merchant bank, will appear on
your customer's credit card statement and your bank reconciliation report. If you do
not provide an invoice number, the transaction ID (PNREF) will be submitted.
N O TE :
Not supported by Payflow Link.
Character length and limitations: 17 alphanumeric characters
MERCHDESCR
(Optional) Use this parameter to pass in your DBA name and other data describing
the transaction (default: merchant name). This information is usually displayed in the
account holder’s statement.
Character length and limitations: 25 alphanumeric characters
MERCHSVC
(Optional) Defaults to the city where the merchant outlet is located for retail and to
the merchant’s phone number for non-retail. For example, 800 111-1111. This
information is usually displayed in the account holder’s statement.
Character length and limitations: 13 alphanumeric characters
Paymentech Salem (New Hampshire) Additional Credit Card
Parameters for American Express
In addition to the core credit card parameters, Paymentech Salem accepts the parameters to
meet American Express statement and reporting requirements described below.
Internet Transaction Data Parameters
Field
Description
BILLTOEMAIL
(Optional) Account holder’s email address.
Character length and limitations: 60 alphanumeric characters
BILLTOPHONENUM
(Optional) Account holder’s telephone number.
Character length and limitations: 20 characters
PHONETYPE
(Optional) Telephone company provided ANI information identifier digits indicating
the telephone call type. Examples: cellular (61-63), payphone (27)
Character length and limitations: 2 characters
Gateway Developer Guide and Reference
31 July 2012
113
A
Processors Requiring Additional Transaction Parameters
Paymentech Salem (New Hampshire) Additional Credit Card Parameters for American Express
Field
Description
CUSTHOSTNAME
(Optional) Name of the server that the account holder is connected to. Example:
PHX.QW.AOL.COM.
Character length and limitations: 60 alphanumeric and special characters
CUSTBROWSER
(Optional) Name of the server that the account holder is connected to. Example:
MOZILLA/4.0~(COMPATIBLE;~MSIE~5.0;~WINDOWS~95)
Character length and limitations: 60 alphanumeric and special characters
CUSTIP
(Optional) Account holder’s IP address.
Character length and limitations: 15 alphanumeric and special characters
SHIPTOCOUNTRY
(Optional) Numeric country code of ship-to country. Example: USA: 840.
Character length and limitations: 3 alphanumeric characters
SHIPMETHOD
(Optional) Shipping method code. The values are:
01 = Same day
02 = Overnight/next day
03 = Priority, 2 - 3 days
04 = Ground, 4 or more days
05 = Electronic delivery
06 - ZZ = Reserved for future use
SKU
(Optional) Merchant product SKU.
Character length and limitations: 15 alphanumeric and special characters
AVS Parameters
Field
Description
BILLTOSTREET
(Optional) Account holder’s street address (number and street name).
Character length and limitations: 20 characters
BILLTOZIP
(Optional) Account holder’s 5- to 9-digit ZIP (postal) code excluding spaces,
dashes, and non-numeric characters. Example: 951121737
Character length and limitations: 9 characters
BILLTOPHONENUM
(Optional) Account holder’s telephone number. The formats are:
xxx-xxx-xxxx (US numbers)
+xxxxxxxxxxx (international numbers)
Character length and limitations: 10 characters
114
SHIPTOFIRSTNAME
(Optional) First name in the shipping address.
Character length and limitations: 30 characters
SHIPTOLASTNAME
(Optional) Last name in the shipping address.
Character length and limitations: 30 characters
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
PayPal Credit Card Transaction Request Parameters
Field
Description
SHIPTOSTREET
(Optional) Shipping street address.
Character length and limitations: 30 characters
SHIPTOCOUNTRY
(Optional) Numeric country code of ship-to country. Example: USA: 840.
Character length and limitations: 3 alphanumeric characters
SHIPTOZIP
(Optional) Shipping 5- to 9-digit zip (postal) code excluding spaces, dashes, and
non-numeric characters. Example: 951121737
Character length and limitations: 9 alphanumeric characters
SHIPTOPHONENUM
(Optional) Shipping telephone number.
Character length and limitations: 10 alphanumeric characters
A
Additional Credit Card Parameters for M Record
Field
Description
MERCHDESCR
(Optional) Use this parameter to pass in your DBA name and other data describing
the transaction. This information is usually displayed in the account holder’s
statement.
Character length and limitations: 25 alphanumeric characters
MERCHSVC
(Optional) Defaults to the city where the merchant outlet is located for retail and to
the merchant’s phone number for non-retail. For example, 800 111-1111. This
information is usually displayed in the account holder’s statement.
Character length and limitations: 13 alphanumeric characters
PayPal Credit Card Transaction Request Parameters
In addition to the core credit card parameters, PayPal accepts the parameters described below.
Parameter
Description
ACCTTYPE
(Optional) Credit card type. The following card types are supported:
0 = Visa
1 = MasterCard
2 = Discover
3 = AMEX
4 = DinersClub
5 = JCB
8 = Other
Gateway Developer Guide and Reference
31 July 2012
115
A
Processors Requiring Additional Transaction Parameters
PayPal Credit Card Transaction Request Parameters
Parameter
Description
AMT
(Required) Amount (US Dollars) U.S. based currency.
AMT=ITEMAMT + TAXAMT + FREIGHTAMT + HANDLINGAMT + INSURANCEAMT
- DISCOUNT
N O TE :
You must set CURRENCY to one of the three-character currency codes for any
of the supported PayPal currencies. See CURRENCY in this table for details.
Limitations: Must not exceed $10,000 USD in any currency. Nine numeric characers
plus decimal (.) character. No currency symbol. Specify the exact amount to the cent
using a decimal point—use 34.00, not 34. Do not include comma separators—use
1199.95 not 1,199.95.
Nine numeric characters plus decimal.
CURRENCY
(Required) The currency code.
N O TE :
CURRENCY is applicable only to processors that support transaction-level
currency.
Limitations: Three characters.
BUTTONSOURCE
(Optional) Identification code for use by third-party applications to identify
transactions.
Limitations: 32 alphanumeric characters.
CUSTIP
(Optional) IP address of payer’s browser as recorded in its HTTP request to your
website. This value is optional but recommended.
N O TE :
PayPal records this IP address as a means to detect possible fraud.
Limitations: 15-character string in dotted quad format: xxx.xxx.xxx.xxx
CAPTURECOMPLETE
(Optional) Indicates if this Delayed Capture transaction is the last capture you intend
to make. The values are:
Y (default)
N
N O TE :
If CAPTURECOMPLETE is Y, any remaining amount of the original
reauthorized transaction is automatically voided.
Limitations: 12-character alphanumeric string.
116
CUSTOM
(Optional) A free-form field for your own use.
Limitations: 256-character alphanumeric string.
EMAIL
(Optional) Email address of payer.
Limitations: 127 alphanumeric characters.
INVNUM
(Optional) Your own unique invoice or tracking number.
Limitations: 127 alphanumeric characters.
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
PayPal Credit Card Transaction Request Parameters
Parameter
Description
ITEMAMT
(Required if L_COSTn is specified) Sum of cost of all items in this order.
ITEMAMT = L_QTY0*LCOST0 + L_QTY1*LCOST1...L_QTYn*L_COSTn
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
Specify the exact amount to the cent using a decimal point—use 34.00, not 34. Do not
include comma separators—use 1199.95 not 1,199.95.
Limitations: Nine numeric characters plus decimal.
TAXAMT
(Required if L_TAXAMTn is specified) Sum of tax for all items in this order.
TAXAMT=L_QTY0*L_TAXAMT0 + L_QTY1*L_TAXAMT1 +...L_QTYn
*L_TAXAMTn
N O TE :
A
You must set CURRENCY to one of the three-character currency codes for any
of the supported PayPal currencies. See CURRENCY in this table for details.
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
Specify the exact amount to the cent using a decimal point—use 34.00, not 34. Do not
include comma separators—use 1199.95 not 1,199.95.
Nine numeric characters plus decimal.
FREIGHTAMT
(Optional) Total shipping costs for this order.
N O TE :
You must set CURRENCY to one of the three-character currency codes for any
of the supported PayPal currencies. See CURRENCY in this table for details.
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
Specify the exact amount to the cent using a decimal point—use 34.00, not 34. Do not
include comma separators—use 1199.95 not 1,199.95.
Nine numeric characters plus decimal.
HANDLINGAMT
(Optional) Total handling costs for this order.
N O TE :
You must set CURRENCY to one of the three-character currency codes for any
of the supported PayPal currencies. See CURRENCY in this table for details.
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
Specify the exact amount to the cent using a decimal point—use 34.00, not 34. Do not
include comma separators—use 1199.95 not 1,199.95.
Nine numeric characters plus decimal.
DISCOUNT
(Optional) Shipping discount for this order. Specify the discount as a positive
amount.
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
Specify the exact amount to the cent using a decimal point—use 34.00, not 34. Do not
include comma separators—use 1199.95 not 1,199.95.
INSURANCEAMT
(Optional) Total shipping insurance cost for this order.
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
Specify the exact amount to the cent using a decimal point—use 34.00, not 34. Do not
include comma separators—use 1199.95 not 1,199.95.
Gateway Developer Guide and Reference
31 July 2012
117
A
Processors Requiring Additional Transaction Parameters
PayPal Credit Card Transaction Request Parameters
Parameter
Description
L_NAMEn
(Optional) Line-item name.
N O TE :
To enable line-item support, you must contact Merchant Technical Support at
http://www.paypal.com/mts
Character length and limitations: 36 alphanumeric characters.
L_DESCn
(Optional) Line-item description of the item purchased such as hiking boots or
cooking utensils.
N O TE :
To enable line-item support, you must contact Merchant Technical Support at
http://www.paypal.com/mts
Limitations: 127 alphanumeric characters.
L_COSTn
(Required if L_QTYn is supplied) Cost of the line item. The line-item unit price can be
a positive or a negative value but not 0.
N O TE :
To enable line-item support, you must contact Merchant Technical Support at
http://www.paypal.com/mts
N O TE :
You must set CURRENCY to one of the three-character currency codes for any
of the supported PayPal currencies. See CURRENCY in this table for details.
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
Specify the exact amount to the cent using a decimal point—use 34.00, not 34. Do not
include comma separators—use 1199.95 not 1,199.95.
Nine numeric characters plus decimal.
L_QTYn
(Required if L_COSTn is supplied) Line-item quantity.
N O TE :
To enable line-item support, you must contact Merchant Technical Support at
http://www.paypal.com/mts
Limitations: 10-character integer.
L_SKUn
(Optional) Product number.
N O TE :
To enable line-item support, you must contact Merchant Technical Support at
http://www.paypal.com/mts
Limitations: 18-characters.
L_TAXAMTn
(Optional) Line-item tax amount.
N O TE :
To enable line-item support, you must contact Merchant Technical Support at
http://www.paypal.com/mts
Limitations: Nine numeric characers plus decimal (.) character. No currency symbol.
Specify the exact amount to the cent using a decimal point—use 34.00, not 34. Do not
include comma separators—use 1199.95 not 1,199.95.
MERCHANTSESSIONID
118
(Optional) Your customer Direct Payment session identification token.
PayPal records this session token as an additional means to detect possible fraud.
Limitations: 64 characters.
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
PayPal Credit Card Transaction Request Parameters
Parameter
Description
NOTIFYURL
(Optional) Your URL for receiving Instant Payment Notification (IPN) about this
transaction. If you do not specify NOTIFYURL in the request, the notification URL
from your Merchant Profile is used, if one exists.
Limitations: 2048 alphanumeric characters.
ORDERDESC
(Optional) Description of items the customer is purchasing.
Limitations: 127 alphanumeric characters.
RECURRINGTYPE
(Optional) Type of transaction occurrence. The values are:
F = First occurrence
S = Subsequent occurrence (default)
A
Limitations: One alpha character.
BILLTOCITY
(Conditional) Bill-to city address.
Limitations: 40 alphanumeric characters.
N O TE :
BILLTOSTATE
(Conditional) Bill-to state or province address.
Limitations: 40 alphanumeric characters.
N O TE :
BILLTOCOUNTRY
Some merchants maybe required to pass this billing information. Please test
your integration first to determine if the billing information fields are
required.
(Conditional) Bill-to country address.
Limitations: 2 alphanumeric characters.
N O TE :
SHIPTOSTREET
Some merchants maybe required to pass this billing information. Please test
your integration first to determine if the billing information fields are
required.
Some merchants maybe required to pass this billing information. Please test
your integration first to determine if the billing information fields are
required.
(Optional) Ship-to street address.
N O TE :
If you pass in any of the ship-to address parameters such as SHIPTOCITY or
SHIPTOSTATE, you must pass in the complete set (that is, SHIPTOSTREET,
SHIPTOCITY, SHIPTOSTATE, SHIPTOCOUNTRY, and SHIPTOZIP).
Limitations: 30-character string.
SHIPTOCITY
(Optional) Ship-to city address.
N O TE :
If you pass in any of the ship-to address parameters such as SHIPTOCITY or
SHIPTOSTATE, you must pass in the complete set (that is, SHIPTOSTREET,
SHIPTOCITY, SHIPTOSTATE, SHIPTOCOUNTRY, and SHIPTOZIP).
Limitations: 40-character string.
Gateway Developer Guide and Reference
31 July 2012
119
A
Processors Requiring Additional Transaction Parameters
SecureNet Additional Credit Card Parameters for American Express
Parameter
Description
SHIPTOSTATE
(Optional) Ship-to state or province address.
N O TE :
If you pass in any of the ship-to address parameters such as SHIPTOCITY or
SHIPTOSTATE, you must pass in the complete set (that is, SHIPTOSTREET,
SHIPTOCITY, SHIPTOSTATE, SHIPTOCOUNTRY, and SHIPTOZIP).
Limitations: 10-character string.
SHIPTOCOUNTRY
(Optional) Ship-to country code.
N O TE :
If you pass in any of the ship-to address parameters such as SHIPTOCITY or
SHIPTOSTATE, you must pass in the complete set (that is, SHIPTOSTREET,
SHIPTOCITY, SHIPTOSTATE, SHIPTOCOUNTRY, and SHIPTOZIP).
Limitations: Two alpha characters.
SHIPTOZIP
(Optional) U.S. ship-to zip code or other country-specific postal code.
N O TE :
If you pass in any of the ship-to address parameters such as SHIPTOCITY or
SHIPTOSTATE, you must pass in the complete set (that is, SHIPTOSTREET,
SHIPTOCITY, SHIPTOSTATE, SHIPTOCOUNTRY, and SHIPTOZIP).
Limitations: 20-character string.
SecureNet Additional Credit Card Parameters for American
Express
In addition to the core credit card parameters, SecureNet accepts the parameters described
below to meet American Express reporting and statement requirements.
Retail Transaction Advice Addendum (for SWIPE transactions)
120
Field
Description
L_DESCn
(Optional) Description of this line-item (n is a line item number from 1 to 6).
Character length and limitations: 19 alphanumeric characters
L_AMTn
(Optional) Amount of this line-item (n is a line item number from 1 to 6).
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
L_QTYn
(Optional) Quantity of this line-item (n is a line item number from 1 to 6).
Character length and limitations: 3 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
SecureNet Additional Credit Card Parameters for American Express
A
Internet Transaction Data
Field
Description
BILLTOEMAIL
(Optional) Account holder’s email address.
Character length and limitations: 60 alphanumeric characters
BILLTOPHONENUM
(Optional) Account holder’s telephone number.
Character length and limitations: 10 characters
PHONETYPE
(Optional) Telephone company provided ANI information identifier digits indicating
the telephone call type. Examples: cellular (61-63), payphone (27).
Character length and limitations: 2 alphanumeric characters
CUSTHOSTNAME
(Optional) Name of the server that the account holder is connected to. Example:
PHX.QW.AOL.COM.
Character length and limitations: 60 alphanumeric and special characters
CUSTBROWSER
(Optional) Name of the server that the account holder is connected to. Example:
MOZILLA/4.0~(COMPATIBLE;~MSIE~5.0;~WINDOWS~95)
Character length and limitations: 60 alphanumeric and special characters
CUSTIP
(Optional) Account holder’s IP address.
Character length and limitations: 15 alphanumeric and special characters
SHIPTOCOUNTRY
(Optional) Numeric country code of ship-to country. Example: USA: 840.
Character length and limitations: 3 alphanumeric characters
SHIPMETHOD
(Optional) Shipping method code. The values are:
01 = Same day
02 = Overnight/next day
03 = Priority, 2 - 3 days
04 = Ground, 4 or more days
05 = Electronic delivery
06 - ZZ = Reserved for future use
AVS Parameters
Field
Description
BILLTOSTREET
(Optional) Account holder’s street address (number and street name).
Character length and limitations: 20 characters
BILLTOZIP
(Optional) Account holder’s 5- to 9-digit ZIP (postal) code excluding spaces,
dashes, and non-numeric characters. Example: 951121737
Character length and limitations: 9 characters
Gateway Developer Guide and Reference
31 July 2012
121
A
Processors Requiring Additional Transaction Parameters
SecureNet Additional Credit Card Parameters for American Express
Field
Description
BILLTOPHONENUM
(Optional) Account holder’s telephone number. The formats are:
xxx-xxx-xxxx (US numbers)
+xxxxxxxxxxx (international numbers)
Character length and limitations: 10 characters
SHIPTOFIRSTNAME
(Optional) First name in the shipping address.
Character length and limitations: 30 characters
SHIPTOLASTNAME
(Optional) Last name in the shipping address.
Character length and limitations: 30 characters
SHIPTOSTREET
(Optional) Shipping street address.
Character length and limitations: 30 characters
SHIPTOCOUNTRY
(Optional) Numeric country code of ship-to country. Example: USA: 840.
Character length and limitations: 3 alphanumeric characters
SHIPTOZIP
(Optional) Shipping 5- to 9-digit zip (postal) code excluding spaces, dashes, and
non-numeric characters. Example: 951121737
Character length and limitations: 9 alphanumeric characters
SHIPTOPHONENUM
(Optional) Shipping telephone number.
Character length and limitations: 10 alphanumeric characters
Location Transaction Advice Addendum Parameters
Parameter
Description
MERCHANTNAME
(Optional) Name of merchant.
Character length and limitations: 38 alphanumeric characters
MERCHANTSTREET
(Optional) Merchant’s street address (number and street name).
Character length and limitations: 38 alphanumeric characters. If more than 38
characters, use proper and meaningful abbreviation. Do not truncate.
MERCHANTCITY
(Optional) The name of the city were the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another
entity), you must enter the name of the city in which the seller is located.
If you are a mail order, phone order, or internet industry, you may substitute the
name of the city in which the merchant’s order processing facility is located.
Character length and limitations: 21 alphanumeric characters. If more than 21
characters, use proper and meaningful abbreviation. Do not truncate.
122
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
SecureNet Additional Credit Card Parameters for American Express
Parameter
Description
MERCHANTSTATE
(Optional) The region code that corresponds to the state, province, or country
subdivision of the merchant location where the transaction took place.
Region code examples:
CA = California, USA
NS = Nova Scotia, Canada
COS = Colima Mexico
A
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the region code that corresponds to the state, province, or country
subdivision in which the seller is located.
Character length and limitations: 3 alphanumeric characters
MERCHANTCOUNTRYCODE
(Optional) Country code of the location where the transaction took place.
Character length and limitations: 3 alphanumeric characters
MERCHANTZIP
(Optional) The 5- to 9-digit zip (postal) code excluding spaces, dashes, and nonnumeric characters where the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the postal code that corresponds to the seller’s location.
Character length and limitations; 15 alphanumeric characters
Transaction Advice Detail Parameters
Field
Description
ADDLAMTn
(Optional) Detail of a charge where n is a value from 1 - 5. Use for additional
breakdown of the amount.
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
ADDLAMTTYPEn
(Optional) A 3-digit code indicating the type of the corresponding charge detail,
where n is a value from 1 - 5.
Character length and limitations: 3 numeric characters
Airline Passenger Data Parameters
Field
Description
AIR-DEPARTUREDATE
(Optional) Departure date in the format: YYYYMMDD.
Character length and limitations: 8 alphanumeric characters
AIR-PASSENGERNAME
(Optional) Name of the passenger in the following format with fields separated by a
space: surname firstname middleinitial title
Character length and limitations: 40 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
123
A
Processors Requiring Additional Transaction Parameters
SecureNet Additional Credit Card Parameters for American Express
Field
Description
AIR-ORIGIN
(Optional) Airport code of the originating airport. For a list of airport codes, see
http://www.world-airport-codes.com/alphabetical/airport-code/a.html.
N O TE :
Present day airport codes are three characters in length. The five character
length is designed to allow for future expansion.
Character length and limitations: 5 alphanumeric characters
AIR-DESTINATION
(Optional) Destination airport code for the first segment of the trip; this is not
necessarily the final destination. For example, if a passenger flies from STL to MIA
with a layover at JFK, the destination airport is JFK. For a list of airport codes, see
http://www.world-airport-codes.com/alphabetical/airport-code/a.html.
N O TE :
Present day airport codes are three characters in length. The five character
length is designed to allow for future expansion.
Character length and limitations: 5 alphanumeric characters
AIR-NUMBEROFCITIES
(Optional) Number of unique cities in this trip including the cities of origin and
destination, where a maximum value of 10 is allowed. For example, AIRNUMBEROFCITIES is 3 for the following trip:
DEN to LAX
LAX to SFO
SFO to DEN
If not provided, this value is equal to the number of AIR-ROUTINGCITYn
parameters.
Character length and limitations: numeric, maximum value is 10
AIR-ROUTINGCITYn
(Optional) Airport codes of each city in this flight including cities of origin and
destination, where n is a value from 1 to 10. For a list of airport codes, see
http://www.world-airport-codes.com/alphabetical/airport-code/a.html.
N O TE :
Present day airport codes are three characters in length. The five character
length is designed to allow for future expansion.
Character length and limitations: 5 alphanumeric characters
AIR-CARRIERn
(Optional) Two character airline code for each unique airline in this flight, where n is
a value from 1 to 10. If the same carrier is used for multiple segments of the trip, it is
passed only once. For example, the two AIR-CARRIERn values for the following trip
are UA and AA:
UA flight from IAD to DEN
UA flight from DEN to LAX
UA flight from LAX to SFO
AA flight from SFO to DFW
For information about airlines codes, see http://en.wikipedia.org/wiki/Airline_codesAll.
Character length and limitations: 5 alphanumeric characters
AIR-FAREBASIS
124
(Optional) List discounts associated with the travel.
Character length and limitations: 24 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
Vantiv Additional Credit Card Parameters
Field
Description
AIRNUMBEROFPASSENGERS
(Optional) Number of passengers on this trip.
Character length and limitations: numeric
AIR-ISETICKET
(Optional) If this is an electronic ticket.
Character length and limitations: 1 alphanumeric character (Y or N)
AIR-RESERVATIONCODE
(Optional) Code assigned to the travel reservation before the ticket was purchased.
Character length and limitations: 15 alphanumeric characters
A
Other Parameters
Field
Description
BILLTOFIRSTNAME
(Optional) Account holder's first and last name.
N O TE :
Even though the parameter name indicates only the first name, this single
parameter holds all of the person's name information (both first and last
name, at a minimum).
Character length and limitations: 13 alphanumeric characters
BILLTOLASTNAME
(Optional) Account holder's last name.
Character length and limitations: 13 alphanumeric characters
INVNUM
(Optional) Merchant invoice number. The merchant invoice number is used for
authorizations and settlements and, depending on your merchant bank, will appear on
your customer's credit card statement and your bank reconciliation report. If you do
not provide an invoice number, the transaction ID (PNREF) will be submitted.
Character length and limitations: 17 alphanumeric characters
ORDERDATE
(Optional) Specifies an order date.
Character length and limitations: 6 numeric characters
Format: mmddyy (with no slashes or dashes). For example, July 28, 2003 is 072803.
Vantiv Additional Credit Card Parameters
Additional Credit Card Parameters
Field
Description
MERCHDESCR
(Optional) Use this parameter to pass in your DBA name and other data describing
the transaction. This information will be displayed in the account holder’s statement.
Character length and limitations: 25 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
125
A
Processors Requiring Additional Transaction Parameters
Vantiv Additional Credit Card Parameters
Soft Merchant Descriptor Parameters
Field
Description
MERCHANTNAME
(Optional) Name of merchant.
Character length and limitations: 38 alphanumeric characters
MERCHANTSTREET
(Optional) Merchant’s street address (number and street name).
Character length and limitations: 38 alphanumeric characters. If more than 38
characters, use proper and meaningful abbreviation. Do not truncate.
MERCHANTCITY
(Optional) The name of the city were the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another
entity), you must enter the name of the city in which the seller is located.
If you are a mail order, phone order, or internet industry, you may substitute the
name of the city in which the merchant’s order processing facility is located.
Character length and limitations: 21 alphanumeric characters. If more than 21
characters, use proper and meaningful abbreviation. Do not truncate.
MERCHANTSTATE
(Optional) The region code that corresponds to the state, province, or country
subdivision of the merchant location where the transaction took place.
Region code examples:
CA = California, USA
NS = Nova Scotia, Canada
COS = Colima Mexico
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the region code that corresponds to the state, province, or country
subdivision in which the seller is located.
Character length and limitations: 3 alphanumeric characters
126
MERCHANTZIP
(Optional) The 5- to 9-digit zip (postal) code excluding spaces, dashes, and nonnumeric characters where the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the postal code that corresponds to the seller’s location.
Character length and limitations: 15 alphanumeric characters
MERCHANTCOUNTRYCODE
(Optional) Country code of the location where the transaction took place.
Character length and limitations: 3 alphanumeric characters
MERCHANTLOCATIONID
(Optional)Merchant-assigned store or location number (or name) that uniquely
identifies where the transaction took place.
Character length and limitations: 15 alphanumeric characters
MERCHANTID
(Required) American Express-assigned service establishment number used to identify
and facilitate payments to merchants.
Character length and limitations: 15 alphanumeric characters.
31 July 2012
Gateway Developer Guide and Reference
Processors Requiring Additional Transaction Parameters
WorldPay Additional Credit Card Parameters
Field
Description
MERCHANTCONTACTINFO
(Optional) Merchant’s telephone number or web address. (URLs and e-mail addresses
may be lowercase, as appropriate.) This entry may appear on the descriptive bill on
the card-member’s statement, or may be used to resolve billing inquiries and disputes.
N O TE :
A
American Express strongly recommends that aggregators (third-parties who
bill for goods or services rendered by another entity) always fill in this field
with the URL, e-mail address, or telephone number of the contact responsible
for resolving disputes or inquiries.
Character length and limitations: 40 alphanumeric characters
WorldPay Additional Credit Card Parameters
Field
Description
ADDLAMTn
(Optional) Detail of a charge, where n is a value from 1 - 5. Use for additional
breakdown of the amount.
Character length and limitations: 11 alphanumeric characters
ADDLAMTTYPEn
(Optional) A 3-digit code indicating the type of the corresponding charge detail,
where n is a value from 1 - 5.
Character length and limitations: 18 alphanumeric characters
CATTYPE
(Optional) Type of terminal.
Character length and limitations: numeric characters
CONTACTLESS
(Optional) Describes the card input capability. It is the value RFD, which means the
card contains a radio frequency identification (RFID) chip for communicating with a
point-of-sale device with an RFID receiver.
Character length and limitations: alpha characters
Gateway Developer Guide and Reference
31 July 2012
127
A
128
Processors Requiring Additional Transaction Parameters
WorldPay Additional Credit Card Parameters
31 July 2012
Gateway Developer Guide and Reference
B
TeleCheck Electronic Check
Processing
This appendix describes the host-based capture version of the TeleCheck Non-Face-To-Face
Check Acceptance (NFTF) services.
TeleCheck NFTF Overview of Services
NFTF offers merchants the convenience of electronic check deposits. When a NFTF
transaction is approved by TeleCheck, the manually entered MICR data from the check is
electronically converted to an ACH debit and is processed through the ACH Network. The
merchant receives funds within two banking days.
NFTF includes TeleCheck Internet Check Acceptance (ICA), Checks By Phone (CBP), and
Prearranged Deposit Services (NFTF PPD). Each of these products requires a separate
Merchant ID also known as a Subscriber ID. See below for more details.
ICA provides merchants with the capability to authorize and electronically settle checks
presented by customers over the internet. ICA can be single entry or recurring. This is
based on customer's authorization received over the internet.
CBP authorizes and electronically settles checks presented over the phone through
customer interaction with a merchant call center representative. CBP services are single
entry only. Partial debits and recurring entries are not allowable per NACHA guidelines.
NFTF prearranged payment and deposit entry (NFTF PPD) may be used for either
recurring or non-recurring debits to a customer's account, when the merchant has provided
the customer with a written authorization, which the customer has signed or similarly
authenticated. Actual payments are facilitated via the internet or via IVR or over the phone.
The application type value must be set to PPD. PPD accounts must establish an end date to
clearly define terms between customer and merchant, but do not have time period caps.
TeleCheck NFTF Processing Overview
NFTF requirements, processing considerations, and guidelines for processing check payments
are described below.
NFTF Requirements
The following requirements must be followed as standard operating procedures to
electronically process a NFTF check payment:
A TeleCheck Merchant ID is required on all transactions and is unique to each location.
Gateway Developer Guide and Reference
31 July 2012
129
B
TeleCheck Electronic Check Processing
TeleCheck NFTF Processing Overview
130
Dual ID is required for all transactions. For personal checks, it must be MICR data and
personal check writer identification such as a driver’s license. For company checks, it must
be MICR data and Federal Tax ID. In the event that a company does not have a Federal Tax
ID, the driver’s license can also be used.
For ICA and NFTF PPD, the merchant must retain the customer’s authorization of the
transaction for a period of 2 years and, for ICA, prompt the customer to print a copy of this
confirmation for their records. The merchant must adhere to all authorization requirements,
data elements, legal verbiage, and check return fee requirements.
For CBP, the merchant must audio record the customer’s verbal confirmation of the
transaction or provide a written confirmation of the transaction to the customer prior to
settlement. In either case, the confirmation must be live; IVR is not acceptable for
confirmation. If a merchant chooses audio, the merchant must have the technical capability
to retain these recordings for a period of 2 years; else the written confirmation may be
substituted and retained for the same time period. The merchant must adhere to all
authorization requirements; data elements, legal verbiage, and check return fee
requirements.
Only select US accounts drawn on U.S. banks participating in the ACH Network are
eligible for processing via the ACH Network.
TeleCheck Trace ID (TTID) is required for all supplemental messages, change, void, and
adjustment transactions.
Merchant Trace ID is required for all adjustment transactions. This field allows additional
capabilities to be enabled such as Overflow Credits and MIA Duplicate Checking.
Change and Void transactions are only allowed within the original Sale processing window.
For NFTF, cutoff time is 4:00PM CST (recommend working with 3:30PM CST).
Adjustment transactions are electronically allowed within 90 days after the Sale
transaction. After the 90 day period, all adjustments must be manually processed.
A prompt or process must be in place to identify a check as either personal or company.
Duplicate Checking – TeleCheck has the ability to detect duplicate sale transactions at the
point of sale if sent within a predetermined time limit. Duplicates are identified when a sale
inquiry is received with the same amount, MICR number, and check number matching a
sale inquiry received within the last 2 minutes. If a duplicate is detected it will return an
ineligible response for ACH. The 2nd transaction will also receive an ineligible response
for ACH with the same ACH Transaction Status and Response Code as the original sale
transaction.
The appropriate Application Type value must be sent to TeleCheck to indicate the type of
NFTF transaction (ICA, CBP, or NFTF PPD).
In the NFTF technical specification several data element fields and features are described
as “optional.” While these are technically optional, meaning that the product can be
technically implemented with or without them, TeleCheck may require the merchant to
code to one or more of these optional items based on the agreed upon contractual terms.
The merchant may need to account for and enable additional data element fields and
product features in their system(s) and in communications to TeleCheck’s Authorization
31 July 2012
Gateway Developer Guide and Reference
TeleCheck Electronic Check Processing
TeleCheck NFTF Processing Overview
B
System. Various optional data elements throughout each of the message packets could be
affected by this requirement.
First Data Gateway Partners, External Gateway vendors, First Data Platforms, and the
Global Gateway Router (GGR) that route merchant transactions to TeleCheck via this
specification must code for all fields, features, and functionality available in this
specification. Nothing is optional for these partners. Additionally, these partners are
required to maintain their NFTF specification as new revisions and addendums become
available.
NFTF Processing Considerations
TeleCheck and the Merchant must determine any of the following additional optional features
during contract negotiations.
MIA Duplicate Checking – TeleCheck has the ability to detect duplicate adjustment
transactions in back end processes. Adjustments can be submitted up to 90 days after the
original Sale transaction. While multiple adjustment transactions are allowed for a given
sale transaction, each adjustment transaction must have a unique merchant trace ID.
Duplicates are detected when an adjustment transaction is submitted that has the same
merchant trace ID as a previously submitted adjustment transaction. If a duplicate
adjustment is detected, and the original adjustment was accepted by TeleCheck, the
duplicate will also be accepted. The duplicate transaction will then be filtered out by
TeleCheck’s back end settlement processes.
NFTF Guidelines
The following guidelines should be followed when adhering to the above NFTF Requirements
to electronically process a check payment:
Fields marked as Required are required to process an electronic transaction.
Not all fields are required by every merchant.
Unused fields should be completely omitted from the message.
Each field is variable in length (justification and fillers are not used).
The order of tagged fields from the POS and from the TeleCheck host are not significant.
Fields must not have any hard-coded data values.
The transaction number increments on every attempt.
Message formats outline fields (tags) that are required, not required, or conditional to the Sale,
Status, and Adjustment Inquiry packets.
Message Types:
Merchant Authorization Message and the TeleCheck Authorization Response Message
Merchant Delayed Capture Message and the TeleCheck Delayed Capture Response
Message
Gateway Developer Guide and Reference
31 July 2012
131
B
TeleCheck Electronic Check Processing
TeleCheck Parameters
Transaction flow Method
Messages sent from the Merchant to TeleCheck are authorization messages. Messages sent
from TeleCheck to the Merchant are Response messages.
The sale transaction process is often referred to as a 2-part hand-off. The process begins with
the merchant’s Authorization message. TeleCheck responds with an Authorization response
message indicating whether the transaction is approved and whether the check is eligible for
conversion (whether check conversion will be offered). The Merchant then responds with a
Delayed Capture message, acknowledging receipt of TeleCheck’s sale response, and
indicating whether electronic check conversion was accepted. TeleCheck completes the
transaction with a Delayed Capture response message confirming receipt of the merchant’s
status inquiry message.
TeleCheck Parameters
Parameters used for processing electronic checks through TeleCheck are described in this
section.
132
31 July 2012
Gateway Developer Guide and Reference
TeleCheck Electronic Check Processing
TeleCheck Parameters
B
Required TeleCheck Parameters
Field
Description
USER
(Required) Case-sensitive login ID for the Gateway account that you created while
registering for the account.
In the future, each account will allow multiple users. This parameter will specify the
user.
Character length and limitations: 64 alphanumeric characters
VENDOR
(Required) Case-sensitive Vendor ID that you created while registering for the
account.
Character length and limitations: 64 alphanumeric characters
PARTNER
(Required) The authorized PayPal Reseller that registered you for the Gateway
service provided you with a Partner ID. If you registered yourself, use PayPal.
This parameter is case sensitive.
Character length and limitations: 64 alphanumeric characters
PWD
(Required) Case-sensitive 6- to 32-character password that you created while
registering for the account.
Character length and limitations: 32 alphanumeric characters
AMT
(Required) This is the transaction amount (default U.S. dollars).
The transaction amount should always specify a decimal, and the exact amount to the
cent (for example, 34.00, instead of 34). Do not include comma separators in the
amount. Use 1199.95 not 1,199.95.
Character length and limitations: 7 numeric characters, U.S. dollars only
AUTHTYPE
It is one of the following values:
I – Internet Check Acceptance (ICA) provides the capability to authorize and
electronically settle checks over the intenet.
P – Checks By Phone (CBP) provides the capability to authorize and
electronically settle checks over the phone.
D – Prearranged Deposit Services (PPD) debits the customer’s account provided
the customer has previously accepted a written authorization.
BILLTOCITY
(Required) Account holder’s city.
Character length and limitations: 30 alphanumeric characters
BILLTOCOUNTRY
Account holder’s country. You are required to pass this value when AUTHTYPE=I.
Character length and limitations: 2 alphanumeric characters
BILLTOFIRSTNAME
Account holder’s first name as it appears on the check. You are required to pass this
value when CHKTYPE=C.
Character length and limitations: 30 alphanumeric characters
BILLTOLASTNAME
(Required) Account holder’s last name as it appears on the check.
Character length and limitations: 30 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
133
B
TeleCheck Electronic Check Processing
TeleCheck Parameters
Field
Description
BILLTOPHONENUM
(Required) Account holder’s telephone number.
Character length and limitations: 10 numeric characters. This value may not contain
spaces or non-numeric characters.
BILLTOSTATE
(Required) Account holder’s state.
Character length and limitations: 2 alphanumeric characters
BILLTOSTREET
(Required) Account holder’s street address.
Character length and limitations: 50 alphanumeric characters
BILLTOZIP
(Required) Account holder’s postal code (called ZIP code in the USA). Do not use
spaces, dashes, or non-numeric characters.
Character length and limitations: 11 alphanumeric characters
CHKNUM
(Required) Account holder’s next unused (available) check number.
Character length and limitations: 7 numeric characters
CHKTYPE
(Required) Check type. It is one of the following values:
P – The check is a personal check (default). If CHKTYPE=P, you are required to
pass a value for either DL or SS as an identifier.
C – The check is a company check. If CHKTYPE=C, you are required to pass the
Federal Tax ID for SS.
Character length and limitations:1 alphanumeric character
CUSTIP
Account holder’s IP address. You are required to pass this value when AUTHTYPE=I.
Character length and limitations: 15 alphanumeric characters
DL
(Required) Driver’s license number. If CHKTYPE=P, you are required to pass a value
for either DL or SS as an identifier.
The format of the driver’s license is XXnnnnnnnn where:
XX – State code
nnnnnnnn – Driver’s license number
Character length and limitations: 33 alphanumeric characters
134
BILLTOEMAIL
Account holder’s e-mail address. You are required to pass this value when
AUTHTYPE=I.
Character length and limitations: 100 alphanumeric characters
INVNUM
(Optional) Check invoice number.
Character length and limitations: 9 alphanumeric characters
MICR
(Required) Magnetic ink check reader. The value is the entire line of numbers at the
bottom of all checks. It includes the transit number, account number, and check
number.
Character length and limitations: 65 numeric characters
31 July 2012
Gateway Developer Guide and Reference
TeleCheck Electronic Check Processing
Testing TeleCheck Transactions
Field
Description
SS
Account holder’s social security number. You are required to pass a value for SS
when a value for CHKTYPE is passed:
If CHKTYPE=P, you are required to pass a value for either DL or SS as an identifier.
If CHKTYPE=C, you are required to pass the Federal Tax ID.
B
Character length and limitations: 35 alphanumeric characters
TENDER
(Required) Method of payment. Use only the value K (electronic check).
Character length and limitations: 1 alphabetic character
TRXTYPE
(Required) Type of transaction that should be processed. It is one of the following
values:
A – The transaction is an Authorization.
D – The transaction is a Delayed Capture.
V – The transaction is a Void.
I – The transaction is an Inquiry.
Character length and limitations: 1 alpha character
Testing TeleCheck Transactions
PayPal provides a test server to support testing and configuration. For information on the test
server URL, see “Host URL Addresses” on page 42.
Example Test Transaction
This is the authorization request and response.
TRXTYPE=A&TENDER=K&PARTNER=partner&USER=user&VENDOR=vendor&PWD=pwd&AMT=35.0
0&BILLTOSTREET=1234 Main&BILLTOCITY=Buffalo&DL=CA123456&CHKNUM=1001&BILLTOE
MAIL=john@xyz.com&MICR=3333333333&AUTHTYPE=I&INVNUM=12345&BILLTOFIRSTNAME=S
ally&BILLTOLASTNAME=Smith&BILLTOSTATE=CA&BILLTOZIP=95050&BILLTOCOUNTRY=US&C
USTIP=10.15.5.23&BILLTOPHONENUM=9876542143&VERBOSITY=HIGH RESULT=0&PNREF=EQ
RB8A32CD69&RESPMSG=Approved&AUTHCODE=12&TRACEID=1234567890&ACHSTATUS=A&HOST
CODE=07&TRANSTIME=2012-0209 15:23:37&BILLTOFIRSTNAME=Sally&BILLTOLASTNAME=Smith&AMT=35.00&CARDTYPE=P
This is the delayed capture request and response.
TRXTYPE=D&TENDER=K&PARTNER=partner&USER=user&VENDOR=vendor&PWD=pwd&ORIGID=E
QRB8A32CD69&VERBOSITY=HIGH
RESULT=0&PNREF=EQRB8A32CD6A&RESPMSG=Approved&AUTHCODE=00&TRACEID=1234567890
&ACHSTATUS=A&HOSTCODE=07&TRANSTIME=2012-02-09 15:24:22
Gateway Developer Guide and Reference
31 July 2012
135
B
TeleCheck Electronic Check Processing
Preparing for TeleCheck Production Transactions
MICR values for testing
You may view a complete list of TeleCheck response codes at “Sale Response Code Values”
on page 137
MICR
HOSTCODE
TeleCheck Result
3333333333
07
Approved
1111111111
08
Rejected (negative data)
2222222222
88
Rejected Code 3 (Risk)
Preparing for TeleCheck Production Transactions
Before going into production with your check integration, you must certify your storefront
with TeleCheck. To begin the certification process, send an e-mail to
iica_certification@telecheck.com. Be sure to include the following information:
Your test website address where test transactions can be processed
The name, e-mail address, and phone number of the person to contact about any needed
corrections.
The certification process usually takes 2-3 days.
Use the host address of the live server described in “Host URL Addresses” on page 42.
Responses to TeleCheck Transactions
When a transaction finishes, PayPal returns a response string made up of name-value pairs.
For example:
RESULT=0&PNREF=VXYZ01234567&HOSTCODE=000500&RESPMSG=Approved
TeleCheck transaction response values are described in the table below.
Transaction Responses Common to All Tender Types
136
Field
Description
RESULT
The outcome of the attempted transaction. A result of 0 (zero) indicates the
transaction was approved. Any other number indicates a decline or error.
Character length and limitations: numeric, variable number of characters
PNREF
PayPal Reference ID, a unique number that identifies the transaction.
Character length and limitations: 12 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
TeleCheck Electronic Check Processing
Response Code Values
Field
Description
HOSTCODE
TeleCheck’s response code representing the results of the transaction
authorization attempt.
Character length and limitations: 6 numeric characters
RESPMSG
A descriptive message associated with decline or error result values.
Character length and limitations: alphanumeric, variable number of characters
B
Response Code Values
For your service, below is a complete list of possible Response Codes. Depending upon the
merchants risk parameters and service type, some of these may not apply. Please confirm
applicable codes with TeleCheck’s Merchant Boarding and Certification group.
NOT E :
Merchants should establish policies and procedures for each applicable response code.
For example, if a clerk enters a transaction and receives Response Code 27, they
should retry the transaction. If, after entering the item a second time they receive a
Response Code 27 again, the merchant may choose to cancel or terminate the
transaction and a) retry the transaction b) call TeleCheck Live Operator Authorization
Center, or c) request another form of payment from the check writer.
Sale Response Code Values
Sale Approval Responses
Code
Description
Merchant Action
07
Approved
No action needed.
Sale Decline Responses
Code
Description
Merchant Action
08
Rejected (Negative Data)
Ask for other form of payment or decline sale
to customer.
73
Lost or Stolen check
Ask for other form of payment or decline sale
to customer.
88
Rejected Code 3 (Risk)
Ask for other form of payment or decline sale
to customer.
25
Ineligible – ACH Not Offered
Ask for other form of payment.
NOT E :
Gateway Developer Guide and Reference
Do NOT use the verbiage
“decline” this is not a true decline.
31 July 2012
137
B
TeleCheck Electronic Check Processing
Response Code Values
Sale Referral Responses
Code
Description
Merchant Action
09
Risk Referral requested
Contact TeleCheck.
69
Call Center
Contact TeleCheck.
Sale Error Responses
Code
Description
Merchant Action
46
Merchant setup does not allow this type of
transaction
49
Processor Not Available
98
Invalid MICR Data
27
Invalid Value for Field
78
Invalid RT (Routing/Bank Number)
97
Unable to Process (Time Out)
Re-send message later.
Re-send message later.
Adjustment Code Values
Adjustment (Refund/Change/Void) Responses
Code
Description
Merchant Action
26
Merchant allowed to send full/partial
adjustments/refunds without transaction
errors
No action needed
46
Merchant setup does not allow this type of
transaction
Adjustment cannot be processed by
TeleCheck
79
Original transaction was not approved
Adjustment cannot be processed by
TeleCheck
80
Refund or partial amount is greater than
the original sale amount
Adjustment cannot be processed by
TeleCheck
81
Unable to locate original transaction
(TCK Trace ID)
Adjustment cannot be processed by
TeleCheck
Response Codes For Status Response Packets
Response Codes for Status Response Packets
138
Code
Description
OK
Inquiry (POS system) Packet was accepted and successfully processed by TeleCheck
31 July 2012
Gateway Developer Guide and Reference
TeleCheck Electronic Check Processing
TeleCheck Authorization Requirements
Code
Description
ACK
Inquiry Packet was accepted by the TeleCheck Host
NAK
Inquiry Packet was not successfully processed by TeleCheck (general error)
49
Inquiry Packet was not successfully processed by TeleCheck (scheduled maintenance)
97
Inquiry Packet was not successfully processed by TeleCheck (timeout)
27
Inquiry Packet was not successfully processed by TeleCheck (invalid data)
B
TeleCheck Authorization Requirements
With the TeleCheck Non Face-To-Face (NFTF) Host Based Capture Service, the merchant is
responsible for handling all front-end aspects of the point of sale, including displaying the
appropriate disclosures to the customer. TeleCheck will provide form language for the
merchant to use.
NOT E :
It is the merchant’s responsibility to ensure that they have the most current language
from TeleCheck. TeleCheck will send out a Service Notice when updated language or
system changes are required. Additionally, the Merchant should be familiar with
NACHA, FCRA and Reg. E compliance requirements.
There are two different situations during which the merchant must display legal language:
Authorization – Sales Consent
The language varies slightly between the Internet Check Acceptance and Checks By Phone
services.
Authorization – Sales Decline
The language is identical for Internet Check Acceptance and Checks By Phone services.
Authorization – Sales Consent
With the Non Face-To-Face Host Based Capture Service, the merchant is responsible for
handling all front-end aspects of the point of sale, including displaying the appropriate
disclosures to the customer. TeleCheck will provide form language for the merchant to use.
Internet Check Acceptance Authorizations
At the end of the check out process, the merchant must display consent language for the
customer to accept prior to submitting the authorization request as follows:
Internet Check Acceptance Authorization Consent Required Language
FULL DEBIT
By entering my account number above and clicking Authorize, I authorize my payment to be
processed as an electronic funds transfer or draft drawn from my account. If the payment is
returned unpaid, I authorize you or your service provider to collect the payment and my state’s
Gateway Developer Guide and Reference
31 July 2012
139
B
TeleCheck Electronic Check Processing
TeleCheck Authorization Requirements
return item fee by electronic funds transfer(s) or draft(s) drawn from my account. Click here
to view your state’s returned item fee. If this payment is from a corporate account, I make
these authorizations as an authorized corporate representative and agree that the entity will be
bound by the NACHA Operating Rules.
PARTIAL SHIPMENTS & PARTIAL DEBITS
By entering my account number above and clicking Authorize, I authorize my payment to be
processed as an electronic funds transfer or draft drawn from my account. If my full order is
not available at the same time, I authorize partial debits to my account, not to exceed the total
authorized amount. The partial debits will take place upon each shipment of partial goods. If
any of my payments are returned unpaid, I authorize you or your service provider to collect the
payment and my state’s return item fee by electronic fund transfer(s) or draft(s) drawn from
my account. Click here to view your state’s returned item fee. If this payment is from a
corporate account, I make these authorizations as an authorized corporate representative and
agree that the entity will be bound by the NACHA Operating Rules.
Internet Check Acceptance Recurring Payments (WEB R)
By entering my account number above and clicking Authorize, I authorize my payments to be
processed as electronic funds transfers or drafts drawn from my account. {INSERT
INFORMATION ON PAYMENT AMOUNT, TIMING, ETC.} If any of my payments are
returned unpaid, I authorize you or your service provider to collect the payment and my state’s
return item fee by electronic fund transfer(s) or draft(s) drawn from my account. Click here
to view your state’s returned item fee. If this payment is from a corporate account, I make
these authorizations as an authorized corporate representative and agree that the entity will be
bound by the NACHA Operating Rules. This authorization is to remain in full force and effect
until {NAME OF MERCHANT} has received written notification from me of my
termination in such time and manner as to afford {NAME OF MERCHANT} a reasonably
opportunity to act on it.
This text, Click here to view your state’s returned item fee, in the consent language above
represents a link to the state fee table. TeleCheck has posted a table of current state returned
check fees at
http://www.firstdata.com/support/telecheck_returned_check/returned_check_fees.htm. The
merchant should link directly to the TeleCheck-hosted URL provided above. State fees are
updated on a regular basis and linking to a TeleCheck-hosted page will minimize the number
of maintenance updates required. The merchant may choose how to display the state fees.
Suggestions include a new pop-up window, a full browser window, or directly on the checkout
page.
Checks By Phone Service Authorizations
At the end of the check out process, the customer service agent must read the consent language
to the consumer and, either audio record the consumer’s authorization or send a written
notification of the authorization and the transaction to the consumer prior to settlement of the
transaction. The consent language for the customer to accept prior to submitting the payment
authorization request is as follows:
Checks By Phone Authorization Consent Required Language
FULL DEBIT
140
31 July 2012
Gateway Developer Guide and Reference
TeleCheck Electronic Check Processing
TeleCheck Authorization Requirements
B
Today (insert today’s date), I’d like to confirm that you, (insert first and last name), are
authorizing a payment in the amount of (insert amount) to be processed as an electronic funds
transfer or draft drawn from your account. Do you agree? If your payment is returned unpaid,
you authorize us or our service provider to collect the payment and your state’s return item fee
of (insert state returned item fee) by electronic funds transfer(s) or draft(s) drawn from your
account. Do you agree and authorize the payment?
The merchant should link directly to the TeleCheck-hosted URL provided above. State fees
are updated on a regular basis and linking to a TeleCheck-hosted page will minimize the
number of maintenance updates required. The merchant may choose how you want to display
the state fees. Suggestions include a new pop-up window, a full browser window, or directly
on the checkout page.
NOT E :
For an additional fee, TeleCheck can send the written notification of the authorization
and transaction to the consumer on the merchant’s behalf.
Prearranged Payments and Deposits Authorizations (PPD)
Payments are facilitated, not authorized.
Authorization is via paper from consumer to merchant.
PPD Authorization Requirements:
Must be face-to-face, in writing and signed.
Must clearly and conspicuously state it terms, such as consumer name, payment amount,
payment timing (if recurring) and bank routing/account information. Must also provide that
authorization may be revoked in the manner specified in the authorization.
Customer must be provided a copy.
Language Sample for PPD
By providing a check as payment, I authorize you to use information from my check to make a
one-time electronic funds transfer (EFT) or draft from my account, or to process the payment
as a check transaction. When you use information from my check to make an EFT, funds may
be withdrawn from my account as soon as the same day my payment is received, and I will not
receive my check back from my financial institution. The account referenced above is a
(check one):
Consumer account
Business account
If my payment is returned unpaid, I authorize you or your service provider to collect my
payment and my state’s return fee set forth below by EFT(s) or draft(s) from my account. I
understand that I can revoke this authorization by sending written notice to _____ in such time
and manner as to afford ____ a reasonable opportunity to act on it. If this payment is from a
corporate owned account, I make these authorizations as an authorized corporate
representative and agree that the entity will be bound by the NACHA Operating Rules.
Returned Check Fees:
TeleCheck has posted a table of current state returned check fees at
http://www.firstdata.com/support/telecheck_returned_check/returned_check_fees.htm. The
Gateway Developer Guide and Reference
31 July 2012
141
B
TeleCheck Electronic Check Processing
TeleCheck Authorization Requirements
merchant should link directly to the TeleCheck-hosted URL provided above. State fees are
updated on a regular basis and linking to a TeleCheck-hosted page will minimize the number
of maintenance updates required. The merchant may choose how to display the state fees.
Suggestions include a new pop-up window, a full browser window, or directly on the checkout
page.
AK
$30-
AL
$30
AR
$25
AZ
$25
CA
$25
CO
$20-
CT
$20-
DE
$40
DC
$25
FL
$25_ƒ
GA
$30^
GU
$20
HI
$30-
IA
$30
ID
$20-
IL
$25-
IN
$20-
KS
$30
KY
$50
LA
$25^
MA
$25
MD
$35
ME
$25
MI
$25
MN
$30_œ
MO
$25
MS
$40
MT
$30
NC
$25
ND
$30
NE
$35
NH
$25
NJ
$30
NM
$30
NV
$25
NY
$20-
OH
$30^^
OK
$25
OR
$25
PA
$30
PR
$10
RI
$25
SC
$30
SD
$40
TN
$30-
TX
$30†~
UT
$20-
VA
$50
VI
$20
VT
$25‡
WA
$30_◊
WI
$25-
WV
$25
WY
$30
Authorization – Sales Decline/Error
Authorization requests can fail for a number of reasons, ranging from missing or invalid fields
to business decisions based on risk assessment. These different scenarios need to be handled
differently by the merchant, and require different legal language to be displayed to the
customer.
Sale Decline Required Language
We are sorry that we cannot accept your check at this time. Our decision is based, in whole or
in part, on information provided to us by TeleCheck. We encourage you to call TeleCheck at 1800.366.2425 or write TeleCheck Customer Care at P.O. Box 4513, Houston, TX 77210-4513.
Please provide TeleCheck your driver's license number and the state where it was issued, and
the complete banking numbers printed on the bottom of your check. Under the Fair Credit
Reporting Act, you have the right to a free copy of your information held in TeleCheck's files
within 60 days from today. You may also dispute the accuracy or completeness of any
information in TeleCheck's consumer report. TeleCheck did not make the adverse decision to
not accept your payment item and is unable to explain why this decision was made.
Sale Error Responses
We are unable to process this transaction with the payment information provided. Please use a
different form of payment at this time.
142
31 July 2012
Gateway Developer Guide and Reference
C
Submitting Purchasing Card
Level 2 and Level 3 Transactions
PayPal Payment Services supports passing Purchasing Card Level 2 information (such as
purchase order number, tax amount, and charge description) in the settlement file.
If additional required invoice information and line-item details are included in the transaction,
PayPal formats Purchasing Card Level 3 information in an appropriate format, for example,
EDI (Electronic Data Interchange) 810 format as required by American Express during
settlement processing.
Please contact your merchant bank to determine which parameters are required to obtain the
best rate for level 2 or level 3 type transactions. If in doubt, we recommend you send all the
level 2 and level 3 fields specified below for your processor.
About Purchasing Cards
The procurement process uses purchasing cards for a number of reasons. Purchasing cards:
Eliminate paper-based order systems and associated costs
Improve control and accountability through itemized statements
Foster better risk controls through spending limits and buying from approved vendors
Reduce administrative overhead by empowering employees to make small purchases
Enable enterprises to negotiate better contract pricing and discounts with suppliers by using
vendor detail reports
To promote acceptance and usage of purchasing card programs, card issuers have established
incentive rates for merchants. The incentive rates are available to merchants who comply at
transaction processing Level 2 or Level 3. Transactions that comply at transaction processing
Level 1 qualify as normal credit card transactions.
NOT E :
Card issuing institutions perform strict data verification on the enhanced data that
merchants submit with Level 2 or Level 3 transactions. Issuers may charge stiff
penalties when fields contain either inaccurate or filler data. Only transactions that
contain accurate data are eligible for the incentive rates.
About Program Levels
The term Level does not apply to the card, but to the transaction data submitted for that card.
Generally, a higher level means more detailed data for reporting.
The following table describes the recognized transaction levels.
Gateway Developer Guide and Reference
31 July 2012
143
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
About American Express Purchasing Card Transactions
Level
Description
Level 1
Function as normal credit cards and are authorized and associated with normal
transaction data in authorization and settlement. Any merchant who accepts credit
cards supports this level..
Level 2
Additional data regarding sales tax, customer code, purchase order number, invoice
number are captured at the point of sale. In most cases, this information is combined
with the merchant’s tax ID number, state, and postal code data and is then passed
through during settlement. For some processors and banks, however, a Level 2
authorization may include some of this data.
Level 3
Significant additional information such as line items, product codes, item
descriptions, unit price, unit quantities, and ship-to postal data are added to the Level
2 data to provide optimal reporting to buyers and sellers. Settlement transactions
typically carry Level 3 data.
Level 2 and Level 3 data is generally considered non-financial data. Lack of adequate data
may cause a transaction to be downgraded.
PayPal generally requires up to Level 2 information in an authorization transaction followed
by additional Level 3 data in the associated delayed capture transaction. A sale transaction
should include all Level 3 data since it is authorized and later settled.
Accepted BIN Ranges
Visa, MasterCard, and American Express publish specific Bank Identification Number (BIN)
ranges for purchasing cards. Sometimes the processor determines whether a card is a
purchasing card, for example, TSYS Acquiring Solutions. In other cases, the Gateway makes
the determination based on the BIN range (for example, FDMS South and American Express).
About American Express Purchasing Card Transactions
The information in this section applies to transactions processed by American Express not
necessarily to all American Express cards. Level 2 and Level 3 purchasing card rules may
differ for American Express card transactions processed by other processors such as
Paymentech or First Data Nashville.
Supported Transaction Types
You can submit Level 3 parameters with delayed capture, sale, credit, or force transactions.
Level 3 data in authorization transactions is ignored. The Gateway decides whether a
transaction meets Level 3 requirements during authorization.
Level 3 data is passed to the American Express processor only during settlement.
144
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
About American Express Purchasing Card Transactions
C
Avoiding Downgrade
If a transaction uses the purchasing card BIN range (see “Accepted BIN Ranges” on page 146)
and contains a line item but does not include all mandatory Level 3 parameters, the transaction
succeeds but is processed as Level 2 or Level 1 during settlement (depending on which data
was passed).
For downgraded transactions, with the VERBOSITY parameter set to HIGH, the ADDLMSGS
field returns a message like the following:
Features not processed: PCARD L3 (missing or invalid: InvoiceNumber
RequestorName)
— or —
Features not processed: PCARD L3 (line item 3 missing: Description)
For details on VERBOSITY, see “VERBOSITY: Viewing Processor-Specific Transaction
Results” on page 199
Submitting Successful Level 3 Transactions
If a transaction uses the purchasing card BIN range, contains all mandatory Level 3 fields, and
has at least 1 line item (with all mandatory line item fields), the Gateway flags it as Level 3.
Edit Check
The Gateway performs an edit check on the transaction’s amount fields to ensure that all line
item and tax amounts balance.
If the edit check fails, the transaction fails with Result 4: Invalid Amount.
To pass the edit check, the following relationship must be true:
Transaction Amount = Total Tax Amount + Total Freight Amount + Total
Handling Amount + Total Line Item Amount.
Transaction Amount
Total amount for the transaction, AMT
Total Tax Amount
TAXAMT
Total Freight Amount
FREIGHTAMT, or, if not present, the summation of L_FREIGHTAMTn for all line
items
Total Handling Amount
HANDLINGAMT, or, if not present, the summation of L_HANDLINGAMTn for all
line items
Total Line Item Amount
Summation of L_QTYn * L_COSTn for all line items (n as the line item
number). For example, if there are 2 line items, then the Total Line Item Amount
would be (LQTY1*LCOST1) + (LQTY2*LCOST2)
Gateway Developer Guide and Reference
31 July 2012
145
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
American Express Purchasing Card Transaction Processing
Accepted BIN Ranges
The following BIN ranges are accepted for American Express Level 2 and Level 3
transactions:
37326
37429
37857
37859
37873
37965
American Express Purchasing Card Transaction Processing
The American Express supports Level 2 transaction data.
NOT E :
Most merchants in the United States follow American Express reporting and
statement requirements.International merchants now follow these requirements as
well, but there maybe a few exceptions. If you are not sure, contact your American
Express Representative.
American Express Level 2 Parameters for American Express
The parameters to meet American Express reporting and statement requirements are described
in the following tables.
CPC Level 2 Transaction Advice Addendum Parameters
Field
Description
PONUM
(Required) Purchase order number.
Character length and limitations: 17 alphanumeric characters
SHIPTOZIP
(Optional) Ship-to postal code (called zip code in the USA). This field must contain
one of the following values:
Zip code of the destination where the merchandise is to be shipped
(If the above is not available) Zip code of the location where the merchant
executed the transaction
Character length and limitations: 15 alphanumeric characters
146
TAXAMT
(Optional) Total tax amount. Must include a decimal and the exact amount to the cent
(42.00, not 42). Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_DESC1
(Optional) Description of this line item; if not provided, DESC1 (if present) is used.
Character length and limitations: 140 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
American Express Purchasing Card Transaction Processing
Field
Description
L_AMT1
(Optional) Charge for this line item. Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_QTY1
(Optional) Quantity of this line item.
Character length and limitations: 3 numeric characters
L_DESC2
(Optional) Description of this line item; if not provided, DESC2 (if present) is used.
Character length and limitations: 40 alphanumeric characters
L_AMT2
(Optional) Charge for this line item. Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_QTY2
(Optional) Quantity of this line item.
Character length and limitations: 3 numeric characters
L_DESC3
(Optional) Description of this line item; if not provided, DESC3 (if present) is used.
Character length and limitations: 40 alphanumeric characters
L_AMT3
(Optional) Charge for this line item. Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_QTY3
(Optional) Quantity of this line item.
Character length and limitations: 3 numeric characters
L_DESC4
(Optional) Description of this line item; if not provided, DESC4 (if present) is used.
Character length and limitations: 30 alphanumeric characters
L_AMT4
(Optional) Charge for this line item. Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_QTY4
(Optional) Quantity of this line item.
Character length and limitations: 3 numeric characters
C
Location Transaction Advice Addendum Parameters
Field
Description
MERCHANTNAME
(Optional) Name of merchant.
Character length and limitations: 38 alphanumeric characters
MERCHANTSTREET
(Optional) Merchant’s street address (number and street name).
Character length and limitations: 38 alphanumeric characters. If more than 38
characters, use proper and meaningful abbreviation. Do not truncate.
Gateway Developer Guide and Reference
31 July 2012
147
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
American Express Purchasing Card Transaction Processing
Field
Description
MERCHANTCITY
(Optional) The name of the city were the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another
entity), you must enter the name of the city in which the seller is located.
If you are a mail order, phone order, or internet industry, you may substitute the
name of the city in which the merchant’s order processing facility is located.
Character length and limitations: 21 alphanumeric characters. If more than 21
characters, use proper and meaningful abbreviation. Do not truncate.
MERCHANTSTATE
(Optional) The region code that corresponds to the state, province, or country
subdivision of the merchant location where the transaction took place.
Region code examples:
CA = California, USA
NS = Nova Scotia, Canada
COS = Colima Mexico
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the region code that corresponds to the state, province, or country
subdivision in which the seller is located.
Character length and limitations: 3 alphanumeric characters
MERCHANTZIP
(Optional) The 5- to 9-digit zip (postal) code excluding spaces, dashes, and nonnumeric characters where the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the postal code that corresponds to the seller’s location.
Character length and limitations: 15 alphanumeric characters
MERCHANTCOUNTRYCODE
(Optional) Country code of the location where the transaction took place.
Character length and limitations: 3 alphanumeric characters
MERCHANTLOCATIONID
(Optional)Merchant-assigned store or location number (or name) that uniquely
identifies where the transaction took place.
Character length and limitations: 15 alphanumeric characters
MERCHANTID
(Required) American Express-assigned service establishment number used to identify
and facilitate payments to merchants.
Character length and limitations: 15 alphanumeric characters.
MERCHANTCONTACTINFO
(Optional) Merchant’s telephone number or web address. (URLs and e-mail addresses
may be lowercase, as appropriate.) This entry may appear on the descriptive bill on
the card-member’s statement, or may be used to resolve billing inquiries and disputes.
N O TE :
American Express strongly recommends that aggregators (third-parties who
bill for goods or services rendered by another entity) always fill in this field
with the URL, e-mail address, or telephone number of the contact responsible
for resolving disputes or inquiries.
Character length and limitations: 40 alphanumeric characters
148
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
American Express Purchasing Card Transaction Processing
C
Transaction Advice Detail Parameters
Field
Description
ADDLAMTn
(Optional) Detail of a charge where n is a value from 1 - 5. Use for additional
breakdown of the amount.
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
ADDLAMTTYPEn
(Optional) A 3-digit code indicating the type of the corresponding charge detail,
where n is a value from 1 - 5.
Character length and limitations: 3 numeric characters
Example American Express Level 2 Transaction Parameter String
TRXTYPE=S&ACCT=372449635311003&AMT=20.06&BILLTOCITY=Mountain View&DESC1=des
c1&DESC2=desc2&DESC3=desc3&DESC4=FRT10.00&EXPDATE=1215&BILLTOFIRSTNAME=Card
holder first name&BILLTOLASTNAME=Cardholder last name&PARTNER=PayPal&PONUM=
12345&PWD=pwd&SHIPTOZIP=94045&BILLTOSTATE=CA&BILLTOSTREET=123 Main St.&TEND
ER=C&USER=user&BILLTOZIP=123451234
American Express Level 3 Parameters
American Express supports Level 3 transaction data. PayPal provides the Merchant
Registration data values: Supplier Name, Supplier City, Supplier State, Supplier Postal code,
Merchant No, and Federal Tax ID. The merchant provides the values listed in the the
following table.
American Express Level 3 Parameters
Field
Description
INVNUM
(Optional) Purchase order number.
Character length and limitations: 1 to 9 alphanumeric characters
AUTHCODE
(Required) Authorization code. It is passed transparently for delayed capture. Use
only with voice authorized force capture transactions.
REQNAME
(Required) Requester name.
Character length and limitations: 1 to 40 alphanumeric characters
PONUM
(Required) Cardmember reference number.
Character length and limitations: 1 to 17 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
149
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
American Express Purchasing Card Transaction Processing
Field
Description
SHIPTOZIP
(Required) Ship-to postal code (called zip code in the USA). This field must contain
one of the following values:
Zip code of the destination where the merchandise is to be shipped
(If the above is not available) Zip code of the location where the merchant
executed the transaction
Character length and limitations: 5 to 6 alphanumeric characters
INVOICEDATE
(Optional) Invoice date. Defaults to transaction date if not present.
Character length and limitations: 8 alphanumeric characters, in the YYYYMMDD format
AMT
(Required) Total transaction amount. The value must include a decimal and the exact
amount to the cent (42.00, not 42). Do not include comma separators (1234.56 not
1,234.56).
NOTE:
American Express Level 3 processing requires that this parameter have a
maximum field length of 8 for Level 3 processing. .
Character length and limitations: 1 to 8 alphanumeric characters
150
TAXAMT
(Required) Total tax amount. The value must include a decimal and the exact amount
to the cent (42.00, not 42). Do not include comma separators (1234.56 not
1,234.56).
Character length and limitations: 1 to 6 numeric characters
DESC
(Optional) Charge description. Defaults to “NO.”
Character length and limitations: 1 to 40 alphanumeric characters
FREIGHTAMT
(Optional) Total freight amount.
Character length and limitations: 1 to 15 alphanumeric characters
HANDLINGAMT
(Optional) Total handling amount.
Character length and limitations: 1 to 15 alphanumeric characters
L_QTYn
Payflow SDK:
XMLPay: Item.Quantity
(Required) Quantity invoiced.
Character length and limitations: 1 to 10 numeric characters
L_UOMn
(Required) Unit of measure.
Character length and limitations: 2 alphanumeric characters
L_COSTn
(Required) Unit price.
Character length and limitations: 1 to 15 numeric characters
L_DESCn
(Required) Description of the item.
Character length and limitations: 1 to 80 alphanumeric characters
L_CATALOGNUMn
(Required) Supplier’s catalog number.
Character length and limitations: 1 to 20 alphanumeric characters
L_COSTCENTERNUMn
(Required) Cost center number
Character length and limitations: 1 to 30 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
American Express Purchasing Card Transaction Processing
Field
Description
L_PRODCODEn
(Optional) The item’s supplier stock keeping unit (SKU) number.
Character length and limitations: 1 to 30 alphanumeric characters
L_UPCn
(Optional) The item’s universal product code (UPC).
Character length and limitations: 1 to 30 alphanumeric characters
L_TAXAMTn
(Optional) Item tax amount.
Character length and limitations: 1 to 6 numeric characters
L_FREIGHTAMTn
(Optional) Freight amount.
Character length and limitations: 1 to 15 numeric characters
L_HANDLINGAMTn
(Optional)Handling amount.
Character length and limitations: 1 to 15 numeric characters
L_TRACKINGNUMn
(Optional) Tracking number.
Character length and limitations: 1 to 30 alphanumeric characters
L_PICKUPSTREETn
(Optional) Drop-off address1.
Character length and limitations: 1 to 40 alphanumeric characters
L_PICKUPCITYn
(Optional) Drop-off city.
Character length and limitations: 2 to 30 alphanumeric characters
L_PICKUPSTATEn
(Optional) Drop-off state.
Character length and limitations: 2 alphanumeric characters
L_PICKUPZIPn
(Optional) Drop-off postal or zip code.
Character length and limitations: 3 to 15 alphanumeric characters
L_PICKUPCOUNTRYn
(Optional) Drop-off country.
Character length and limitations: 2 to 3 alphanumeric characters
L_UNSPSCCODEn
(Optional) UNSPSC code.
Character length and limitations: 1 to 30 alphanumeric characters
C
Example American Express Level 3 Transaction Parameter String
TRXTYPE=S&TENDER=C&partner=partner&PWD=test&USER=test&ACCT=378734493671000&
EXPDATE=1213&AMT=5.00&COMMENT1=PCARD Test&COMMENT2=Testing&BILLTOZIP=940151
234&BILLTOSTREET=123 Lincoln WAY&CVV2=0123&SHIPTOCOUNTRY=USA&CUSTCODE=12345
&FREIGHTAMT=1.00&ORDERDATE=021700&HANDLINGAMT=1.00&PONUM=123456789012345678
9012345&SHIPFROMZIP=940151234&SHIPTOZIP=940151234&TAXAMT=1.00&TAXEXEMPT=N&L
_UPC1=PN&L_QTY1=1&L_DESC1=Test123&L_UOM1=12&L_COST1=1.00&L_PRODCODE1=123&L_
COSTCENTERNUM1=55&L_TAXAMT1=0&L_QTY2=1&L_UPC1=PN&L_DESC2=Test&L_UOM2=12&L_C
OST2=1.00&L_PRODCODE2=1234&L_COSTCENTERNUM2=55&L_TAXAMT2=1.00&REQNAME=Rober
t&SHIPTOZIP=543210&INVNUM=123456789&VERBOSITY=HIGH
Gateway Developer Guide and Reference
31 July 2012
151
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Elavon (Formerly Nova) Purchasing Card Transaction Processing
Elavon (Formerly Nova) Purchasing Card Transaction
Processing
Elavon supports Level 2 for Visa and MasterCard sale, credit, and delayed capture
transactions.
Elavon Level 2 Parameters
To get the discount rate, include both Level 2 parameters listed in the following table. Pass
these parameters in authorization and sale transactions.
Level 2 Parameters
Description
CUSTCODE
(Required) Customer code.
Character length and limitations: 1 to 16 alphanumeric characters
TAXAMT
(Required) Sales tax.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
Elavon Additional Parameters
The following parameters are recommended to obtain the best rates for purchasing card
transactions with Elavon:
Field
Description
COMMCARD
(Optional) Type of purchasing card account number sent. Is one of the following
values:
P = Purchase Card
C = Corporate Card
B = Business Card
U = Unknown (default)
N = None
Character length and limitations: 1 alphanumeric character, defaults to U
152
PONUM
(Optional) Purchase order number.
Character length and limitations: 25 alphanumeric characters, when used provides
best rate
TAXAMT
(Optional)Tax amount. The value must include a decimal and the exact amount to the
cent (42.00, not 42). Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters, when used provides best
rate
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
First Data Merchant Services (FDMS) Nashville Purchasing Card Transaction Processing
C
Example Elavon Level 2 Transaction Parameter String
TRXTYPE=S&ACCT=5105105105105100&AMT=20.10&BILLTOCITY=Mountain View&COMMENT1
=L2 Testing&EXPDATE=1215&BILLTOFIRSTNAME=Cardholder First Name&BILLTOLASTNA
ME=Cardholder Last Name&PARTNER=PayPal&PWD=pwd&BILLTOSTATE=CA&BILLTOSTREET=
123 Main St.&TENDER=C&USER=user&BILLTOZIP=94043&CUSTCODE=123456&TAXAMT=1.34
First Data Merchant Services (FDMS) Nashville Purchasing Card
Transaction Processing
NOT E :
FDMS Nashville supports Level 2 transaction processing only.
The following parameters are recommended to obtain the best rates for purchasing card
transactions with FDMS Nashville.
FDMS Nashville Commercial Card Parameters
Field
Description
COMMCARD
(Optional) Type of purchasing card account number sent. Is one of the following
values:
P = Purchase Card
C = Corporate Card
B = Business Card
U = Unknown (default)
N = None
Character length and limitations: 1 alphanumeric character, defaults to U
DUTYAMT
(Optional) Sometimes called import tax. The value must include a decimal and the
exact amount to the cent (42.00, not 42). Do not include comma separators
(1234.56 not 1,234.56).
Character length and limitations: 10 currency characters
FREIGHTAMT
(Optional) Freight amount. The value must include a decimal and the exact amount to
the cent (42.00, not 42). Do not include comma separators (1234.56 not
1,234.56).
Character length and limitations: 10 currency characters
PONUM
(Optional) Purchase order number.
Character length and limitations: 25 alphanumeric characters, provides best rate when
used
SHIPTOZIP
(Optional)Ship to postal code (called zip code in the USA).
Character length and limitations: 9 numeric characters, provides best rate when used
Gateway Developer Guide and Reference
31 July 2012
153
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
First Data Merchant Services (FDMS) North Purchasing Card Transaction Processing
Field
Description
TAXAMT
(Optional)Tax amount. The value must include a decimal and the exact amount to the
cent (42.00, not 42). Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters, provides best rate when
used
TAXEXEMPT
(Optional) Is the customer tax exempt?
Character length and limitations: 1 alphanumeric character, Y or N
First Data Merchant Services (FDMS) North Purchasing Card
Transaction Processing
The following parameters are recommended to obtain the best rates for Level 2 and Level 3
purchasing card transactions with FDMS North.
FDMS North Purchasing Parameters
154
Field
Description
SHIPTOCOUNTRY
(Optional) Destination country code. Visa and MasterCard are different.
Character length and limitations: 3 alpha characters
DISCOUNT
(Optional) Discount amount on total sale
Character length and limitations: 10 currency characters
DUTYAMT
(Optional) Sometimes called import tax. If the currency uses a decimal, then the
value must include a decimal and the exact amount to the cent (42.00, not 42). Do
not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters
FREIGHTAMT
Character length and limitations: 10 currency characters
PONUM
(Optional) Purchase order number / merchant-related data.
Character length and limitations: 25 alphanumeric characters, provides best rate when
used
SHIPFROMZIP
(Optional) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 9 numeric characters, provides best rate when used
SHIPTOZIP
(Optional) Ship to postal code (called zip code in the USA).
Character length and limitations: 9 numeric characters, provides best rate when used
TAXAMT
(Optional) Tax amount. The value must include a decimal and the exact amount to the
cent (42.00, not 42). Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
First Data Merchant Services South (FDMS) Purchasing Card Transaction Processing
C
FDMS North Purchasing Card Line Item Parameters
Line item data (Level 3) describes the details of the item purchased and can be passed for each
transaction. The convention for passing line item data in name-value pairs is that each namevalue starts with L_ and ends with n where n is the line item number. For example L_QTY0=1
is the quantity for line item 0 and is equal to 1, with n starting at 0. In addition, the
SHIPFROMZIP parameter is required for Level 3 transactions.
FDMS North Line Item Parameters
Field
Description
L_QTYn
(Required) Quantity (whole units only).
Character length and limitations: 10 numeric characters
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12alphanumeric characters
L_DESCn
(Optional) Item description.
Character length and limitations: 35 alphanumeric characters
L_UOMn
(Optional) Item unit of measure.
Character length and limitations: 3 alpha characters
L_COSTn
(Optional) Cost per item, excluding tax.
Character length and limitations: 10 currency characters
L_UPCn
(Optional) Supplier specific product code.
Character length and limitations: 12 alphanumeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 10 currency characters
L_AMTn
(Optional) Total line item amount including tax and discount. + for debit, - for credits.
Character length and limitations: 10 currency characters
L_TAXAMTn
(Optional) Line item tax amount.
Character length and limitations: 10 currency characters
First Data Merchant Services South (FDMS) Purchasing Card
Transaction Processing
The following parameters are recommended to obtain the best rates for Level 2 and Level 3
purchasing card transactions with FDMS South.
Gateway Developer Guide and Reference
31 July 2012
155
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
First Data Merchant Services South (FDMS) Purchasing Card Transaction Processing
FDMS South Level 2 and Level 3 Purchasing Card Parameters
156
Field
Description
BILLTOCITY
(Optional) Cardholder’s city.
Character length and limitations: 13 alpha characters
SHIPTOCOUNTRY
(Optional) Destination Country Code. Visa and MasterCard are different. Refer to
Country Code tables.
Character length and limitations: 3 alpha characters
CUSTCODE
(Optional) Customer code/customer reference ID.
Character length and limitations: 17 alphanumeric characters
DISCOUNT
Discount amount on total sale.
Character length and limitations: 10 currency characters
DUTYAMT
(Optional) Sometimes called import tax. If the currency uses a decimal, then the
value must include a decimal and the exact amount to the cent(42.00, not 42). Do
not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters
BILLTOFIRSTNAME
(Optional) Cardholder’s first name.
Character length and limitations: 15 alpha characters
FREIGHTAMT
(Optional) Freight amount. If the currency uses a decimal, then the value must
include a decimal and the exact amount to the cent (42.00, not 42). Do not include
comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters
INVNUM
(Optional) Merchant invoice number. This reference number (PNREF—generated by
PayPal) is used for authorizations and settlements.
The acquirer decides if this information will appear on the merchant’s bank
reconciliation statement.
Character length and limitations: 9 alphanumeric characters
BILLTOLASTNAME
(Optional) Cardholder’s last name.
Character length and limitations: 15 alpha characters
ORDERDATE
(Optional) Order date. Format is mmddyy with no slashes or dashes. For example,
July 28, 2003 is 072803.
Character length and limitations: 6 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
First Data Merchant Services South (FDMS) Purchasing Card Transaction Processing
Field
Description
ORDERTIME
(Optional) Order time and date. Format is either YYYY-MM-DD or YYYY-MM-DD
HH:MI:SS (where HH is in 24-hour time).
If the value does not conform to one of the formats or if the date is not valid (for
example, 2004-17-35), then the transaction is rejected with a RESULT=7
(SIG_FIELD_ERR) and RESPMSG=Invalid ORDERTIME.
A truncated version of the ORDERTIME value (up to 7 characters) overwrites any
value provided by ORDERDATE.
If no value is provided, a NULL value is stored.
Character length and limitations: 19 alphanumeric characters
PONUM
(Optional) Purchase order number / merchant-related data.
Character length and limitations: 25 alphanumeric characters, provides best rate when
used
SHIPFROMZIP
(Optional) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 9 numeric characters, provides best rate when used
SHIPTOZIP
(Optional) Ship to postal code (called zip code in the USA).
Character length and limitations: 9 numeric characters, provides best rate when used
BILLTOSTATE
(Optional) Cardholder’s state.
Character length and limitations: 2 alpha characters
TAXAMT
(Optional) Tax amount. The value must include a decimal and the exact amount to the
cent (42.00, not 42). Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters, provides best rate when
used
TAXEXEMPT
(Optional) Is the customer tax exempt?
Character length and limitations: 1 alphanumeric character, Y or N
C
FDMS South Line Item Parameters
Line item data (Level 3) describes the details of the item purchased and can be can be passed
for each transaction. The convention for passing line item data in name-value pairs is that each
name-value starts with L_ and ends with n where n is the line item number. For example
L_QTY0=1 is the quantity for line item 0 and is equal to 1, with n starting at 0.
FDMS South Purchasing Card Line Item Parameters
Field
Description
L_QTYn
(Required) Quantity (whole units only).
Character length and limitations: 10 numeric characters
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
157
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
First Data Merchant Services South (FDMS) Purchasing Card Transaction Processing
Field
Description
L_DESCn
(Optional) Item description.
Character length and limitations: 35 alphanumeric characters
L_UOMn
(Optional) Item unit of measure.
Character length and limitations: 3 alpha characters
L_COSTn
(Optional) Cost per item, excluding tax.
Character length and limitations: 10 currency characters
L_PRODCODEn
(Optional) Supplier-specific product code.
Character length and limitations: 12 alphanumeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 10 currency characters
L_AMTn
(Required) Total line item amount including tax and discount. + for debit, - for
credits.
Character length and limitations: 10 currency characters
L_TAXAMTn
(Optional) Line item tax amount.
Character length and limitations: 10 currency characters
Example FDMS South Purchasing Card Level 2 and 3 Parameter String
TRXTYPE=S&TENDER=C&PARTNER=PayPal&VENDOR=SuperMerchant&USER=SuperMerchant&P
WD=x1y2z3&BILLTOSTATE=CA&BILLTOFIRSTNAME=John&BILLTOLASTNAME=Smith&BILLTOCI
TY=Redwood&SHIPTOCOUNTRY=USA&CUSTCODE=12345&DISCOUNT=.25&DUTYAMT=34.00&FREI
GHTAMT=12.00&INVNUM=123456789&ORDERDATE=021700&PONUM=1234567890123456789012
345&SHIPFROMZIP=940151234&SHIPTOZIP=94065&TAXAMT=1.00&TAXEXEMPT=Y
Example FDMS South Line Item Parameter String
TRXTYPE=S&TENDER=C&PARTNER=PayPal&VENDOR=SuperMerchant&USER=SuperMerchant&P
WD=x1y2z3&BILLTOSTATE=CA&BILLTOFIRSTNAME=John&BILLTOLASTNAME=Smith&BILLTOCI
TY=Redwood&SHIPTOCOUNTRY=USA&CUSTCODE=12345&DISCOUNT=.25&DUTYAMT=34.00&FREI
GHTAMT=12.00&INVNUM=123456789&ORDERDATE=021700&PONUM=1234567890123456789012
345&SHIPFROMZIP=940151234&SHIPTOZIP=94065&TAXAMT=1.00&TAXEXEMPT=Y&L_QTY1=1&
L_UPC1=PN&L_DESC1=Test&L_UOM1=INQ&L_COST1=1.00&L_PRODCODE1=12345&L_DISCOUNT
1=.25&&L_AMT1=.75&L_TAXAMT1=0
158
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Global Payments - Central Purchasing Card Transaction Processing
C
Global Payments - Central Purchasing Card Transaction
Processing
Global Payments - Central (MAPP) supports Level 2 parameters for MasterCard, and Visa
sale, credit, and delayed capture transactions.
Global Payments - Central Level 2 Parameters
Pass the following Level 2 parameters to get the discount rate.
Global Payments - Central Level 2 parameters
Level 2 Parameters
Description
CUSTCODE
(Required) Customer code.
Character length and limitations: 1 to 16 alphanumeric characters
TAXAMT
(Required) Sales tax.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
Example Global Payments - Central Level 2 Visa or MasterCard Transaction
Parameter String
TRXTYPE=S&ACCT=5105105105105100&AMT=20.10&BILLTOCITY=Mountain View&COMMENT1
=L2 Testing&EXPDATE=1209&BILLTOFIRSTNAME=Cardholder First Name&BILLTOLASTNA
ME=Cardholder Last Name&PARTNER=PayPal&PWD=pwd&BILLTOSTATE=CA&BILLTOSTREET=
123 Main St.&TENDER=C&USER=user&BILLTOZIP=94043&CUSTCODE=123456&TAXAMT=1.34
Global Payments - East Purchasing Card Transaction
Processing
Global Payments - East (NDCE) supports Level 2 parameters for American Express,
MasterCard, and Visa.
Global Payments - East Level 2 Parameters
Pass the following Level 2 parameters in authorization and sale transactions to get the discount
rate.
Gateway Developer Guide and Reference
31 July 2012
159
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Heartland Purchasing Card Transaction Processing
Level 2 Parameters
Description
CUSTCODE
(Required) Customer code.
Character length and limitations: 1 to 16 alphanumeric characters
TAXAMT
(Required) Sales tax.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
Example Global Payments - East Level 2 Visa or MasterCard Transaction
Parameter String
TRXTYPE=S&ACCT=5105105105105100&AMT=20.10&BILLTOCITY=Mountain View&COMMENT1
=L2 Testing&EXPDATE=1215&BILLTOFIRSTNAME=Cardholder FirstName&BILLTOLASTNAM
E=Cardholder LastName&PARTNER=PayPal&PWD=pwd&BILLTOSTATE=CA&BILLTOSTREET=12
3 Main St.&TENDER=C&USER=user&BILLTOZIP=94043&CUSTCODE=123456&TAXAMT=1.34
Global Payments - Central (MAPP) supports Level 2 for MasterCard, and Visa Sale, Credit,
and Delayed Capture transactions.
Heartland Purchasing Card Transaction Processing
Heartland Level 2 Parameters
Heartland supports MasterCard and Visa for Level 2 processing.
Heartland indicates in the authorization response whether the credit card in the transaction is a
commercial card. Based on the commercial card indicator, Payflow will format the Level 2
information in the settlement request.
Heartland Level 2 Transaction Data
To get the discount rate, pass the Level 2 values marked Required in the following table.
160
Parameter
Description
PONUM
(Required) Customer reference ID.
Character length and limitations: 1 to 16 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Heartland Purchasing Card Transaction Processing
Parameter
Description
TAXAMT
(Required) Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
TAXEXEMPT
(Optional) Tax amount identifier.
Character length and limitations: 1 alpha character, Y or N
C
Example Heartland Level 2 Visa Transaction Parameter String
TRXTYPE=S&ACCT=4111111111111111&AMT=20.02&BILLTOCITY=Mountain View&COMMENT1
=L2 Testing&EXPDATE=1215&INVNUM=661254585&BILLTOFIRSTNAME=CardHolder Name&P
ARTNER=PayPal&PWD=pwd&BILLTOSTATE=CA&BILLTOSTREET=123 Main St.&TAXAMT=1.01&
TAXEXEMPT=N&TENDER=C&USER=user&BILLTOZIP=94043
Heartland Level 3 MasterCard Parameters
To qualify for Level 3, the authorization response for the transaction must have the
commercial card indicator set and one or more line items should be present in the delayed
capture or sale request.
Level 2 transaction parameters marked as Required are required for Level 3 transactions.
Level 3 transactions that do not include the required Level 2 values are rejected.
IM PORT AN T :
The values required for Level 3 status vary by bank, so contact your bank for
details.
Heartland Level 2 MasterCard Parameters Required for Level 3 Transactions
Parameter
Description
PONUM
(Required) Purchase identifier.
Character length and limitations: 25 alphanumeric characters
TAXAMT
(Required) Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
LOCALTAXAMT
(Optional) Local tax.
Character length and limitations: 12 numeric characters
TAXEXEMPT
(Optional) Local tax incl flag.
Character length and limitations: 1 alphanumeric, Y or N
Gateway Developer Guide and Reference
31 July 2012
161
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Heartland Purchasing Card Transaction Processing
Parameter
Description
NATIONALTAXAMT
(Optional) National tax amount. You may omit this parameter if there is no such tax.
Character length and limitations: 12 numeric characters
INVNUM
(Required) Purchase Order number or customer reference ID. The PNREF value is
sent if no value is provided.
Character length and limitations: 9 alphanumeric characters
Heartland Level 3 MasterCard Extended Data
The parameters listed in the table below apply to Level 3 MasterCard transactions as extended
data.
Parameter
Description
FREIGHTAMT
(Optional) Freight amount.
Character length and limitations: 12 numeric characters
DUTYAMT
(Optional) Duty amount.
Character length and limitations: 12 numeric characters
SHIPTOZIP
(Required) The zip code of the address to which the goods are shipped.
Character length and limitations: 10 alphanumeric characters
SHIPFROMZIP
(Required) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 10 alphanumeric characters
SHIPTOCOUNTRY
(Optional) Destination country code.
Character length and limitations: 3 alphanumeric characters
ALTTAXAMT
(Optional) Alternate tax amount.
Character length and limitations: 9 numeric characters
Heartland Level 3 MasterCard Line Item Detail Records
NOT E :
162
For these values, n is a sequence counter that should begin with 1 and increase in
sequence. Each line item should also contain quantity (L_QTYn) and unit price
(L_COSTn) fields.
Parameter
Description
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12 alphanumeric characters
L_DESCn
(Required) Item descriptor.
Character length and limitations: 35 alphanumeric characters
L_UPCn
(Optional) Product code.
Character length and limitations: 12 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Heartland Purchasing Card Transaction Processing
Parameter
Description
L_QTYn
(Required) Quantity.
Character length and limitations: 12 numeric characters
L_UOMn
(Required) Unit of measure code.
Character length and limitations: 12 alphanumeric characters
L_COSTn
(Required) Unit cost.
Character length and limitations: 12 numeric characters
L_TAXAMTn
(Optional) VAT/tax amount.
Character length and limitations: 12 numeric characters
L_TAXRATEn
(Optional) VAT/tax rate.
Character length and limitations: 4 numeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 12 numeric characters
L_AMTn
(Optional) Line-item total.
Character length and limitations: 12 numeric characters
C
Example Heartland Level 3 MasterCard Transaction Parameter String.
TRXTYPE=S&TENDER=C&PARTNER=Partner&USER=User&PWD=Password&ACCT=552500000000
0005&EXPDATE=1215&AMT=1.00&BILLTOSTREET=5199 JOHNSON&BILLTOZIP=94588&ALTTAX
AMT=1.00&CUSTVATREGNUM=11111&LOCALTAXAMT=1.00&NATIONALTAXAMT=1.00&COMMCODE=
22222&VATAXAMT=1.00&VATAXPERCENT=10&TAXEXEMPT=Y&DISCOUNT=1.00&FREIGHTAMT=1.
00&DUTYAMT=1.00&SHIPTOZIP=33333&SHIPFROMZIP=44444&SHIPTOCOUNTRY=840&ORDERDA
TE=020725&L_COMMCODE1=123456789ABC&L_DESC1=Line item 1 description&L_UPC1=C
BA987654321&L_QTY1=1&L_UOM1=123456789012&L_COST1=1.00&L_TAXAMT1=1.00&L_TAXR
ATE1=1.00&L_DISCOUNT1=1.00&L_AMT1=1.00&L_TAXTYPE1=TT3
Heartland Level 3 Visa Parameters
To qualify for Level 3 transactions, the authorization response for the transaction must have
the commercial card indicator set and one or more line items should be present in the delayed
capture or sale request.
Level 2 transaction parameters marked as Required are required for Level 3 transactions.
Level 3 transactions that do not include the required Level 2 values are rejected.
IM PORT AN T :
The values required for Level 3 status vary by bank, so contact your bank for
details.
Heartland Level 2 Visa Parameters Required for Level 3 Transactions
Parameter
Description
PONUM
(Required) Purchase identifier. TheTransaction ID is sent if no value is provided.
Character length and limitations: 25 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
163
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Heartland Purchasing Card Transaction Processing
Parameter
Description
TAXAMT
(Required) Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: numeric
LOCALTAXAMT
(Optional) Local tax amount.
Character length and limitations: 12 numeric characters
TAXEXEMPT
(Optional) Local tax incl flag.
Character length and limitations: 1 alphanumeric, Y or N
NATIONALTAXAMT
(Optional) National tax amount.
Character length and limitations: 12 numeric characters
INVNUM
(Required) Purchase order number/customer reference ID. The Transaction ID is
sent if no value is provided.
Character length and limitations: 9 alphanumeric characters
Heartland Level 3 Visa Extended Data
The parameters listed in the table below apply to Level 3 MasterCard transactions as extended
data.
164
Parameter
Description
COMMCODE
(Optional) Summary commodity code identifier for the business.
Character length and limitations: 4 alphanumeric characters
DISCOUNT
(Optional) Discount amount.
Character length and limitations: 12 numeric characters
FREIGHTAMT
(Optional) Freight amount.
Character length and limitations: 12 numeric characters
DUTYAMT
(Optional)Duty amount.
Character length and limitations: 12 numeric characters
ORDERDATE
(Required) Order date. Format is mmddyy with no slashes or dashes. For example,
July 28, 2003 is 072803.
Character length and limitations: 6 numeric characters
SHIPTOZIP
(Required) The zip code of the address to which the goods are shipped.
Character length and limitations: 10 alphanumeric characters
SHIPFROMZIP
(Required) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 10 alphanumeric characters
SHIPTOCOUNTRY
(Optional) Destination country code.
Character length and limitations: 3 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Heartland Purchasing Card Transaction Processing
Parameter
Description
VATREGNUM
(Required) VAT registration number. Can be part of the registration data or passed
with each transaction.
Character length and limitations: 20 alphanumeric characters
FREIGHTAMT
(Required) Unique VAT inventory reference number. Can be part of the registration
data or passed with each transaction.
Character length and limitations: 9 alphanumeric characters
CUSTVATREGNUM
(Required) Customer VAT registration number.
Character length and limitations: 13 alphanumeric characters
VATTAXAMT
(Optional) VAT/tax amount (freight/shipping).
Character length and limitations: 12 numeric characters
VATTAXPERCENT
(Optional) VAT/tax rate (freight/shipping).
Character length and limitations: 4 numeric characters
C
Heartland Level 3 Visa Line Item Detail Records
Parameter
Description
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12 alphanumeric characters
L_DESCn
(Required) Item descriptor.
Character length and limitations: 35 alphanumeric characters
L_UPCn
(Optional) Product code.
Character length and limitations: 12 alphanumeric characters
L_QTYn
(Required) Quantity.
Character length and limitations: 12 numeric characters
L_UOMn
(Required) Unit of measure code.
Character length and limitations: 12 alphanumeric characters
L_COSTn
(Required) Unit cost.
Character length and limitations: 12 numeric characters
L_TAXAMTn
(Optional) VAT/tax amount.
Character length and limitations: 12 numeric characters
L_TAXRATEn
(Optional) VAT/tax rate.
Character length and limitations: 4 numeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 12 numeric characters
L_AMTn
(Optional) Line-item total.
Character length and limitations: 12 numeric characters
Gateway Developer Guide and Reference
31 July 2012
165
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Litle Purchasing Card Transaction Processing
Example Heartland Level 3 Visa Transaction Parameter String
TRXTYPE=S&TENDER=C&PARTNER=Partner&USER=User&PWD=Password&ACCT=411111111111
1111&EXPDATE=1215&AMT=1.00&BILLTOSTREET=5199 JOHNSON&TAXAMT=1.06&BILLTOZIP=
94588&ALTTAXAMT=1.00&CUSTVATREGNUM=11111&LOCALTAXAMT=1.01&NATIONALTAXAMT=1.
02&COMMCODE=22222&VATAXAMT=1.03&VATAXPERCENT=55&TAXEXEMPT=N&DISCOUNT=.50&FR
EIGHTAMT=1.00&DUTYAMT=1.00&SHIPTOZIP=33333&SHIPFROMZIP=44444&SHIPTOCOUNTRY=
840&ORDERDATE=020725&L_COMMCODE1=123456789ABC&L_DESC1=Line item 1 descripti
on&L_UPC1=CBA987654321&L_QTY1=1&L_UOM1=123456789012&L_COST1=1.50&L_TAXAMT1=
1.05&L_TAXRATE1=12&L_DISCOUNT1=.50&L_AMT1=1.00&L_TAXTYPE1=TT1
Litle Purchasing Card Transaction Processing
Litle Level 2 Parameters
The Litle platform supports Level 2 transaction data.
Litle Level 2 Parameters
166
Field
Description
CUSTREF
(Optional) Reference, such as a purchase order number, used by the customer for the
purchase.
Character length and limitations: 17 alphanumeric characters
DISCOUNT
(Optional) Discount amount for the order.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
DUTYAMT
(Optional) Duty amount on the total purchased for the order.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
FREIGHTAMT
(Optional) Shipping amount for the order.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
TAXAMT
(Optional) Tax amount included in the amount of the transaction.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
L_AMTn
(Optional) Amount of this line-item including tax, where n is a line-item number
from 1 to 99. L_AMTn - L_TAXAMTn = line-item total.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Litle Purchasing Card Transaction Processing
Field
Description
L_COMMCODEn
(Optional) Identifier assigned by the card acceptor that categorizes the purchased
item, where n is a line-item number from 1 to 99.
Character length and limitations: 12 alphanumeric characters
L_COSTn
(Required if L_QTYn is supplied) Price of one unit of the item purchased, where n is a
line-item number from 1 to 99.
Character length and limitations: 12 numeric characters
L_DESCn
(Required) Description of this line-item, where n is a line-item number from 1 to 99.
Character length and limitations: 26 alphanumeric characters
L_DISCOUNTn
(Optional) Discount per line item, where n is a line-item number from 1 to 99.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
L_PRODCODEn
(Optional) Supplier-specific product code of the purchased item, where n is a lineitem number from 1 to 99.
Character length and limitations: 12 numeric characters
L_QTYn
(Optional) Number of items purchased, where n is a line-item number from 1 to 99.
Character length and limitations: 12 numeric characters
L_TAXAMTn
(Optional) Line item tax amount, where n is a line-item number from 1 to 99.
L_AMTn - L_TAXAMTn = line-item total.
Characteristic length and limitations: The decimal is implied. If, for example, you
specify 500, this value is equivalent to $5.00. 8 numeric characters
L_UOMn
(Optional) Unit of measure of the purchased item (such as kit, pair, gallon or month),
where n is a line-item number from 1 to 99.
Character length and limitations: 12 alphanumeric characters
C
Litle Level 3 Parameters
The Litle platform supports Level 3 transaction data.
Litle Level 3 Parameters
Field
Description
CUSTREF
(Optional) Reference, such as a purchase order number, used by the customer for the
purchase.
Character length and limitations: 17 alphanumeric characters
DISCOUNT
(Optional) Discount amount for the order.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
DUTYAMT
(Optional) Duty amount on the total purchased for the order.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
Gateway Developer Guide and Reference
31 July 2012
167
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Merchant e-Solutions Purchasing Card Transaction Processing
Field
Description
FREIGHTAMT
(Optional) Shipping amount for the order.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
TAXAMT
(Optional) Tax amount included in the amount of the transaction.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
L_AMTn
(Optional) Amount of this line-item including tax, where n is a line-item number
from 1 to 99. L_AMTn - L_TAXAMTn = line-item total.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
L_COMMCODEn
(Optional) Identifier assigned by the card acceptor that categorizes the purchased
item, where n is a line-item number from 1 to 99.
Character length and limitations: 12 alphanumeric characters
L_COSTn
(Required if L_QTYn is supplied) Price of one unit of the item purchased, where n is a
line-item number from 1 to 99.
Character length and limitations: 12 numeric characters
L_DESCn
(Required) Description of this line-item, where n is a line-item number from 1 to 99.
Character length and limitations: 26 alphanumeric characters
L_DISCOUNTn
(Optional) Discount per line item, where n is a line-item number from 1 to 99.
Character length and limitations: The decimal is implied. If, for example, you specify
500, this value is equivalent to $5.00. 8 numeric characters
L_PRODCODEn
(Optional) Supplier-specific product code of the purchased item, where n is a lineitem number from 1 to 99.
Character length and limitations: 12 numeric characters
L_QTYn
(Optional) Number of items purchased, where n is a line-item number from 1 to 99.
Character length and limitations: 12 numeric characters
L_TAXAMTn
(Optional) Line item tax amount, where n is a line-item number from 1 to 99.
L_AMTn - L_TAXAMTn = line-item total.
Characteristic length and limitations: The decimal is implied. If, for example, you
specify 500, this value is equivalent to $5.00. 8 numeric characters
L_UOMn
(Optional) Unit of measure of the purchased item (such as kit, pair, gallon or month),
where n is a line-item number from 1 to 99.
Character length and limitations: 12 alphanumeric characters
Merchant e-Solutions Purchasing Card Transaction Processing
168
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Merchant e-Solutions Purchasing Card Transaction Processing
C
Merchant e-Solutions Level 2 Parameters
Merchant e-Solutions supports MasterCard and Visa for Level 2 processing.
Merchant e-Solutions indicates in the authorization response whether the credit card in the
transaction is a commercial card. Based on the commercial card indicator, Payflow will format
the Level 2 information in the settlement request.
Merchant e-Solutions Level 2 Transaction Data
To get the discount rate, Level 2 values marked as Required in the following table must be
present.
Parameter
Description
PONUM
(Required) Customer reference ID.
Character length and limitations: 1 to 16 alphanumeric characters
TAXAMT
(Required) Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
TAXEXEMPT
(Optional) Tax amount identifier.
Character length and limitations: 1 alpha character, Y or N
Example Merchant e-Solutions Level 2 Visa Transaction Parameter String
TRXTYPE=S&ACCT=4111111111111111&AMT=20.02&BILLTOCITY=Mountain View&COMMENT1
=L2 Testing&EXPDATE=1215&INVNUM=661254585&BILLTOFIRSTNAME=CardHolder Name&P
ARTNER=PayPal&PWD=pwd&BILLTOSTATE=CA&BILLTOSTREET=123 Main St.&TAXAMT=1.01&
TAXEXEMPT=N&TENDER=C&USER=user&BILLTOZIP=94043
Merchant e-Solutions Level 3 MasterCard Parameters
To qualify for Level 3, the authorization response for the transaction must have the
commercial card indicator set and one or more line items should be present in the delayed
capture or sale request.
Level 2 transaction parameters marked as Required are required for Level 3 transactions.
Level 3 transactions that do not include the required Level 2 values are rejected.
IM PORT AN T :
The values required for Level 3 status vary by bank, so contact your bank for
details.
Gateway Developer Guide and Reference
31 July 2012
169
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Merchant e-Solutions Purchasing Card Transaction Processing
Merchant e-Solutions Level 2 MasterCard Parameters Required for Level 3
Transactions
Parameter
Description
PONUM
(Required) Purchase identifier.
Character length and limitations: 25 alphanumeric characters
TAXAMT
(Required) Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
LOCALTAXAMT
(Optional) Local tax.
Character length and limitations: 12 numeric characters
TAXEXEMPT
(Optional) Local tax incl flag.
Character length and limitations: 1 alphanumeric, Y or N
NATIONALTAXAMT
(Optional) National tax amount. You may omit this parameter if there is no such tax.
Character length and limitations: 12 numeric characters
INVNUM
(Required) Purchase Order number or customer reference ID. The PNREF value is
sent if no value is provided.
Character length and limitations: 9 alphanumeric characters
Merchant e-Solutions Level 3 MasterCard Extended Data
The parameters listed in the table below apply to Level 3 MasterCard transactions as extended
data.
170
Parameter
Description
FREIGHTAMT
(Optional) Freight amount.
Character length and limitations: 12 numeric characters
DUTYAMT
(Optional) Duty amount.
Character length and limitations: 12 numeric characters
SHIPTOZIP
(Required) The zip code of the address to which the goods are shipped.
Character length and limitations: 10 alphanumeric characters
SHIPFROMZIP
(Required) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 10 alphanumeric characters
SHIPTOCOUNTRY
(Optional) Destination country code.
Character length and limitations: 3 alphanumeric characters
ALTTAXAMT
(Optional) Alternate tax amount.
Character length and limitations: 9 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Merchant e-Solutions Purchasing Card Transaction Processing
C
Merchant e-Solutions Level 3 MasterCard Line Item Detail Records
NOT E :
For the following values, n is a sequence counter that should begin with 1 and increase
in sequence. With each line item, include the quantity (L_QTYn) and unit price
(L_COSTn) fields.
Parameter
Description
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12 alphanumeric characters
L_DESCn
(Required) Item descriptor.
Character length and limitations: 35 alphanumeric characters
L_UPCn
(Optional) Product code.
Character length and limitations: 12 alphanumeric characters
L_QTYn
(Required) Quantity.
Character length and limitations: 12 numeric characters
L_UOMn
(Required) Unit of measure code.
Character length and limitations: 12 alphanumeric characters
L_COSTn
(Required) Unit cost.
Character length and limitations: 12 numeric characters
L_TAXAMTn
(Optional) VAT/tax amount.
Character length and limitations: 12 numeric characters
L_TAXRATEn
(Optional) VAT/tax rate.
Character length and limitations: 4 numeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 12 numeric characters
L_AMTn
(Optional) Line-item total.
Character length and limitations: 12 numeric characters
Example Merchant e-Solutions Level 3 MasterCard Transaction Parameter String.
TRXTYPE=S&TENDER=C&PARTNER=Partner&USER=User&PWD=Password&ACCT=552500000000
0005&EXPDATE=1215&AMT=1.00&BILLTOSTREET=5199 JOHNSON&BILLTOZIP=94588&ALTTAX
AMT=1.00&CUSTVATREGNUM=11111&LOCALTAXAMT=1.00&NATIONALTAXAMT=1.00&COMMCODE=
22222&VATAXAMT=1.00&VATAXPERCENT=10&TAXEXEMPT=Y&DISCOUNT=1.00&FREIGHTAMT=1.
00&DUTYAMT=1.00&SHIPTOZIP=33333&SHIPFROMZIP=44444&SHIPTOCOUNTRY=840&ORDERDA
TE=020725&L_COMMCODE1=123456789ABC&L_DESC1=Line item 1 description&L_UPC1=C
BA987654321&L_QTY1=1&L_UOM1=123456789012&L_COST1=1.00&L_TAXAMT1=1.00&L_TAXR
ATE1=1.00&L_DISCOUNT1=1.00&L_AMT1=1.00&L_TAXTYPE1=TT3
Gateway Developer Guide and Reference
31 July 2012
171
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Merchant e-Solutions Purchasing Card Transaction Processing
Merchant e-Solutions Level 3 Visa Parameters
To qualify for Level 3 transactions, the authorization response for the transaction must have
the commercial card indicator set and one or more line items should be present in the delayed
capture or sale request.
Level 2 transaction parameters marked as Required are required for Level 3 transactions.
Level 3 transactions that do not include the required Level 2 values are rejected.
IM PORT AN T :
The values required for Level 3 status vary by bank, so contact your bank for
details.
Merchant e-Solutions Level 2 Visa Parameters Required for Level 3
Transactions
Parameter
Description
PONUM
(Required) Purchase identifier. TheTransaction ID is sent if no value is provided.
Character length and limitations: 25 alphanumeric characters
TAXAMT
(Required) Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: numeric
LOCALTAXAMT
(Optional) Local tax amount.
Character length and limitations: 12 numeric characters
TAXEXEMPT
(Optional) Local tax incl flag.
Character length and limitations: 1 alphanumeric, Y or N
NATIONALTAXAMT
(Optional) National tax amount.
Character length and limitations: 12 numeric characters
INVNUM
(Required) Purchase order number/customer reference ID. The Transaction ID is
sent if no value is provided.
Character length and limitations: 9 alphanumeric characters
Merchant e-Solutions Level 3 Visa Extended Data
The parameters listed in the table below apply to Level 3 MasterCard transactions as extended
data.
172
Parameter
Description
COMMCODE
(Optional) Summary commodity code identifier for the business.
Character length and limitations: 4 alphanumeric characters
DISCOUNT
(Optional) Discount amount.
Character length and limitations: 12 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Merchant e-Solutions Purchasing Card Transaction Processing
Parameter
Description
FREIGHTAMT
(Optional) Freight amount.
Character length and limitations: 12 numeric characters
DUTYAMT
(Optional)Duty amount.
Character length and limitations: 12 numeric characters
ORDERDATE
(Required) Order date. Format is mmddyy with no slashes or dashes. For example,
July 28, 2003 is 072803.
Character length and limitations: 6 numeric characters
SHIPTOZIP
(Required) The zip code of the address to which the goods are shipped.
Character length and limitations: 10 alphanumeric characters
SHIPFROMZIP
(Required) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 10 alphanumeric characters
SHIPTOCOUNTRY
(Optional) Destination country code.
Character length and limitations: 3 alphanumeric characters
VATREGNUM
(Required) VAT registration number. Can be part of the registration data or passed
with each transaction.
Character length and limitations: 20 alphanumeric characters
FREIGHTAMT
(Required) Unique VAT inventory reference number. Can be part of the registration
data or passed with each transaction.
Character length and limitations: 9 alphanumeric characters
CUSTVATREGNUM
(Required) Customer VAT registration number.
Character length and limitations: 13 alphanumeric characters
VATTAXAMT
(Optional) VAT/tax amount (freight/shipping).
Character length and limitations: 12 numeric characters
VATTAXPERCENT
(Optional) VAT/tax rate (freight/shipping).
Character length and limitations: 4 numeric characters
C
Merchant e-Solutions Level 3 Visa Line Item Detail Records
Parameter
Description
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12 alphanumeric characters
L_DESCn
(Required) Item descriptor.
Character length and limitations: 35 alphanumeric characters
L_UPCn
(Optional) Product code.
Character length and limitations: 12 alphanumeric characters
L_QTYn
(Required) Quantity.
Character length and limitations: 12 numeric characters
Gateway Developer Guide and Reference
31 July 2012
173
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing
Parameter
Description
L_UOMn
(Required) Unit of measure code.
Character length and limitations: 12 alphanumeric characters
L_COSTn
(Required) Unit cost.
Character length and limitations: 12 numeric characters
L_TAXAMTn
(Optional) VAT/tax amount.
Character length and limitations: 12 numeric characters
L_TAXRATEn
(Optional) VAT/tax rate.
Character length and limitations: 4 numeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 12 numeric characters
L_AMTn
(Optional) Line-item total.
Character length and limitations: 12 numeric characters
Example Merchant e-Solutions Level 3 Visa Transaction Parameter String
TRXTYPE=S&TENDER=C&PARTNER=Partner&USER=User&PWD=Password&ACCT=411111111111
1111&EXPDATE=1215&AMT=1.00&BILLTOSTREET=5199 JOHNSON&TAXAMT=1.06&BILLTOZIP=
94588&ALTTAXAMT=1.00&CUSTVATREGNUM=11111&LOCALTAXAMT=1.01&NATIONALTAXAMT=1.
02&COMMCODE=22222&VATAXAMT=1.03&VATAXPERCENT=55&TAXEXEMPT=N&DISCOUNT=.50&FR
EIGHTAMT=1.00&DUTYAMT=1.00&SHIPTOZIP=33333&SHIPFROMZIP=44444&SHIPTOCOUNTRY=
840&ORDERDATE=020725&L_COMMCODE1=123456789ABC&L_DESC1=Line item 1 descripti
on&L_UPC1=CBA987654321&L_QTY1=1&L_UOM1=123456789012&L_COST1=1.50&L_TAXAMT1=
1.05&L_TAXRATE1=12&L_DISCOUNT1=.50&L_AMT1=1.00&L_TAXTYPE1=TT1
Paymentech Salem (New Hampshire) Purchasing Card
Transaction Processing
Paymentech Salem (New Hampshire) Level 2 Parameters for American
Express
The Paymentech Salem (New Hampshire) platform supports Level 2 parameters for American
Express, MasterCard, Visa, and Switch/Solo Maestro. The parameters in the following tables
meet card acceptance and American Express reporting and statement requirements.
174
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing
C
CPC Level 2 Transaction Advice Addendum Parameters
Field
Description
PONUM
(Required) Purchase order number.
Character length and limitations: 17 alphanumeric characters
SHIPTOZIP
(Required) Ship-to postal code (called zip code in the USA).
Character length and limitations: 15 alphanumeric characters
TAXAMT
(Optional) Total tax amount. Must include a decimal and be exact to the cent (42.00,
not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_DESC1
(Optional) Description of this line item; if not provided, DESC1 (if present) is used.
Character length and limitations: 140 alphanumeric characters
L_AMT1
(Optional) Charge for this line item. Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_QTY1
(Optional) Quantity of this line item.
Character length and limitations: 3 numeric characters
L_DESC2
(Optional) Description of this line item; if not provided, DESC2 (if present) is used.
Character length and limitations: 40 alphanumeric characters
L_AMT2
(Optional) Charge for this line item. Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_QTY2
(Optional) Quantity of this line item
Character length and limitations: 3 numeric characters
L_DESC3
(Optional) Description of this line item; if not provided, DESC3 (if present) is used
Character length and limitations: 40 alphanumeric characters
L_AMT3
(Optional) Charge for this line item. Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_QTY3
(Optional) Quantity of this line item
Character length and limitations: 3 numeric characters
L_DESC4
(Optional) Description of this line item; if not provided, DESC4 (if present) is used
Character length and limitations: 30 alphanumeric characters
L_AMT4
(Optional) Charge for this line item. Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56).
Character length and limitations: 12 numeric characters
L_QTY4
(Optional) Quantity of this line item
Character length and limitations: 3 numeric characters
Gateway Developer Guide and Reference
31 July 2012
175
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing
Location Transaction Advice Addendum Parameters
Field
Description
MERCHANTNAME
(Optional) Name of merchant.
Character length and limitations: 38 alphanumeric characters
MERCHANTSTREET
(Optional) Merchant’s street address (number and street name).
Character length and limitations: 38 alphanumeric characters. If more than 38
characters, use proper and meaningful abbreviation. Do not truncate.
MERCHANTCITY
(Optional) The name of the city were the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another
entity), you must enter the name of the city in which the seller is located.
If you are a mail order, phone order, or internet industry, you may substitute the
name of the city in which the merchant’s order processing facility is located.
Character length and limitations: 21 alphanumeric characters. If more than 21
characters, use proper and meaningful abbreviation. Do not truncate.
MERCHANTSTATE
(Optional) The region code that corresponds to the state, province, or country
subdivision of the merchant location where the transaction took place.
Region code examples:
CA = California, USA
NS = Nova Scotia, Canada
COS = Colima Mexico
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the region code that corresponds to the state, province, or country
subdivision in which the seller is located.
Character length and limitations: 3 alphanumeric characters
MERCHANTZIP
(Optional) The 5- to 9-digit zip (postal) code excluding spaces, dashes, and nonnumeric characters where the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the postal code that corresponds to the seller’s location.
Character length and limitations; 15 alphanumeric characters
MERCHANTCOUNTRYCODE
(Optional) Country code of the location where the transaction took place.
Character length and limitations: 3 alphanumeric characters
MERCHANTLOCATIONID
(Optional)Merchant-assigned store or location number (or name) that uniquely
identifies where the transaction took place.
N O TE :
Paymentech must enable your division for soft merchant processing or your
transaction will fail with response reason code 258. Contact your Paymentech
Account Manager for details.
Character length and limitations: 15 alphanumeric characters
176
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing
Field
Description
MERCHANTID
(Required) American Express-assigned service establishment number used to identify
and facilitate payments to merchants.
N O TE :
C
Paymentech must enable your division for soft merchant processing or your
transaction will fail with response reason code 258. Contact your Paymentech
Account Manager for details.
Character length and limitations: 15 alphanumeric characters
MERCHANTCONTACTINFO
(Optional) Merchant’s telephone number or web address. (URLs and e-mail addresses
may be lowercase, as appropriate.) This entry may appear on the descriptive bill on
the card-member’s statement, or may be used to resolve billing inquiries and disputes.
N O TE :
Paymentech must enable your division for soft merchant processing or your
transaction will fail with response reason code 258. Contact your Paymentech
Account Manager for details.
Character length and limitations: 40 alphanumeric characters
Transaction Advice Detail Parameters
Field
Description
ADDLAMTn
(Optional) Detail of a charge where n is a value from 1 - 5. Use for additional
breakdown of the amount.
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
ADDLAMTTYPEn
(Optional) A 3-digit code indicating the type of the corresponding charge detail,
where n is a value from 1 - 5.
Character length and limitations: 3 numeric characters
Paymentech Salem (New Hampshire) Level 3 Purchasing Card Parameters
Paymentech Salem (New Hampshire) supports Level 3 parameters for MasterCard and Visa.
Both Level 2 transaction parameters in the following table are required for Level 3
transactions. Level 3 transactions that do not include them are rejected.
Paymentech Salem (New Hampshire) Level 2 Parameters Required for Level 3
Transactions
To get the discount rate, pass both Level 2 parameters in the following table.
Level 2 Parameters Required for Level 3 Transactions
Parameter
Description
PONUM
(Required) Customer reference number.
Character length and limitations: 1 to 17 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
177
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing
Parameter
Description
TAXAMT
(Required) Sales tax.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
Paymentech Salem (New Hampshire) Level 3 MasterCard Parameters
Level 3 MasterCard Order Parameters
Parameter
Description
FREIGHTAMT
(Required) Freight amount.
Character length and limitations: numeric
DUTYAMT
(Required) Duty amount.
Character length and limitations: numeric
SHIPTOZIP
(Required) Destination zip code.
SHIPTOCOUNTRY
(Optional) Destination country.
SHIPFROMZIP
(Required) Ship from zip code.
DISCOUNT
(Required) Discount amount.
Character length and limitations: numeric
ALTERNATETAXID
(Optional) Alternate tax ID.
ALTERNATETAXAMT
(Optional) Alternate tax amount.
Character length and limitations: numeric
. Level 3 MasterCard Line Item Record #1 Parameters
178
Parameter
Description
L_DESCn
(Required) Description.
L_PRODCODEn
(Optional) Product code.
L_QTYn
(Required) Quantity.
Character length and limitations: numeric characters
L_UOMn
(Required) Unit of measure.
TAXAMTn
(Optional) Tax amount.
Character length and limitations: numeric
L_TAXRATEn
(Optional) Tax rate.
Character length and limitations: 4 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing
C
. Level 3 MasterCard Line Item Record #2 Parameters
Parameter
Description
L_AMTn
(Optional) Line-item total.
Character length and limitations: numeric
L_DISCOUNTn
(Optional) Discount amount.
Character length and limitations: numeric
L_TAXTYPEn
(Optional) Tax type applied.
Paymentech Salem (New Hampshire) Level 3 Visa Parameters
Level 3 Visa Order Parameters
Parameter
Description
FREIGHTAMT
(Required) Freight amount.
Character length and limitations: numeric
DUTYAMT
(Required) Duty amount.
Character length and limitations: numeric
SHIPTOZIP
(Required) Destination zip code.
SHIPTOCOUNTRY
(Optional) Destination country.
SHIPFROMZIP
(Required) Ship from zip code.
DISCOUNT
(Required) Discount amount.
Character length and limitations: numeric
TAXAMT
(Optional) VAT/Tax ID.
Character length and limitations: numeric
TAXPERCENTAGE
(Optional) VAT/Tax amount.
. Level 3 Visa Line Item Record #1 Parameters
Parameter
Description
L_DESCn
(Required) Description.
L_PRODCODEn
(Required) Product code.
L_QTYn
(Required) Quantity.
Character length and limitations: numeric characters
L_UOMn
(Required) Unit of measure.
TAXAMTn
(Optional) Tax amount.
Character length and limitations: numeric
L_TAXRATEn
(Optional) Tax rate.
Character length and limitations: 4 numeric characters
Gateway Developer Guide and Reference
31 July 2012
179
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
Paymentech Tampa Level 2 Purchasing Card Transaction Processing
. Level 3 Visa Line Item Record #2 Parameters
Parameter
Description
L_AMTn
(Optional) Line-item total.
Character length and limitations: numeric
L_DISCOUNTn
(Optional) Discount amount.
Character length and limitations: numeric
L_UPCn
(Optional) Item commodity code.
L_COSTn
(Optional) Unit cost.
Character length and limitations: numeric
Example Paymentech Salem (New Hampshire) Level 3 MasterCard Transaction
Parameter String
TRXTYPE=S&TENDER=C&PARTNER=Partner&PWD=Password&USER=User&ACCT=548018000000
0024&EXPDATE=1215&AMT=1.00&COMMENT1=0508&BILLTOFIRSTNAME=Robert&BILLTOSTREE
T=123 Main St.&BILLTOZIP=94065&CVV2=426&PONUM=ABCDEFGHIJ&TAXAMT=1.00&FREIGH
TAMT=2.00&DUTYAMT=3.00&SHIPTOZIP=94543&SHIPTOCOUNTRY=840&SHIPFROMZIP=94509&
ALTERNATETAXID=10&ALTERNATETAXAMT=4.00&L_DESC1=MC Pcard&L_UPC1=1&L_QTY1=2&L
_UOM1=3&L_TAXAMT1=4&L_TAXRATE1=5&L_AMT1=6&L_DISCOUNT1=7&L_TAXTYPE1=8
Example Paymentech Salem (New Hampshire) Level 3 Visa Transaction
Parameter String
TRXTYPE=S&TENDER=C&PARTNER=Partner&PWD=Password&USER=User&ACCT=427533001234
5626&EXPDATE=1215&AMT=1.00&COMMENT1=0508&BILLTOFIRSTNAME=Robert&BILLTOSTREE
T=123 Main St.&BILLTOZIP=94065&CVV2=426&PONUM=ABCDEFGHIJ&TAXAMT=1.00&FREIGH
TAMT=2.00&DUTYAMT=3.00&SHIPTOZIP=94543&SHIPTOCOUNTRY=840&SHIPFROMZIP=94509&
DISCOUNT=4.00&VATAXAMT=5.00&VATAXPERCENT=10&L_DESC1=TSYS Acquiring Solution
s Pcard&L_UPC1=1&L_UOM1=2&L_QTY1=3&L_TAXAMT1=4&L_TAXRATE1=5&L_AMT1=6&L_DISC
OUNT1=7&L_COMMCODE1=8&L_COST1=9&L_COST1=10
Paymentech Tampa Level 2 Purchasing Card Transaction
Processing
Paymentech Tampa supports Level 2 purchasing card processing for MasterCard and Visa.
180
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
SecureNet Purchasing Card Transaction Processing
C
Paymentech Tampa Level 2 Parameters
Paymentech Tampa
Level 2 Parameters
Description
PONUM
(Required) Customer reference number.
Character length and limitations: 1 to 17 alphanumeric characters
TAXAMT
(Required) Sales tax.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
TAXEXEMPT
(Required) Tax exempt.
Character length and limitations: 1 alphanumeric character, Y or N
SHIPTOZIP
(Required) Ship-to postal code (called zip code in the USA).
Character length and limitations: 1 to 16 alphanumeric characters
Example Paymentech Tampa Level 2 Visa and MasterCard Transaction
Parameter String
TRXTYPE=S&TENDER=C&PWD=PWD&USER=USER&PARTNER=PARTNER&ACCT=4275330012345675&
EXPDATE=1215&AMT=12.59&VERBOSITY=HIGH&BILLTOSTREET=123 Main St.&BILLTOZIP=4
9801&CVV2=248&TAXAMT=1.22&PONUM=AB12345678&SHIPTOZIP=98765&TAXEXEMPT=N
SecureNet Purchasing Card Transaction Processing
SecureNet supports MasterCard and Visa for performing Level 2 and Level 3 purchasing card
transactions.
SecureNet Level 2 Parameters
SecureNet supports MasterCard and Visa for Level 2 purchasing card transactions.
SecureNet indicates in the authorization response whether the credit card in the transaction is a
commercial card. Based in the commercial card indicator, Payflow will format the Level 2
information in the settlement request.
To get the discount rate, Level 2 parameters marked as Required in the following table must be
present .
Gateway Developer Guide and Reference
31 July 2012
181
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
SecureNet Purchasing Card Transaction Processing
SecureNet Level 2 Parameters
Parameter
Description
PONUM
(Required) Customer reference ID.
Character length and limitations: 1 to 17 alphanumeric characters
TAXAMT
(Required) Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: numeric
TAXEXEMPT
(Optional) Tax amount identifier.
Character length and limitations: 1 alpha character, Y or N
Example SecureNet Level 2 Visa Transaction Parameter String.
TRXTYPE=S&ACCT=4111111111111111&AMT=20.02&BILLTOCITY=Mountain View&COMMENT1
=L2 Testing&EXPDATE=1215&INVNUM=661254585&BILLTOFIRSTNAME=CardHolder First
Name&BILLTOLASTNAME=CardHolder Last Name&PARTNER=PayPal&PWD=pwd&BILLTOSTATE
=CA&BILLTOSTREET=123 Main St.&TAXAMT=1.01&TAXEXEMPT=N&TENDER=C&USER=user&BI
LLTOZIP=94043
SecureNet Level 3 MasterCard Parameters
To qualify for Level 3 purchasing card transaction processing, the authorization response for
the transaction must have the commercial card indicator set and one or more line items should
be present in the delayed capture or sale request.
Level 2 transaction parameters marked as Required are required for Level 3 transactions.
Level 3 transactions that do not include the required Level 2 values are rejected.
IM PORT AN T :
The values required for Level 3 status vary by bank, so contact your bank for
details.
SecureNet Level 2 MasterCard Parameters Required for Level 3 Line Item
Transactions
182
Parameter
Description
PONUM
(Required) Purchase identifier. The transaction ID is sent if no value is provided.
Character length and limitations: 25 alphanumeric characters
TAXAMT
(Required)Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: numeric
LOCALTAXAMT
(Optional) Local tax.
Character length and limitations: 12 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
SecureNet Purchasing Card Transaction Processing
Parameter
Description
TAXEXEMPT
(Optional) Local tax incl flag.
Character length and limitations: 1 alphanumeric, Y or N
NATIONALTAXAMT
(Optional)National tax amount.
Character length and limitations: 12 numeric characters
INVNUM
(Required) Purchase order number/customer reference ID. The value of PNREF is sent
if the INVNUM parameter is not provided.
Character length and limitations: 9 alphanumeric characters
C
SecureNet Level 3 MasterCard Extended Data
The parameters listed in the table below apply to Level 3 MasterCard transactions as extended
data.
Parameter
Description
FREIGHTAMT
(Optional) Freight amount.
Character length and limitations: 12 numeric characters
DUTYAMT
(Optional) Duty amount.
Character length and limitations: 12 numeric characters
SHIPTOZIP
(Required) The zip code of the address to which the goods are shipped.
Character length and limitations: 10 alphanumeric characters
SHIPFROMZIP
(Required) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 10 alphanumeric characters
SHIPTOCOUNTRY
(Optional) Destination country code.
Character length and limitations: 3 alphanumeric characters
ALTTAXAMT
(Optional) Alternate tax amount.
Character length and limitations: 9 numeric characters
SecureNet Level 3 MasterCard Line Item Detail Records
NOT E :
For these values, n is a sequence counter that should begin with 1 and increase in
sequence. Each line item should also contain quantity (L_QTY) and unit price
(L_COST) fields.
Parameter
Description
L_DESCn
(Required) Item descriptor.
Character length and limitations: 35 alphanumeric characters
L_UPCn
(Optional) Product code.
Character length and limitations: 12 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
183
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
SecureNet Purchasing Card Transaction Processing
Parameter
Description
L_QTYn
(Required) Quantity.
Character length and limitations: 12 numeric characters
L_UOMn
(Required)Unit of measure/code.
Character length and limitations: 12 alphanumeric characters
L_TAXRATEn
(Optional) Tax rate applied.
Character length and limitations: 4 numeric characters
L_TAXTYPEn
(Optional) Tax type applied.
Character length and limitations: 4 alphanumeric characters
L_TAXAMTn
(Optional)Tax amount.
Character length and limitations: 12 numeric characters
L_DISCOUNTn
(Optional) Discount amount.
Character length and limitations: 12 numeric characters
Example SecureNet Level 3 MasterCard Transaction Parameter String
TRXTYPE=S&TENDER=C&PARTNER=Partner&USER=User&PWD=Password&ACCT=552500000000
0005&EXPDATE=1215&AMT=1.00&BILLTOSTREET=5199 JOHNSON&BILLTOZIP=94588&ALTTAX
AMT=1.00&CUSTVATREGNUM=11111&LOCALTAXAMT=1.00&NATIONALTAXAMT=1.00&COMMCODE=
22222&VATAXAMT=1.00&VATAXPERCENT=10&TAXEXEMPT=Y&DISCOUNT=1.00&FREIGHTAMT=1.
00&DUTYAMT=1.00&SHIPTOZIP=33333&SHIPFROMZIP=44444&SHIPTOCOUNTRY=840&ORDERDA
TE=020725&L_COMMCODE1=123456789ABC&L_DESC1=Line item 1 description&L_UPC1=C
BA987654321&L_QTY1=1&L_UOM1=123456789012&L_COST1=1.00&L_TAXAMT1=1.00&L_TAXR
ATE1=1.00&L_DISCOUNT1=1.00&L_AMT1=1.00&L_TAXTYPE1=TT3
SecureNet Acquiring Solutions Level 3 Visa Parameters
To qualify for Level 3 purchasing card transaction processing, the authorization response for
the transaction must have the commercial card indicator set and one or more line items should
be present in the delayed capture or sale request.
Level 2 transaction parameters marked as Required are required for Level 3 transactions.
Level 3 transactions that do not include the required Level 2 values are rejected.
IM PORT AN T :
The values required for Level 3 status vary by bank, so contact your bank for
details.
SecureNet Level 2 Visa Parameters for Level 3 Line Item Transactions
184
Parameter
Description
PONUM
(Required) Purchase identifier. The transaction ID is sent if no value is provided.
Character length and limitations: 25 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
SecureNet Purchasing Card Transaction Processing
Parameter
Description
TAXAMT
(Required)Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: numeric
LOCALTAXAMT
(Optional) Local tax.
Character length and limitations: 12 numeric characters
TAXEXEMPT
(Optional) Local tax incl flag.
Character length and limitations: 1 alphanumeric, Y or N
NATIONALTAXAMT
(Optional)National tax amount.
Character length and limitations: 12 numeric characters
INVNUM
(Required) Purchase order number/customer reference ID. The value of PNREF is sent
if the INVNUM parameter is not provided.
Character length and limitations: 9 alphanumeric characters
C
SecureNet Level 3 Visa Extended Data
The parameters listed in the table below apply to Level 3 Visa transactions as extended data.
Parameter
Description
COMMCODE
(Optional) Commodity code identifier for the business.
Character length and limitations: 4 alphanumeric characters
DISCOUNT
(Optional) Discount amount.
Character length and limitations: 12 numeric characters
FREIGHTAMT
(Optional) Freight amount.
Character length and limitations: 12 numeric characters
DUTYAMT
(Optional) Duty amount.
Character length and limitations: 12 numeric characters
ORDERDATE
(Required) Order date. The format is mmddyy with no slashes or dashes. For example,
July 28, 2003 is 072803.
Character length and limitations: 6 numeric characters
SHIPTOZIP
(Required) The zip code of the address to which the goods are shipped.
Character length and limitations: 10 alphanumeric characters
SHIPFROMZIP
(Required) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 10 alphanumeric characters
SHIPTOCOUNTRY
(Optional) Destination country code.
Character length and limitations: 3 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
185
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
SecureNet Purchasing Card Transaction Processing
Parameter
Description
VATREGNUM
(Required) VAT registration number. Can be part of the registration data or passed
with each transaction.
Character length and limitations: 20 alphanumeric characters
FREIGHTAMT
(Required) Unique VAT inv reference number. Can be part of the registration data or
passed with each transaction.
Character length and limitations: 9 alphanumeric characters
CUSTVATREGNUM
(Required) Customer VAT Registration Number.
Character length and limitations: 13 alphanumeric characters
VATTAXAMT
(Optional)VAT/tax amount (freight/shipping).
Character length and limitations: 12 numeric characters
VATTAXPERCENT
(Optional) VAT/tax rate (freight/shipping).
Character length and limitations: 4 numeric characters
SecureNet Level 3 Visa Line Item Detail Records
NOT E :
186
For these values, n is a sequence counter that should begin with 1 and increase in
sequence. Each line item should also contain quantity (L_QTYn) and unit price
(L_COSTn) fields.
Parameter
Description
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12 alphanumeric characters
L_DESCn
(Required) Item descriptor.
Character length and limitations: 35 alphanumeric characters
L_UPCn
(Optional) Product code.
Character length and limitations: 12 alphanumeric characters
L_QTYn
(Required) Item quantity.
Character length and limitations: 12 numeric characters
L_UOMn
(Required) Unit of measure/code.
Character length and limitations: 12 alphanumeric characters
L_COSTn
(Required) Unit cost.
Character length and limitations: 12 numeric characters
L_TAXAMTn
(Optional) VAT/tax amount.
Character length and limitations: 12 numeric characters
L_TAXRATEn
(Optional) VAT/tax rate.
Character length and limitations: 4 numeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 12 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
TSYS Acquiring Solutions Purchasing Card Transaction Processing
Parameter
Description
L_AMTn
(Optional) Line-item total.
Character length and limitations: 12 numeric characters
C
Example SecureNet Level 3 Visa Transaction Parameter String
TRXTYPE=S&TENDER=C&PARTNER=Partner&USER=User&PWD=Password&ACCT=411111111111
1111&EXPDATE=1215&AMT=1.00&BILLTOSTREET=5199 JOHNSON&TAXAMT=1.06&BILLTOZIP=
94588&ALTTAXAMT=1.00&CUSTVATREGNUM=11111&LOCALTAXAMT=1.01&NATIONALTAXAMT=1.
02&COMMCODE=22222&VATAXAMT=1.03&VATAXPERCENT=55&TAXEXEMPT=N&DISCOUNT=.50&FR
EIGHTAMT=1.00&DUTYAMT=1.00&SHIPTOZIP=33333&SHIPFROMZIP=44444&SHIPTOCOUNTRY=
840&ORDERDATE=081125&L_COMMCODE1=123456789ABC&L_DESC1=Line item 1 descripti
on&L_UPC1=CBA987654321&L_QTY1=1&L_UOM1=123456789012&L_COST1=1.50&L_TAXAMT1=
1.05&L_TAXRATE1=12&L_DISCOUNT1=.50&L_AMT1=1.00&L_TAXTYPE1=TT1
TSYS Acquiring Solutions Purchasing Card Transaction
Processing
TSYS Acquiring Solutions supports MasterCard and Visa for performing Level 2 and Level 3
purchasing card transactions.
TSYS Acquiring Solutions Level 2 Parameters
TSYS Acquiring Solutions supports MasterCard and Visa for Level 2 purchasing card
transactions.
TSYS Acquiring Solutions indicates in the authorization response whether the credit card in
the transaction is a commercial card. Based in the commercial card indicator, Payflow will
format the Level 2 information in the settlement request.
To get the discount rate, Level 2 parameters marked as required in the following table must be
present .
TSYS Acquiring Solutions Level 2 Parameters
Parameter
Description
PONUM
(Required) Customer reference ID.
Character length and limitations: 1 to 17 alphanumeric characters
TAXAMT
(Required) Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: numeric
Gateway Developer Guide and Reference
31 July 2012
187
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
TSYS Acquiring Solutions Purchasing Card Transaction Processing
Parameter
Description
TAXEXEMPT
(Optional) Tax amount identifier.
Character length and limitations: 1 alpha character, Y or N
Example TSYS Acquiring Solutions Level 2 Visa Transaction Parameter String.
TRXTYPE=S&ACCT=4111111111111111&AMT=20.02&BILLTOCITY=Mountain View&COMMENT1
=L2 Testing&EXPDATE=1215&INVNUM=661254585&BILLTOFIRSTNAME=CardHolder First
Name&BILLTOLASTNAME=CardHolder Last Name&PARTNER=PayPal&PWD=pwd&BILLTOSTATE
=CA&BILLTOSTREET=123 Main St.&TAXAMT=1.01&TAXEXEMPT=N&TENDER=C&USER=user&BI
LLTOZIP=94043
TSYS Acquiring Solutions Level 3 MasterCard Parameters
To qualify for Level 3 purchasing card transaction processing, the authorization response for
the transaction must have the commercial card indicator set and one or more line items should
be present in the delayed capture or sale request.
Level 2 transaction parameters marked as Required are required for Level 3 transactions.
Level 3 transactions that do not include the required Level 2 values are rejected.
IM PORT AN T :
The values required for Level 3 status vary by bank, so contact your bank for
details.
TSYS Acquiring Solutions Level 2 MasterCard Parameters Required for Level 3
Line Item Transactions
188
Parameter
Description
PONUM
(Required) Purchase identifier. The transaction ID is sent if no value is provided.
Character length and limitations: 25 alphanumeric characters
TAXAMT
(Required)Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: numeric
LOCALTAXAMT
(Optional) Local tax.
Character length and limitations: 12 numeric characters
TAXEXEMPT
(Optional) Local tax incl flag.
Character length and limitations: 1 alphanumeric, Y or N
NATIONALTAXAMT
(Optional)National tax amount.
Character length and limitations: 12 numeric characters
INVNUM
(Required) Purchase order number/customer reference ID. The value of PNREF is sent
if the INVNUM parameter is not provided.
Character length and limitations: 9 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
TSYS Acquiring Solutions Purchasing Card Transaction Processing
C
TSYS Acquiring Solutions Level 3 MasterCard Extended Data
The parameters listed in the table below apply to Level 3 MasterCard transactions as extended
data.
Parameter
Description
FREIGHTAMT
(Optional) Freight amount.
Character length and limitations: 12 numeric characters
DUTYAMT
(Optional) Duty amount.
Character length and limitations: 12 numeric characters
SHIPTOZIP
(Required) The zip code of the address to which the goods are shipped.
Character length and limitations: 10 alphanumeric characters
SHIPFROMZIP
(Required) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 10 alphanumeric characters
SHIPTOCOUNTRY
(Optional) Destination country code.
Character length and limitations: 3 alphanumeric characters
ALTTAXAMT
(Optional) Alternate tax amount.
Character length and limitations: 9 numeric characters
TSYS Acquiring Solutions Level 3 MasterCard Line Item Detail Records
NOT E :
For these values, n is a sequence counter that should begin with 1 and increase in
sequence. Each line item should also contain quantity (L_QTY) and unit price
(L_COST) fields.
Parameter
Description
L_DESCn
(Required) Item descriptor.
Character length and limitations: 35 alphanumeric characters
L_UPCn
(Optional) Product code.
Character length and limitations: 12 alphanumeric characters
L_QTYn
(Required) Quantity.
Character length and limitations: 12 numeric characters
L_UOMn
(Required)Unit of measure/code.
Character length and limitations: 12 alphanumeric characters
L_TAXRATEn
(Optional) Tax rate applied.
Character length and limitations: 4 numeric characters
L_TAXTYPEn
(Optional) Tax type applied.
Character length and limitations: 4 alphanumeric characters
L_TAXAMTn
(Optional)Tax amount.
Character length and limitations: 12 numeric characters
Gateway Developer Guide and Reference
31 July 2012
189
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
TSYS Acquiring Solutions Purchasing Card Transaction Processing
Parameter
Description
L_DISCOUNTn
(Optional) Discount amount.
Character length and limitations: 12 numeric characters
Example TSYS Acquiring Solutions Level 3 MasterCard Transaction Parameter
String
TRXTYPE=S&TENDER=C&PARTNER=Partner&USER=User&PWD=Password&ACCT=552500000000
0005&EXPDATE=1215&AMT=1.00&BILLTOSTREET=5199 JOHNSON&BILLTOZIP=94588&ALTTAX
AMT=1.00&CUSTVATREGNUM=11111&LOCALTAXAMT=1.00&NATIONALTAXAMT=1.00&COMMCODE=
22222&VATAXAMT=1.00&VATAXPERCENT=10&TAXEXEMPT=Y&DISCOUNT=1.00&FREIGHTAMT=1.
00&DUTYAMT=1.00&SHIPTOZIP=33333&SHIPFROMZIP=44444&SHIPTOCOUNTRY=840&ORDERDA
TE=020725&L_COMMCODE1=123456789ABC&L_DESC1=Line item 1 description&L_UPC1=C
BA987654321&L_QTY1=1&L_UOM1=123456789012&L_COST1=1.00&L_TAXAMT1=1.00&L_TAXR
ATE1=1.00&L_DISCOUNT1=1.00&L_AMT1=1.00&L_TAXTYPE1=TT3
TSYS Acquiring Solutions Level 3 Visa Parameters
To qualify for Level 3 purchasing card transaction processing, the authorization response for
the transaction must have the commercial card indicator set and one or more line items should
be present in the delayed capture or sale request.
Level 2 transaction parameters marked as Required are required for Level 3 transactions.
Level 3 transactions that do not include the required Level 2 values are rejected.
IM PORT AN T :
The values required for Level 3 status vary by bank, so contact your bank for
details.
TSYS Acquiring Solutions Level 2 Visa Parameters for Level 3 Line Item
Transactions
190
Parameter
Description
PONUM
(Required) Purchase identifier. The transaction ID is sent if no value is provided.
Character length and limitations: 25 alphanumeric characters
TAXAMT
(Required)Tax amount.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: numeric
LOCALTAXAMT
(Optional) Local tax.
Character length and limitations: 12 numeric characters
TAXEXEMPT
(Optional) Local tax incl flag.
Character length and limitations: 1 alphanumeric, Y or N
NATIONALTAXAMT
(Optional)National tax amount.
Character length and limitations: 12 numeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
TSYS Acquiring Solutions Purchasing Card Transaction Processing
Parameter
Description
INVNUM
(Required) Purchase order number/customer reference ID. The value of PNREF is sent
if the INVNUM parameter is not provided.
Character length and limitations: 9 alphanumeric characters
C
TSYS Acquiring Solutions Level 3 Visa Extended Data
The parameters listed in the table below apply to Level 3 Visa transactions as extended data.
Parameter
Description
COMMCODE
(Optional) Commodity code identifier for the business.
Character length and limitations: 4 alphanumeric characters
DISCOUNT
(Optional) Discount amount.
Character length and limitations: 12 numeric characters
FREIGHTAMT
(Optional) Freight amount.
Character length and limitations: 12 numeric characters
DUTYAMT
(Optional) Duty amount.
Character length and limitations: 12 numeric characters
ORDERDATE
(Required) Order date. The format is mmddyy with no slashes or dashes. For example,
July 28, 2003 is 072803.
Character length and limitations: 6 numeric characters
SHIPTOZIP
(Required) The zip code of the address to which the goods are shipped.
Character length and limitations: 10 alphanumeric characters
SHIPFROMZIP
(Required) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 10 alphanumeric characters
SHIPTOCOUNTRY
(Optional) Destination country code.
Character length and limitations: 3 alphanumeric characters
VATREGNUM
(Required) VAT registration number. Can be part of the registration data or passed
with each transaction.
Character length and limitations: 20 alphanumeric characters
FREIGHTAMT
(Required) Unique VAT inv reference number. Can be part of the registration data or
passed with each transaction.
Character length and limitations: 9 alphanumeric characters
CUSTVATREGNUM
(Required) Customer VAT Registration Number.
Character length and limitations: 13 alphanumeric characters
VATTAXAMT
(Optional)VAT/tax amount (freight/shipping).
Character length and limitations: 12 numeric characters
VATTAXPERCENT
(Optional) VAT/tax rate (freight/shipping).
Character length and limitations: 4 numeric characters
Gateway Developer Guide and Reference
31 July 2012
191
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
TSYS Acquiring Solutions Purchasing Card Transaction Processing
TSYS Acquiring Solutions Level 3 Visa Line Item Detail Records
NOT E :
For these values, n is a sequence counter that should begin with 1 and increase in
sequence. Each line item should also contain quantity (L_QTYn) and unit price
(L_COSTn) fields.
Parameter
Description
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12 alphanumeric characters
L_DESCn
(Required) Item descriptor.
Character length and limitations: 35 alphanumeric characters
L_UPCn
(Optional) Product code.
Character length and limitations: 12 alphanumeric characters
L_QTYn
(Required) Item quantity.
Character length and limitations: 12 numeric characters
L_UOMn
(Required) Unit of measure/code.
Character length and limitations: 12 alphanumeric characters
L_COSTn
(Required) Unit cost.
Character length and limitations: 12 numeric characters
L_TAXAMTn
(Optional) VAT/tax amount.
Character length and limitations: 12 numeric characters
L_TAXRATEn
(Optional) VAT/tax rate.
Character length and limitations: 4 numeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 12 numeric characters
L_AMTn
(Optional) Line-item total.
Character length and limitations: 12 numeric characters
Example TSYS Acquiring Solutions Level 3 Visa Transaction Parameter String
TRXTYPE=S&TENDER=C&PARTNER=Partner&USER=User&PWD=Password&ACCT=411111111111
1111&EXPDATE=1215&AMT=1.00&BILLTOSTREET=5199 JOHNSON&TAXAMT=1.06&BILLTOZIP=
94588&ALTTAXAMT=1.00&CUSTVATREGNUM=11111&LOCALTAXAMT=1.01&NATIONALTAXAMT=1.
02&COMMCODE=22222&VATAXAMT=1.03&VATAXPERCENT=55&TAXEXEMPT=N&DISCOUNT=.50&FR
EIGHTAMT=1.00&DUTYAMT=1.00&SHIPTOZIP=33333&SHIPFROMZIP=44444&SHIPTOCOUNTRY=
840&ORDERDATE=081125&L_COMMCODE1=123456789ABC&L_DESC1=Line item 1 descripti
on&L_UPC1=CBA987654321&L_QTY1=1&L_UOM1=123456789012&L_COST1=1.50&L_TAXAMT1=
1.05&L_TAXRATE1=12&L_DISCOUNT1=.50&L_AMT1=1.00&L_TAXTYPE1=TT1
192
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
Vantiv Purchasing Card Transaction Processing
C
Vantiv Purchasing Card Transaction Processing
The following parameters are recommended to obtain the best rates for Level 2 and Level 3
purchasing card transactions with Vantiv.
Vantiv Purchasing Parameters
Field
Description
SHIPTOCOUNTRY
(Optional) Destination country code. Visa and MasterCard are different.
Character length and limitations: 3 alpha characters
DISCOUNT
(Optional) Discount amount on total sale
Character length and limitations: 10 currency characters
DUTYAMT
(Optional) Sometimes called import tax. If the currency uses a decimal, then the
value must include a decimal and the exact amount to the cent (42.00, not 42). Do
not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters
FREIGHTAMT
Character length and limitations: 10 currency characters
PONUM
(Optional) Purchase order number / merchant-related data.
Character length and limitations: 25 alphanumeric characters, provides best rate when
used
SHIPFROMZIP
(Optional) The postal code (called zip code in the USA) from which shipping occurs.
Character length and limitations: 9 numeric characters, provides best rate when used
SHIPTOZIP
(Optional) Ship to postal code (called zip code in the USA).
Character length and limitations: 9 numeric characters, provides best rate when used
TAXAMT
(Optional) Tax amount. The value must include a decimal and the exact amount to the
cent (42.00, not 42). Do not include comma separators (1234.56 not 1,234.56).
Character length and limitations: 10 currency characters
Vantiv Purchasing Card Line Item Parameters
Line item data (Level 3) describes the details of the item purchased and can be passed for each
transaction. The convention for passing line item data in name-value pairs is that each namevalue starts with L_ and ends with n where n is the line item number. For example L_QTY0=1
is the quantity for line item 0 and is equal to 1, with n starting at 0. In addition, the
SHIPFROMZIP parameter is required for Level 3 transactions.
Gateway Developer Guide and Reference
31 July 2012
193
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
WorldPay Purchasing Cards Transaction Processing
Vantiv Line Item Parameters
Field
Description
L_QTYn
(Required) Quantity (whole units only).
Character length and limitations: 10 numeric characters
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 12alphanumeric characters
L_DESCn
(Optional) Item description.
Character length and limitations: 35 alphanumeric characters
L_UOMn
(Optional) Item unit of measure.
Character length and limitations: 3 alpha characters
L_COSTn
(Optional) Cost per item, excluding tax.
Character length and limitations: 10 currency characters
L_UPCn
(Optional) Supplier specific product code.
Character length and limitations: 12 alphanumeric characters
L_DISCOUNTn
(Optional) Discount per line item.
Character length and limitations: 10 currency characters
L_AMTn
(Optional) Total line item amount including tax and discount. + for debit, - for credits.
Character length and limitations: 10 currency characters
L_TAXAMTn
(Optional) Line item tax amount.
Character length and limitations: 10 currency characters
WorldPay Purchasing Cards Transaction Processing
The following parameters are recommended to obtain the best rates for Level 2 and Level 3
purchasing card transactions with WorldPay.
WorldPay Level 2 Parameters
Pass the following WorldPay Level 2 parameters to get the discount rate.
WorldPay Level 2 parameters
194
Level 2 Parameters
Description
ALTTAXAMT
(Optional) Alternate tax amount.
Character length and limitations: 8 alphanumeric characters
COMMCODE
(Optional) Summary commodity code identifier for the business.
Character length and limitations: 4 alphanumeric characters
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
WorldPay Purchasing Cards Transaction Processing
Level 2 Parameters
Description
COUNTRYCODE
(Optional) Country code.
Character length and limitations: 3 alphanumeric characters
CUSTDATA
(Optional) Generic data the merchant can pass to the WorldPay processor.
Character length and limitations: 95 alphanumeric characters
CUSTOMERID
(Optional) Purchase order number.
Character length and limitations: 95 alphanumeric characters
CUSTOMERNUMBER
(Optional) Customer number.
Character length and limitations: 95 alphanumeric characters
DISCOUNT
(Optional) Discount amount on total sale.
Character length and limitations: 10 currency characters
DLNAME
(Optional) Account holder’s driver license name.
Character length and limitations: 95characters
DLNUM
(Optional) Account holder’s driver license number.
Character length and limitations: 95 alphanumeric characters
DOB
(Optional) Account holder’s date of birth in the format MMDDYYYY. For example, July
28, 2011 is represented as: 07282011
Character length and limitations: 8 characters
DUTYAMT
(Optional) Sometimes called import tax.
Character length and limitations: The value must include a decimal and the exact
amount to the cent (42.00, not 42). Do not include comma separators (1234.56 not
1,234.56). 10 currency characters
FREIGHTAMT
(Optional) Total freight amount.
Character length and limitations: The value must include a decimal and the exact
amount to the cent (42.00, not 42). Do not include comma separators (1234.56 not
1,234.56). 10 currency characters
INVNUM
(Optional) Merchant invoice number for the transaction.
Character length and limitations: 95 alphanumeric characters
MERCHANTDESCR
(Optional) Description of product.
Character length and limitations: 50 alphanumeric characters
MERCHANTINVNUM
(Optional) Merchant invoice number.
Character length and limitations: 25 alphanumeric characters
MERCHANTVATNUM
(Optional) Merchant value added tax number.
Character length and limitations: 95 alphanumericcharacters
MERCHANTZIP
(Optional) 5- to 9-digit zip (postal) code excluding spaces, dashes, and nonnumeric
characters where the transaction took place.
If you are a third-party biller (bill for services or goods rendered by another entity),
you must enter the postal code that corresponds to the seller’s location.
Character length and limitations: 15 alphanumeric characters
Gateway Developer Guide and Reference
31 July 2012
C
195
C
Submitting Purchasing Card Level 2 and Level 3 Transactions
WorldPay Purchasing Cards Transaction Processing
Level 2 Parameters
Description
MISCDATA
(Optional) Miscellaneous data.
Character length and limitations: 95 alphanumeric characters
ORDERDATE
(Required) Order date. The format is MMDDYY with no slashes or dashes. For example,
July 28, 2011 is 072811.
Character length and limitations: 6 numeric characters
PONUM
(Optional) Purchase order number.
Character length and limitations: 25 alphanumeric characters
SHIPTOZIP
(Optional) Ship to postal code (called zip code in the USA).
Character length and limitations: 9 numeric characters
TAXAMT
(Optional) Sales tax.
The value must include a decimal and the exact amount to the cent (42.00, not 42).
Do not include comma separators (1234.56 not 1,234.56). To qualify for Level 2
discounts, this value must not be all zeros or blank spaces.
Character length and limitations: numeric
TAXEXEMPT
(Optional) Indicates whether the customer is tax exempt. It is one of the following
values:
Y – The customer is tax exempt.
N – The customer is not tax exempt (default).
Character length and limitations: 1alpha character
VATINVNUM
(Optional) Value added tax invoice number.
Character length and limitations: 95 alphanumeric characters
VATNUM
(Optional) Customer valued added tax number.
Character length and limitations: 95 alphanumeric characters
VATTAXAMT
(Optional) VAT/tax amount (freight/shipping).
Character length and limitations: 12 numeric characters
VATTAXRATE
(Optional) VAT/tax rate (freight/shipping).
Character length and limitations: 4 numeric characters
WorldPay Level 3 Parameters
Pass the following WorldPay Level 3 parameters to get the discount rate.
WorldPay Level 3 parameters
196
Level 3 Parameters
Description
L_ALTTAXAMTn
(Optional) Alternate tax amount for this item.
Character length and limitations: 8 numeric characters plus decimal: XXXX.XX
31 July 2012
Gateway Developer Guide and Reference
Submitting Purchasing Card Level 2 and Level 3 Transactions
WorldPay Purchasing Cards Transaction Processing
Level 3 Parameters
Description
L_ALTTAXRATEn
(Optional) Alternate tax rate for this item.
Character length and limitations: 4 numeric characters plus decimal: XX.XX
L_ALTTAXIDn
(Optional) Alternate tax identifier for this item.
Character length and limitations: 95 alphanumeric characters
L_EXTAMTn
(Optional) Extended item amount.
Character length and limitations: 8 numeric characters
L_TAXTYPEn
(Optional) Tax type applied.
Character length and limitations: 4 alphanumeric characters
L_COMMCODEn
(Optional) Item commodity code.
Character length and limitations: 35 alphanumeric characters
L_DESCn
(Optional) Item description.
Character length and limitations: 10 currency characters
L_AMTn
(Optional) Total line item amount including tax. + for debit, - for credits
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
L_SKUn
(Optional) Item’s supplier stock keeping unit (SKU) number or product code.
Character length and limitations: 8 numeric characters
L_QTYn
(Required) Quantity (whole units only).
Character length and limitations: 10 numeric characters
L_CARRIERSERVICELEV
ELCODEn
(Optional) Service code.
Character length and limitations: 1 alphanumeric character
L_COSTn
(Optional) Item freight amount.
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 10 currency characters
L_UOMn
(Optional) Item unit of measure.
Character length and limitations: 3 alpha characters
L_TAXAMTn
(Optional) Item tax amount.
Character length and limitations: Must include a decimal and be exact to the cent
(42.00, not 42) and exclude comma separators (1234.56 not 1,234.56). Examples:
tip=3.00, convenience charge=2.00. 12 numeric characters
L_TAXRATEn
(Optional) Tax rate for this item.
Character length and limitations: 4 numeric characters plus decimal:XXXX
Gateway Developer Guide and Reference
31 July 2012
C
197
C
198
Submitting Purchasing Card Level 2 and Level 3 Transactions
WorldPay Purchasing Cards Transaction Processing
31 July 2012
Gateway Developer Guide and Reference
D
VERBOSITY: Viewing ProcessorSpecific Transaction Results
Set the VERBOSITY parameter to HIGH to view the processor’s raw response values and
additional values. This setting returns multiple parameters. Select only the returned parameters
that you want to handle and disregard the rest.
NOT E :
VERBOSITY is being deprecated in future Gateway releases.
Gateway Developer Guide and Reference
31 July 2012
199
D
200
VERBOSITY: Viewing Processor-Specific Transaction Results
31 July 2012
Gateway Developer Guide and Reference
E
ISO Country Codes
The Gateway API uses the International Standards Organization (ISO) 3166-1 numeric
country codes in the following fields: BILLTOCOUNTRY and SHIPTOCOUNTRY. For a
complete list of the current officially assigned ISO 3166-1 numeric country codes, refer to:
http://en.wikipedia.org/wiki/ISO_3166-1_numeric
NOT E :
If PayPal is your acquirer, refer instead to the “Countries and Regions Supported by
PayPal” on page 225.
Gateway Developer Guide and Reference
31 July 2012
201
E
202
ISO Country Codes
31 July 2012
Gateway Developer Guide and Reference
F
Codes Used by FDMS South Only
The following codes are used by FDMS South only.
“MasterCard Country Codes for FDMS South Only” on page 203
“Visa Country Codes” on page 210
“Units of Measure” on page 217
MasterCard Country Codes for FDMS South Only
ALBANIA
ALB
ALGERIA
DZA
AMERICAN SAMOA
ASM
ANDORRA
AND
ANGOLA
AGO
ANGUILLA
AIA
ANTARCTICA
ATA
ANTIGUA
ATG
APHGANISTAN
AFG
ARGENTINA
ARG
ARMENIA
ARN
ARUBA
ABW
AUSTRALIA
AUS
AUSTRIA
AUT
AZERBAIJAN
AZE
BAHAMAS
BHS
BAHRAIN
BHR
BANGLADESH
BGD
BARBADOS
BRB
BELARUS
BLR
BELGIUM
BEL
Gateway Developer Guide and Reference
31 July 2012
203
F
204
Codes Used by FDMS South Only
MasterCard Country Codes for FDMS South Only
BELIZE
BLZ
BENIN
BEN
BERMUDA
BMU
BHUTAN
BTN
BOLIVIA
BOL
BOSNIA AND HERZEGOVINA
BIH
BOTSWANA
BWA
BOUVET ISLAND
BVT
BRAZIL
BRA
BRITISH INDIAN OCEAN TERRITORY
IOT
BRUNEI
BRN
BULGARIA
BGR
BURKINA FASO
BFA
BURUNDI
BDI
CAMBODIA
KHM
CANADA
CAN
CAPE VERDE
CPV
CAYMAN ISLANDS
CYM
CENTRAL AFRICAN REPUBLIC
CAF
CHAD
TCD
CHILE
CHL
CHINA
CHN
CHRISTMAS ISLAND
CXR
CMEROON, UNITED REP.
CMR
COCOS (KEELING) ISLANDS
CCK
COLOMBIA
COL
COMOROS
COM
CONGO
GOG
COOK ISLANDS
COK
COSTA RICA
CRI
COTED’IVOIRE
CIV
CROATIA
HRV
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
MasterCard Country Codes for FDMS South Only
CYPRUS
CYP
CZECH REPUBLIC
CZE
DENMARK
DNK
DJIBOUTI
DJI
DOMINICA
DMA
DOMINICAN REPUBLIC
DOM
EL SALVADOR
SLV
EQUATORIAL GUINEA
GNQ
ESTONIA
EST
ETHIOPIA
ETH
FAEROE ISLANDS
FRO
FALKLAND ISLANDS (MALVINAS)
FLK
FIJI
FJI
FINLAND
FIN
FRANCE
FRA
FRENCH GUIANA
GUF
FRENCH POLYNESIA
PYF
FRENCH SOUTHERN TERRITORIES
ATF
GABON
GAB
GAMBIA
GMB
GEORGIA
GEO
GERMAN DEMOCRATIC REP
DDR
GERMANY
DEU
GHANA
GHA
GIBRALTAR
GIB
GREECE
GRC
GREENLAND
GRL
GRENADA
GRD
GUADALUPE
GLP
GUAM
GUM
GUATEMALA
GTM
GUINEA
GIN
Gateway Developer Guide and Reference
31 July 2012
F
205
F
206
Codes Used by FDMS South Only
MasterCard Country Codes for FDMS South Only
GUINEA-BISSAU
GNB
GUYANA
GUY
HAITI
HTI
HEARD AND MCDONALD ISLANDS
HMD
HONDURAS
HND
HONG KONG
HKG
HUNGARY
HUN
ICELAND
ISL
INDIA
IND
INDONESIA
IDN
IRAN
IRN
IRAQ
IRQ
IRELAND
IRL
ISRAEL
ISR
ITALY
ITA
JAMAICA
JAM
JAPAN
JPN
JORDAN
JOR
KAZAKHSTAN
KAZ
KENYA
KEN
KOREA, REPUBLIC OF
KOR
KUWAIT
KWT
KYRGYZSTAN
KGZ
LAO PEOPLES DEMOCRATIC
LAO
LATVIA
LVA
LEBANON
LBN
LESOTHO
LSO
LIBERIA
LBR
LIBYAN ARAB JAMAHIRIYA
LBY
LIECHTNSTIEN
LIE
LITHUANIA
LTU
LUXEMBOURG
LUX
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
MasterCard Country Codes for FDMS South Only
MACAU
MAC
MALAYSIA
MYS
MALDIVES
MDV
MALI
MLI
MALTA
MLT
MANACO
MCO
MARSHALL ISLANDS
MHL
MARTINIQUE
MTQ
MAURITANIA
MRT
MAURITIUS
MUS
MEXICO
MEX
MICRONESIA
FSM
MOLDOVA
MDA
MONGOLIA
MNG
MONTSERRAT
MSR
MOROCCO
MAR
MOZAMBIQUE
MOZ
MYANMAR
MMR
NAMIBIA
NAM
NAURU
NRU
NEGEL
SEN
NEPAL
NPL
NETHERLANDS
NLD
NETHERLANDS ANTILLES
ANT
NEW CALEDONIA
NCL
NEW ZEALAND
NZL
NICARAGUA
NIC
NIGER
NER
NIGERIA
NGA
NIUE
NIU
NORFOLK ISLAND
NFK
NORTHERN MARIANA ISLAND
MNP
Gateway Developer Guide and Reference
31 July 2012
F
207
F
208
Codes Used by FDMS South Only
MasterCard Country Codes for FDMS South Only
NORWAY
NOR
OMAN
OMN
PAKISTAN
PAK
PALAU
PLW
PANAMA
PAN
PAPUA NEW GUINEA
PNG
PARAGUAY
PRY
PERU
PER
PHILIPPINES
PHI
PITCAIRN ISLAND
PCN
POLAND
POL
PORTUGAL
PRT
PUERTO RICO
PRI
QATAR
QAT
REUNION
REU
ROMANIA
ROM
RUSSIAN FEDERATION
RUS
RWANDA
RWA
SAMOA
WSM
SAN MARINO
SMR
SAN TOME AND PRICIPEL
STP
SAUDI ARABIA
SAU
SEYCHELLES
SYC
SIERRA LEONA
SLE
SINGAPORE
SGP
ST. HELENA
SHN
ST. KITTS-NEVIS-ANGUILLA
KNA
ST. LUCIA
LCA
ST. PIERRE AND MIQUELON
SPM
ST. VINCENT AND THE GRENADINES
VCT
SUDAN
SDN
SURINAME
SUR
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
MasterCard Country Codes for FDMS South Only
SVALBARD AND JAN MAYEN ISLANDS
SJM
SWAZILAND
SWZ
SWEDEN
SWE
SWITZERLAND
CHE
SYRIAN ARAB REPUBLIC
SYR
TAIWAN, PROVIDENCE OF CHINA
TWN
TAJIKISTAN
TJK
TANZANIA, UNITED REPUBLIC
TZA
THAILAND
THA
TOGO
TGO
TOKELAU
TKL
TONGA
TON
TRINIDAD AND TOBAGO
TTO
TUNISIA
TUN
TURKEY
TR
TURKMENISTAN
TM
TURKS AND CAICOS ISLANDS
TC
TUVALU
TUV
U.S. MINOR OUTLYING ISL.
UMI
UGANDA
UGA
UKRAINE
UKR
UNITED ARAB EMIRATES
ARE
UNITED KINGDOM
GBR
UNITED STATES
USA
URUGUAY
URY
UZBEKISTAN
UZB
VANUATU
VUT
VATICAN CITY STATE
VAT
VENEZUELA
VEN
VIETNAM
VNM
VIRGIN ISLANDS BRITISH
VGB
VIRGIN ISLANDS US
VIR
Gateway Developer Guide and Reference
31 July 2012
F
209
F
Codes Used by FDMS South Only
Visa Country Codes
WALLIS AND FUTUNA IS
WLF
WESTERN SAHARA
ESH
YEMEN
YEM
YUGOSLAVIA
YUG
ZAIRE
ZAR
ZAMBIA
ZMB
ZIMBABWE
RHO
Visa Country Codes
210
ALBANIA
AL
ALGERIA
DZ
AMERICAN SAMOA
AS
ANDORRA
AD
ANGOLA
AO
ANGUILLA
AI
ANTARCTICA
AQ
ANTIGUA
AG
APHGANISTAN
AF
ARGENTINA
AR
ARMENIA
AM
ARUBA
AW
AUSTRALIA
AU
AUSTRIA
AT
AZERBAIJAN
AZ
BAHAMAS
BS
BAHRAIN
BH
BANGLADESH
BD
BARBADOS
BB
BELARUS
BY
BELGIUM
BE
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
Visa Country Codes
BELIZE
BZ
BENIN
BJ
BERMUDA
BM
BHUTAN
BT
BOLIVIA
BO
BOSNIA AND HERZEGOVINA
BA
BOTSWANA
BW
BOUVET ISLAND
BV
BRAZIL
BR
BRITISH INDIAN OCEAN TERRITORY
IO
BRUNEI
BN
BULGARIA
BG
BURKINA FASO
BF
BURUNDI
BI
CAMBODIA
KH
CANADA
CA
CAPE VERDE
CV
CAYMAN ISLANDS
KY
CENTRAL AFRICAN REPUBLIC
CF
CHAD
TD
CHILE
CL
CHINA
CN
CHRISTMAS ISLAND
CX
CMEROON, UNITED REP.
CM
COLOMBIA
CO
COMOROS
KM
CONGO
CG
COOK ISLANDS
CK
COSTA RICA
CR
COTED’IVOIRE
CI
CROATIA
HR
CYPRUS
CY
Gateway Developer Guide and Reference
31 July 2012
F
211
F
212
Codes Used by FDMS South Only
Visa Country Codes
CZECH REPUBLIC
CZ
DENMARK
DK
DJIBOUTI
DJ
DOMINICA
DM
DOMINICAN REPUBLIC
DO
EAST TIMOR
TP
ECUADOR
EC
EGYPT
EG
EL SALVADOR
SV
EQUATORIAL GUINEA
GQ
ESTONIA
EE
ETHIOPIA
ET
FAEROE ISLANDS
FK
FALKLAND ISLANDS (MALVINAS)
FK
FIJI
FJ
FINLAND
FI
FRANCE
FR
FRENCH GUIANA
GF
FRENCH METROPOLITAN
FX
FRENCH POLYNESIA
PF
FRENCH SOUTHERN TERRITORIES
TF
GABON
GA
GAMBIA
GM
GEORGIA
GE
GERMANY
DE
GHANA
GH
GIBRALTER
GI
GREECE
GR
GREENLAND
GL
GRENADA
GD
GUADALUPE
GP
GUAM
GU
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
Visa Country Codes
GUATEMALA
GT
GUINEA
GN
GUINEA-BISSAU
GW
GUYANA
GY
HAITI
HT
HEARD AND MCDONALD ISLANDS
HM
HONDURAS
HN
HONG KONG
HK
HUNGARY
HU
ICELAND
IS
INDIA
IN
INDONESIA
ID
IRAN
IR
IRAQ
IQ
IRELAND
IE
ISRAEL
IL
ITALY
IT
JAMAICA
JM
JAPAN
JP
JORDAN
JO
KAZAKHSTAN
KZ
KENYA
KE
KIRIBATI
KI
KOREA, REPUBLIC OF
KR
KUWAIT
KW
KYRGYZSTAN
KG
LAO PEOPLES DEMOCRATIC
LA
LATVIA
LV
LEBANON
LB
LESOTHO
LS
LIBERIA
LR
LIBYAN ARAB JAMAHIRIYA
LY
Gateway Developer Guide and Reference
31 July 2012
F
213
F
214
Codes Used by FDMS South Only
Visa Country Codes
LIECHTNSTIEN
LI
LITHUANIA
LT
LUXEMBOURG
LU
MACAU
MO
MACEDONIA
MK
MADAGASCAR
MG
MALAWI
MW
MALAYSIA
MY
MALDIVES
MV
MALI
ML
MALTA
MT
MANACO
MC
MARSHALL ISLANDS
MH
MARTINIQUE
MQ
MAURITANIA
MR
MAURITIUS
MU
MAYOTTE
YT
MEXICO
MX
MICRONESIA
FM
MOLDOVA
MD
MONGOLIA
MN
MONTSERRAT
MS
MOROCCO
MA
MOZAMBIQUE
MZ
MYANMAR
MM
NAMIBIA
NA
NAURU
NR
NEPAL
NP
NETHERLANDS
NL
NETHERLANDS ANTILLES
AN
NEW CALDONIA
NC
NEW ZEALAND
NZ
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
Visa Country Codes
NICARAGUA
NI
NIGER
NE
NIGERIA
NG
NIUE
NU
NORFOLK ISLAND
NF
NORTHERN MARIANA ISLAND
MP
NORWAY
NO
OMAN
OM
PAKISTAN
PK
PALAU
PW
PANAMA
PA
PAPUA NEW GUINEA
PG
PARAGUAY
PY
PERU
PE
PHILIPPINES
PH
PITCAIRN ISLAND
PN
POLAND
PL
PORTUGUL
PT
PUERTO RICO
PR
QATAR
QA
REUNION
RE
ROMANIA
RO
RUSSIAN FEDERATION
RU
RWANDA
RW
SAMOA
WS
SAN MARINO
SM
SAN TOME AND PRICIPEL
ST
SAUDI ARABIA
SA
SENEGAL
SN
SEYCHELLES
SC
SIERRA LEONA
SL
SINGAPORE
SG
Gateway Developer Guide and Reference
31 July 2012
F
215
F
216
Codes Used by FDMS South Only
Visa Country Codes
ST. HELENA
SH
ST. KITTS-NEVIS-ANGUILLA
KN
ST. LUCIA
LC
ST. PIERRE AND MIQUELON
PM
ST. VINCENT AND THE GRENADINES
VC
SUDAN
SD
SURINAME
SR
SVALBARD AND JAN MAYEN IS
SJ
SWAZILAND
SZ
SWEDEN
SE
SWITZERLAND
CH
SYRIAN ARAB REPUBLIC
SY
TAIWAN, PROVIDENCE OF CHINA
TW
TAJIKISTAN
TJ
TANZANIA, UNITED REPUBLIC
TZ
THAILAND
TH
TOGO
TG
TOKELAU
TK
TONGA
TO
TRINIDAD AND TOBAGO
TT
TUNISIA
TN
TURKEY
TR
TURKMENISTAN
TM
TURKS AND CAICOS ISLANDS
TC
TUVALU
TV
U.S. MINOR OUTLYING ISL.
UM
UGANDA
UG
UKRAINIAN SSR
UA
UNITED ARAB EMIRATES
AE
UNITED KINGDOM
GB
UNITED STATES
US
URUGUAY
UY
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
Units of Measure
UZBEKISTAN
UZ
VANUATU
VU
VATICAN CITY STATE
VA
VENEZUELA
VE
VIETNAM
VN
VIRGIN ISLANDS BRITISH
VG
VIRGIN ISLANDS US
VI
WALLIS AND FUTUNA IS
WF
WESTERN SAHARA
EH
YEMEN
YE
YUGOSLAVIA
YU
ZAIRE
ZR
ZAMBIA
ZM
ZIMBABWE
ZW
F
Units of Measure
Acre (4840 yd2)
ACR
Alcoholic strength by mass
ASM
Alcoholic strength by volume
ASV
Ampere*
AMP
Ampere=hour (3,6 kC)*
AMH
Are (100 m2)
ARE
Bar*
BAR
Barrel (petroleum) (158,987 dm3)
BLL
Becquerel*
BQL
Billion EUR
BIL
Billion US
MLD
Board foot
BFT
Brake horse power (245,7 watts)
BHP
British thermal unit (1,055 kilojoules)
BTU
Gateway Developer Guide and Reference
31 July 2012
217
F
Codes Used by FDMS South Only
Units of Measure
Bushel (35,2391 dm3)
BUA
Bushel (36,36874 dm3)
BUI
Candela*
CDL
Carrying capacity in metric tonnes
CCT
Cental GB (45,359237 kg)
CNT
Center, metric (100 kg) (syn.: Hectokilogram)
DTN
Centigram*
CGM
Centilitre*
CLT
Centimetre*
CMT
Cord (3,63 m3)
WCD
Coulomb per kilogram*
CKG
Coulomb*
COU
Cubic centimetre*
CMQ
Cubic decimetre*
DMQ
Cubic foot
FTQ
Cubic inch
INQ
Cubic metre per hour*
MQH
Cubic metre per second*
MQS
Cubic metre*
MTQ
Cubic millimetre*
MMQ
Cubic yard
YDQ
Curie
CUR
Day*
DAY
Decade (ten years)
DEC
Decare
DAA
Decilitre*
DLT
Decimetre*
DMT
Decitonne*
DTN
Degree Celsius
CEL
Degree Fahrenheit
FAH
Degree Kelvin: Kelvin
Displacement tonnage
218
DPT
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
Units of Measure
Dozen
DZN
Dozen packs
DZP
Dozen pairs
DZR
Dozen pieces
DCP
Dozen rolls
DRL
Drachm GB (3,887935 g)
DRM
Dram GB (1,771745 g)
DRI
Dram US (3,887935 g)
DRA
Dry Barrel (115,627 dm3)
BLD
Dry gallon (4,404884 dm3)
GLD
Dry pint (0,55061 dm3)
PTD
Dry quart (1,101221 dm3)
QTD
Farad*
FAR
Fluid ounce (28,413 cm3)
OZI
Fluid ounce (29,5735 cm3)
OZA
Foot (0,3048 m)
FOT
Gallon (4,546092 dm3)
GLI
Gigabecquerel*
GBQ
Gigawatt-hour (1 million kW/h)*
GWH
Gill (0,142065 dm3)
GII
Gill (11,8294 cm3)
GIA
Grain GB, US (64,798910 mg)
GRN
Gram of fissile isotopes
GFI
Gram*
GRM
Great gross (12 gross)
GGR
Gross
GRO
Gross (register) ton
GRT
Half year (six months)
SAN
Hectare
HAR
Hectobar*
HBA
Hectogram*
HGM
Hectokilogram*
DTH
Gateway Developer Guide and Reference
31 July 2012
F
219
F
220
Codes Used by FDMS South Only
Units of Measure
Hectolitre of pure alcohol
HPA
Hectolitre*
HLT
Hectometre*
HMT
Hertz*
HTZ
Hour*
HUR
Hundred
CEN
Hundred boxes
BHX
Hundred international units
HIU
Hundred leaves
CLF
Hundred packs
CNP
Hundredweight US (45,3592 kg)
CWA
Inch (25,4 mm)
INH
Joule*
JOU
Kelvin*
KEL
Kilobar*
KBA
Kilogram of caustic potash
KPH
Kilogram of caustic soda
KSH
Kilogram of named substance
KNS
Kilogram of nitrogen
KNI
Kilogram of phosphonic anhydride
KPP
Kilogram of phosphorus pentoxide
KPP
Kilogram of potassium hydroxide
KPH
Kilogram of potassium oxide
KPO
Kilogram of sodium hydroxide
KSH
Kilogram of substance 90 percent dry
KSD
Kilogram per cubic meter*
KMQ
Kilogram per second*
KGS
Kilogram*
KGM
Kilohertz*
KHZ
Kilojoule*
KJO
Kilometre per hour*
KMH
Kilometre*
KMT
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
Units of Measure
Kilopascal*
KPA
Kilorgram of uranium
KUR
Kilotonne*
KTN
Kilovar
KVR
Kilovolt*
KVT
Kilovolt-ampere*
KVA
Kilowatt*
KWT
Kilowatt-hour*
KWH
Knot (1 nautical mile per hour)
KNT
Leaf
LEF
Liquid gallon (3,78541 dm3)
GLL
Liquid pint (0,473176 dm3)
PTL
Liquid quart (0,946353 dm3)
QTL
Litre (1 dm3)*
LTR
Litre of pure alcohol
LPA
Long ton GB, US (1,0160469 t)
LTN
(long) hundredweight GB (50,802345 kg)
CWI
Lumen*
LUM
Lux
LUX
Megahertz*
MHZ
Megalitre*
MAL
Megametre*
MAM
Megapascal*
MPA
Megavolt-ampere (1000 KVA)*
MVA
Megawatt*
MAW
Megawatt-hour (100 kW/h)*
MWH
Metre per second squared*
MSK
Metre per second*
MTS
Metre*
MTR
Metric carat (200 mg=2,10-4 kg)
CTM
Metric ton (1000 kg)
TNE
Milliard
MLD
Gateway Developer Guide and Reference
31 July 2012
F
221
F
222
Codes Used by FDMS South Only
Units of Measure
Millibar*
MBR
Millicurie
MCU
Milligram*
MGM
Millilitre*
MLT
Millimetre*
MMT
Million
MIO
Million cubic metres*
HMQ
Million international units
MIU
Minute*
MIN
Month
MON
Nautical mile (1852 m)
NMI
Net (register) ton
NTT
Newton*
NEW
Number
NMB
Number of articles
NAR
Number of bobbons
NBB
Number of cells*
NCL
Number of international units
NIU
Number of packs
NMP
Number of pairs
NMR
Number of parcels
NPL
Number of parts
NPT
Number of rolls
NRL
Ohm*
OHM
Ounce GB, US (28,349523 g)
ONZ
Ounce GB, US (31,103448 g) (syn: Troy ounce)
APZ
Pascal*
PAL
Pennyweight GB, US (1555174 g)
DWT
Piece
PCE
Pint (0,568262 dm3)
PTI
Pound GB, US (0,45359237 kg)
LBR
Proof gallon
PGL
31 July 2012
Gateway Developer Guide and Reference
Codes Used by FDMS South Only
Units of Measure
Quart (1,136523 dm3)
QTI
Quarter (of a year)
QAN
Quarter, GB (12,700586 kg)
QTR
Quintal, metric (100 kg)
DTN
Revolution per minute*
RPM
Revolution per second*
RPS
Score
SCO
scruple, GB (1,2955982 g)
SCR
Second*
SEC
Set
SET
Shipping ton
SHT
Short standard (7200 matches)
SST
Short ton GB, US (0,90718474 t)
STN
Siemens*
SIE
Square centimetre*
CMK
Square decimetre*
DMK
Square foot
FTK
Square inch
INK
Square kilometre*
KMK
Square metre*
MTK
Square mile
MIK
Square millimetre*
MMK
Square yard
YDK
Standard
WSD
standard atmosphere (101325 Pa)
ATM
(statue) mile (1609,344 m)
SMI
Stone GB (6,350293 kg)
STI
Technical atmosphere (98066,5 Pa)
ATT
Ten days
DAD
Ten pairs
TPR
Thousand
MIL
Thousand ampere-hour*
TAH
Gateway Developer Guide and Reference
31 July 2012
F
223
F
224
Codes Used by FDMS South Only
Units of Measure
Thousand board feet (2,36 m3)
MBF
Thousand cubic metres per day*
TQD
Thousand standard brick equivalent
MBE
Ton of steam per hour
TSH
Tonne (1000 kg)*
TNE
Tonne of substance 90 percent dry
TSD
Trillion EUR
TRL
Trillion US
BIL
Troy ounce
APZ
Troy pound, US (373,242 g)
LBT
Volt*
VLT
Watt*
WTT
Watt-hour*
WHR
Weber
WEB
Week
WEE
Yard (0,9144 m)
YRD
Year
ANN
31 July 2012
Gateway Developer Guide and Reference
G
PayPal Acquirer
If PayPal is your acquirer and no other bank is involved in processing your transactions, use
the following PayPal specific codes.
Countries and Regions Supported by PayPal
PayPal uses 2-character IS0-3166-1 codes for specifying countries and regions that are
supported in fields and variables.
For a complete list of countries and regions supported by PayPal and their 2-character ISO3166-1 codes, please refer to the PayPal API reference list of Countries and Regions.
PayPal Currency Codes
PayPal uses 3-character ISO-4217 codes for specifying currencies in fields and variables.
Please refer to the Currency Codes section of the PayPal API reference for a complete list of
currencies supported by PayPal.
Gateway Developer Guide and Reference
31 July 2012
225
G
226
PayPal Acquirer
PayPal Currency Codes
31 July 2012
Gateway Developer Guide and Reference
H
Additional Processor Information
Moneris Solutions
The Moneris Solutions processor has the following characteristics:
It supports ecommerce and mail order or telephone order (MOTO) transactions.
It supports the four basic credit card types: American Express, Discover, MasterCard, and
Visa.
To process live transactions, it requires undergoing a certification process. For details, see
the Moneris Receipts Specification available on the PayPal developer website.
Gateway Developer Guide and Reference
31 July 2012
227
Additional Processor Information
Moneris Solutions
228
31 July 2012
Gateway Developer Guide and Reference
I
Payflow Link Migration
If you are currently using the legacy Payflow Link HTML input tag integration and you would
like to use the name-value pair integration, you will need to contact PayPal Merchant
Technical Support to request your account to be upgraded to the new version of Payflow.
Before you request an upgrade, it is important that you understand the differences between the
Payflow Link legacy parameters and the equivalent Payflow parameters. Once you upgrade
your account to the new version your old legacy integration will still work. However, to take
advantage of the new features we recommend that you update your Payflow Link integration
and use equivalent Payflow parameters instead of the legacy Payflow Link HTML input tags.
Migrating from a legacy Payflow Link Integration
The legacy Payflow Link integration is now deprecated. It is recommended that you upgrade
the version of your Payflow Link account which allows you to perform a broader set of
functions. This upgrade allows you to switch from using the legacy Payflow Link HTML input
tag parameters to using Payflow parameters. The table below lists legacy Payflow Link
parameters and their Payflow equivalents.
Payflow Link legacy parameters and the equivalent Payflow parameters
Payflow Link Legacy Parameter
Payflow Parameter
ADDRESS
BILTOSTREET
ADDRESSTOSHIP
SHIPTOSTREET
AMOUNT
AMT
AVSDATA
AVSADDR and AVSZIP
CARDNUM
ACCT
CITY
BILLTOCITY
CITYTOSHIP
SHIPTOCITY
COMMENT1
COMMENT1
COMMENT2
COMMENT2
COUNTRY
BILLTOCOUNTRY
COUNTRYTOSHIP
SHIPTOCOUNTRY
COUNTRYCODE
COUNTRYCODE
CSC
CVV2
Gateway Developer Guide and Reference
31 July 2012
229
I
230
Payflow Link Migration
Migrating from a legacy Payflow Link Integration
Payflow Link Legacy Parameter
Payflow Parameter
CSCMATCH
CVV2MATCH
CUSTID
CUSTID
DESCRIPTION
N/A
DLNUM
DLNUM
EMAIL
BILLTOEMAIL
EMAILTOSHIP
SHIPTOEMAIL
EXPDATE
EXPDATE
FAX
BILLTOFAX
FAXTOSHIP
SHIPTOFAX
FIRSTNAME
BILLTOFIRSTNAME
INVOICE
INVNUM
LASTNAME
BILLTOLASTNAME
LOGIN
VENDOR
METHOD
TENDER
NAME
BILLTOFIRSTNAME
BILLTOLASTNAME
NAMETOSHIP
SHIPTOFIRSTNAME
SHIPTOLASTNAME
PARTNER
PARTNER
PHONE
BILLTOPHONENUM
PHONETOSHIP
SHIPTOPHONENUM
PONUM
PONUM
SHIPAMOUNT
FREIGHTAMT
STATE
BILLTOSTATE
STATETOSHIP
SHIPTOSTATE
TAX
TAXAMT
TYPE
TRXTYPE
USER1 - USER10
USER
ZIP
BILLTOZIP
ZIPTOSHIP
SHIPTOZIP
31 July 2012
Gateway Developer Guide and Reference
Source Exif Data:
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.6 Linearized : No XMP Toolkit : Adobe XMP Core 4.2.1-c043 52.372728, 2009/01/18-15:08:04 Creator Tool : FrameMaker 9.0 Modify Date : 2012:07:30 12:23:26-05:00 Create Date : 2012:07:30 11:56:18Z Metadata Date : 2012:07:30 12:23:26-05:00 Format : application/pdf Title : Gateway Developer Guide and Reference Creator : PayPal Inc. Producer : Acrobat Distiller 9.0.0 (Windows) Document ID : uuid:6851ef31-f3a7-44c3-a67a-7dabd8453f14 Instance ID : uuid:d1809102-f3e6-425d-b59e-d76131e3dd04 Page Mode : UseOutlines Page Count : 230 Author : PayPal Inc. Warning : [Minor] Ignored duplicate Info dictionaryEXIF Metadata provided by EXIF.tools