-
Gateway Developer Guide and Reference PayPal Payments Advanced PayPal Payments Pro Payflow Pro Payflow Link Last updated: 07 January 2014
-
Gateway Developer Guide and Reference Document Number: 200045.en_US-201401 © 1999 - 2014 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.
-
Content Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Who Should Use This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Revision History . . . . . . . . . . . . . . .
-
Content Configuring Hosted Checkout Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Configuring Hosted Pages Using PayPal Manager . . . . . . . . . . . . . . . . . . . . . 39 Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Customize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Integrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
-
Content Handling Credit Card Type Information . . . . . . . . . . . . . . . . . . . . . . . . . 60 Core Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Submitting Account Verifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 When To Use Account Verifications . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Required Account Verification Parameters . . . . . . . . . . . . . . . . . . . . . . . 64 Example Account Verification String .
-
Content Additional Parameters For Sale Transactions . . . . . . . . . . . . . . . . . . . . . . 79 Typical Sale Transaction Parameter String . . . . . . . . . . . . . . . . . . . . . . . 80 Submitting Soft Merchant Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 About Soft Merchant Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Ways to Send Soft Merchant Information . . . . . . . . . . . . . . . . . . . . . . . .
-
Content American Express Stored Value Card Example . . . . . . . . . . . . . . . . . . . . .103 PNREF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104 RESULT Values and RESPMSG Text . . . . . . . . . . . . . . . . . . . . . . . . . . . .104 RESULT Values For Communications Errors . . . . . . . . . . . . . . . . . . . . . . 111 Processor-specific Response Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Litle Response Parameters . . . . . . . . . .
-
Content Soft Merchant Descriptor Parameters . . . . . . . . . . . . . . . . . . . . . . . . . .138 WorldPay Additional Credit Card Parameters . . . . . . . . . . . . . . . . . . . . . . . .140 Chapter B TeleCheck Electronic Check Processing . . . . . . . . . 141 TeleCheck NFTF Overview of Services . . . . . . . . . . . . . . . . . . . . . . . . . . .141 TeleCheck NFTF Processing Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .141 NFTF Requirements . . . . . . . . . . . . . . . . . . . . .
-
Content Supported Transaction Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164 Avoiding Downgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165 Submitting Successful Level 3 Transactions . . . . . . . . . . . . . . . . . . . . . .165 Edit Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165 Accepted BIN Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
-
Content Cielo Payments Level 3 Visa Parameters . . . . . . . . . . . . . . . . . . . . . . . .192 Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing . . . . . .194 Paymentech Salem (New Hampshire) Level 2 Parameters for American Express . . .194 Paymentech Salem (New Hampshire) Level 3 Purchasing Card Parameters. . . . . .197 Paymentech Tampa Level 2 Purchasing Card Transaction Processing . . . . . . . . . . .201 Paymentech Tampa Level 2 Parameters . . . . . . . . . . . . . . . . . . .
-
Content Chapter I Payflow Link Migration . . . . . . . . . . . . . . . . . . 249 Migrating from a legacy Payflow Link Integration . . . . . . . . . . . . . . . . . . . . . .249 Chapter J Payflow Gateway MagTek Parameters . . . . . . . . . . . 251 MagTek MagneSafe Secure Card Readers and Qwick Codes . . . . . . . . . . . . . . .251 MagneSafe Secure Card Reader Authenticators . . . . . . . . . . . . . . . . . . . .251 MagTek Qwick Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
-
Content 12 07 January 2014 Gateway Developer Guide and Reference
-
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.
-
Intended Audience Who Should Use This Document This comprehensive developer guide includes integration information for multiple Gateway solutions. NOT E : 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.
-
Intended Audience 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.
-
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.
-
Revision History Revision History Revision History for the Gateway Developer Guide and Reference: Date Description 07 Jan 2014 Added Paymentech Tampa Level 3 Parameters. Updated processor name: Cielo Payments, formerly Merchant e-Solutions. Maintenance release. 21 Nov 2013 Updated the description of the CURRENCY field in PayPal Credit Card Transaction Request Parameters with information for PayPal Payments Advanced and PayPal Payments Pro merchants.
-
Revision History 18 Date Description 11 Jul 2013 Maintenance release. Added a new section on Processor-specific Response Parameters, which includes Litle Response Parameters and information on the Litle Automatic Account Updater feature. Added information on Testing the Litle Automatic Account Updater Feature. 15 Jun 2013 Added information on Submitting Credit (Refund) Transactions for the PayPal processor. Added the PAYMENTADVICECODE field to Credit Card Transaction Responses.
-
Revision History Date Description 28 Jan 2013 Added a new Appendix on Payflow Header Parameters. Added information about duplicate parameters in the Name-Value Parameter Syntax Guidelines. In the Hosted Pages Chapter, added the Passing Other Data to Your Server Using Post or Silent Post section, and clarified that Silent Posts are returned for both approved and declined transactions. Updated the Payflow Link legacy parameters and the equivalent Payflow parameters parameter table.
-
Revision History Date Description 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.
-
Revision History Date Description Updated parameters and examples: Added a description for the 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 the Litle parameters STREET2,STREET3 to BILLTOSTREET2, BILLTOSTREET3. Corrected the description of MERCHSVC parameter for FDMS North, Heartland, Litle, Merchant e-Solutions, Paymentech Salem.
-
Revision History Date Description January 2012 (cont.
-
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.
-
Revision History 24 07 January 2014 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.
-
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.
-
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) resa
-
1 Introducing the Gateway Checkout Solutions About Security 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.
-
Introducing the Gateway Checkout Solutions About Security 1 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.
-
1 Introducing the Gateway Checkout Solutions The PayPal Manager 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.
-
Introducing the Gateway Checkout Solutions Supported Payment Types 1 American Express American Express APAC Elavon 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 Vantiv WorldPay Supported Payment Types Credit cards PayPal (s
-
1 Introducing the Gateway Checkout Solutions Supported Languages Automated Clearing House (ACH). For information on performing ACH transactions, contact your PayPal Sales Representative. Supported Languages The Payflow Gateway only supports customer input and API parameter values that are in regular ASCII (English language) characters. Payflow does not support extended ASCII characters or any other character sets other than regular ASCII at this time.
-
2 Secure Token This section describes the secure token. “Secure Token” on page 33 “Integrating the Secure Token With the Hosted Checkout Pages” on page 34 “Integrating the Secure Token Without the Hosted Checkout Pages: Transparent Redirect” on page 34 “Posting To the Hosted Checkout Page” on page 36 “Using the PARMLIST Parameter” on page 46 IM PORT AN T : Use only the Payflow parameters described in this guide with the Secure Token.
-
2 Secure Token Integrating the Secure Token With the Hosted Checkout Pages 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 57. In addition, pass the following Payflow parameters to create the secure token.
-
Secure Token Secure Token Errors NOT E : 2 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.
-
2 Secure Token Posting To the Hosted Checkout Page 30 minutes after the Secure Token was generated. When the token is used in a successful transaction. If you receive one of the following error codes in the RESULT response parameter, then your Secure Token has expired. 160 Secure Token already been used. Indicates that the secure token has expired due to either a successful transaction or the token has been used three times while trying to successfully process a transaction.
-
Secure Token Posting To the Hosted Checkout Page 2
PageTitle
-
3 Configuring Hosted Checkout Pages This chapter describes the following: “Configuring Hosted Checkout Pages” on page 39 “Configuring Hosted Pages Using PayPal Manager” on page 39 “Using a Secure Token to Pass Hosted Pages Customization Parameters” on page 43 “Hosted Pages and Mobile Browsers” on page 47 “Silent Posts” on page 49 “Passing Other Data to Your Server Using Post or Silent Post” on page 50 Configuring Hosted Checkout Pages PayPal enables you to customize the hosted check
-
3 Configuring Hosted Checkout Pages Configuring Hosted Pages Using PayPal Manager Setup The Setup page in PayPal Manager enables you to select the information you want to collect from buyers and what you want displayed on your hosted checkout pages. This includes selecting the billing and the shipping information information fields, the payment confirmation page settings, the confirmation email details, security options and other settings.
-
Configuring Hosted Checkout Pages Configuring Hosted Pages Using PayPal Manager 3 developer portal. For more information on the Silent Post feature, go to “Silent Posts” on page 49 Customize The Customize page allows you to customize the layout and appearance of your hosted checkout page. You can customize the header, background, payment method section and the order summary column of your payment page. PayPal offers three design layouts for you to choose from.
-
3 Configuring Hosted Checkout Pages Configuring Hosted Pages Using PayPal Manager On the Customize page, you can either change the design of your existing layout, or select and customize a different layout. To make changes, double-click on the section of the template you are trying to modify or the corresponding Click to Edit button for that section. In the pop-up that appears, click the color selector to change the color, or enter the appropriate URL.
-
Configuring Hosted Checkout Pages Using a Secure Token to Pass Hosted Pages Customization Parameters 3 Page Background (Applicable to Layout B only) - You can change the following: – Background color – Footer text color – Upload a background image - .jpg, .jpeg, .gif, or .png. The maximum allowable image size is 100kb.
-
3 Configuring Hosted Checkout Pages Using a Secure Token to Pass Hosted Pages Customization Parameters The table below describes the form post parameters that you can use to dynamically configure the hosted checkout pages. Setup Parameters 44 Variable Description CANCELURL The URL that customers would go to if pressing a Cancel link from the hosted page (Layouts A and B only) and from the Express Checkout flow if the buyer chooses Express Checkout as their payment method.
-
Configuring Hosted Checkout Pages Using a Secure Token to Pass Hosted Pages Customization Parameters 3 Customize Parameters Variable Description PAGECOLLAPSEBGCOLOR Sets the color of the border around the embedded template C. Example: PAGECOLLAPSEBGCOLOR=993300 PAGECOLLAPSETEXTCOLOR Sets the color of the words “Pay with PayPal” and “Pay with credit or debit card”. Example: PAGECOLLAPSETEXTCOLOR=990000 PAGEBUTTONBGCOLOR Sets the color of the Pay Now / Submit button.
-
3 Configuring Hosted Checkout Pages Using the PARMLIST Parameter Variable Description SUBTOTAL Amount you pass to Payflow. It is displayed in the order summary section. This amount is only for display purposes and is not passed to the transaction servers. VERBOSITY Additional values returned from the transaction response to the merchant in the Silent Post. By default, there is no verbosity set which means the standard set of values that Silent Post currently uses is returned.
-
Configuring Hosted Checkout Pages Hosted Pages and Mobile Browsers 3 If you choose to use PARMLIST, then you can only pass the following 3 HTTP Post parameters to Payflow with PARMLIST: SECURETOKEN, SECURETOKENID and MODE (optional). If you try to pass in any other parameter (such as VERIFY=TRUE), then you will receive an error message. NOT E : The MODE parameter will be deprecated in the future.
-
3 Configuring Hosted Checkout Pages Hosted Pages and Mobile Browsers supported mobile browser and then explicitly pass the form post parameter: TEMPLATE=MOBILE.
-
Configuring Hosted Checkout Pages Silent Posts 3 Mobile page flow for a credit card payment Silent Posts Silent Post ensures that the transaction data is passed back to your website when a transaction is completed. The Silent Post feature uses the HTML Post method to return data to your server for both approved and declined trasactions. This occurs even if a customer closes the browser before returning to your site, or if the PayPal-hosted payment confirmation page is disabled.
-
3 Configuring Hosted Checkout Pages Passing Other Data to Your Server Using Post or Silent Post sure to check Void transaction when my server fails to receive data sent by the silent post when setting up Silent Posts in PayPal Manager. Data Returned by the Silent Post Features The Silent Post feature returns either a short list of data or all of the data that was submitted for the transaction.
-
4 Payflow SDK The Payflow Software Development Kit (SDK) is a set of APIs to allow you to integrate the Gateway with your application or website. This section includes: “Preparing the Payflow Gateway Client Application” on page 51. “Activating Your Payflow Gateway Account” on page 52. “Host URL Addresses” on page 52 NOT E : Each SDK includes full API documentation. IM PORT AN T : The Payflow SDK is available as a .NET or Java library. Using these SDKs is recommended to simplify integration.
-
4 Payflow SDK Activating Your Payflow Gateway Account Activating Your Payflow Gateway Account When you are ready to activate your Gateway account to begin submitting live transactions, follow these steps: 1. Log in to PayPal Manager at https://manager.paypal.com 2. Click ActivateYour Account and follow the on-screen instructions. 3. Change the URL within your web or desktop application to point to the live Gateway server host addresses.
-
5 Sending a Simple Transaction to the Server When using the Payflow SDK, you send transactions to the Gateway server in name-value pair format. Typically, a simple transaction includes connection parameters, user parameters, and transaction data parameters.
-
5 Sending a Simple Transaction to the Server Payflow Connection Parameters COMPANYNAME[14]=Ruff & Johnson COMMENT1[7]=Level=5 NOT E : Do not use quotation marks ("") even if you use a length tag. Name-Value Parameter Syntax Guidelines Follow these guidelines when creating name-value pair (NVP) parameter strings: Do not use spaces in values. Enclose the NVP parameter string in quotation marks (“ “). Do not place quotation marks within the body of the NVP parameter string.
-
Sending a Simple Transaction to the Server User Parameter Data 5 Pass the connection parameters in the format and syntax required by the Payflow SDK and programming language that you are using. See your integration documentation for details. Parameter Description HOSTADDRESS (Required) Gateway server name. HOSTPORT (Required) Use port 443. TIMEOUT (Required) Time-out period for the transaction. PayPal recommends a minimum time-out value of 30 seconds.
-
5 Sending a Simple Transaction to the Server Sale Transaction Example Sale Transaction Example In addition to the required connection and user parameters, each transaction type may require other parameters and can include a number of optional parameters.
-
6 Submitting Credit Card Transactions When using the Payflow SDK, plan how to implement credit card processing based on your business needs. Payflow SDK offers a core set of transaction parameters that all credit card processors use. This section describes how to submit a transaction for each transaction type supported. NOT E : Some of the transaction types and features described in this chapter are not supported by all processors.
-
6 Submitting Credit Card Transactions Obtaining an Internet Merchant Account Obtaining an Internet Merchant Account To accept credit cards over the internet, you need a special account called an Internet Merchant Account. If PayPal is your merchant bank, you do not need the Internet Merchant Account. Your account provider or merchant (acquiring) bank works with a PayPal-supported credit card processor. Examples are First Data, TSYS Acquiring Solutions (formerly Vital Processing Services), and Paymentech.
-
Submitting Credit Card Transactions Credit Card Features 6 Credit Card Features The Payflow SDK supports the following transaction types for credit card processing: Transaction Type Billable Authorization Yes Account Verification No Balance Inquiry No Credit Yes Delayed Capture No Inquiry No Sale Yes Voice Authorization Yes Void Yes The Payflow SDK also supports the following credit card features: Address verification service and card security code validation Card-present (SWIP
-
6 Submitting Credit Card Transactions Planning Your Gateway Integration process is also useful for evaluating information in the response, such as whether the issuer verifies the billing address, and so on. Electronic goods merchants, who fulfill the order immediately, can use the one-step process. Check with your Internet Merchant Account provider for suggestions on the best method for you. Whether or how to use risk management tools such as address verification service and card security code.
-
Submitting Credit Card Transactions Core Credit Card Parameters 6 To accept additional credit card types, contact your acquiring bank (holding your Internet Merchant Account) and ask them to add the card type to your account. Upon notification from your acquirer that you can start accepting the card type, add the card to your Payflow account through PayPal Manager. See PayPal Manager online help for details. NOT E : American Express cards require explicit acceptance when PayPal is the processor.
-
6 Submitting Credit Card Transactions Core Credit Card Parameters Parameter Description EXPDATE (Required) Expiration date of the credit card. For example, 1215 represents December 2015. Limitations: mmyy format AMT (Required) Amount (Default: U.S. based currency). Limitations: Specify the exact amount to the cent using a decimal point. For example, use 34.00 not 34. Do not include comma separators. For example, use 1199.95 not 1,199.95.
-
Submitting Credit Card Transactions Core Credit Card Parameters Parameter Description SWIPE (Required for card-present transactions only) Used to pass the Track 1 or Track 2 data (card’s magnetic stripe information) for card-present transactions. Include either Track 1 or Track 2 data—not both. If Track 1 is physically damaged, the point-of-sale (POS) application can send Track 2 data instead. The track data includes the disallowed = (equal sign) character.
-
6 Submitting Credit Card Transactions Submitting Account Verifications Parameter Description SHIPTOCITY (Optional) Ship-to city. Limitations: 20-character string. SHIPTOSTATE (Optional) Ship-to state. Limitations: 2-character string. SHIPTOZIP (Optional) Ship-to postal code. Limitations: 9-character string. SHIPTOCOUNTRY (Optional) Ship-to country. The Payflow API accepts 3-digit numeric country codes. Refer to: http://en.wikipedia.org/wiki/ISO_3166-1_numeric.
-
Submitting Credit Card Transactions Submitting Authorization/Delayed Capture Transactions Parameter Description TRXTYPE (Required) Set to A. Limitations: 1 alphanumeric character. AMT (Required) Set to 0. VERBOSITY (Required) Set to HIGH to obtain information about a partial authorization in the response. 6 Example Account Verification String The following is an example of account verification: TRXTYPE=A&TENDER=C&PARTNER=PayPal&USER=SuperUser&PWD=SuperUserPasswo rd&AMT=0.
-
6 Submitting Credit Card Transactions Submitting Balance Inquiry Transactions NOT E : If you signed up for the PayPal processor with Fraud Protection Services, use delayed capture processing for all sale transactions. If your business provides immediate fulfillment and you are not using the PayPal processor with Fraud Protection Services, you can use a simple sale transaction instead. For details, see “Submitting Sale Transactions” on page 79.
-
Submitting Credit Card Transactions Submitting Card Present (SWIPE) Transactions 6 Required Balance Inquiry Parameters To perform a balance inquiry on a pre-paid card, pass the following parameters: Parameter Description TRXTYPE (Required) Set to B. Limitations: 1 alphanumeric character. EXPDATE (Required) Expiration date of the pre-paid card in the format MMYY. For example, 1215 represents December 2015.
-
6 Submitting Credit Card Transactions Submitting Card Present (SWIPE) Transactions Processing Platforms Supporting Card-Present Transactions The following processing platforms support card-present transactions. For instructions on setting up or changing your processor, see the Processor Setup Guide (PDF). NOT E : PayPal Australia (FDRA) merchants with a 12-digit merchant ID, can contact Payflow support to request a 16-digit merchant ID.
-
Submitting Credit Card Transactions Submitting Credit (Refund) Transactions 6 characters in the track data and passes that number as the length tag. For details on length tags, see “Using Special Characters In Values” on page 53. The length tag in the following example is [40]. NOT E : Do not include the ACCT or EXPDATE parameters in card-present transactions. The SWIPE value includes this data.
-
6 Submitting Credit Card Transactions Submitting Credit (Refund) Transactions Parameter Description ORIGID (Required by some transaction types) ID of the original transaction referenced. The PNREF parameter returns this ID, and it appears as the Transaction ID in PayPal Manager reports. Limitations: 12 case-sensitive alphanumeric characters. Set the value of ORIGID to the PNREF value returned for the original transaction. (PayPal Manager reports display the PNREF as the Transaction ID.
-
Submitting Credit Card Transactions Submitting Inquiry Transactions NOT E : 6 For processors that use the RECURRING parameter: If you set the RECURRING parameter to Y in the original transaction, this setting is ignored when forming the credit transaction.
-
6 Submitting Credit Card Transactions Submitting Inquiry Transactions Inquiry Transaction Parameter String Using the PNREF This is an example inquiry transaction parameter string using the ORIGID parameter set to the PNREF value: TRXTYPE=I&TENDER=C&PARTNER=PayPal&VENDOR=SuperMerchant&USER=SuperMerchant&P WD=x1y2z3&ORIGID=VPNE12564395&VERBOSITY=HIGH Required Parameters When Using the CUSTREF To perform an inquiry transaction when using the CUSTREF, pass the CUSTREF parameter.
-
Submitting Credit Card Transactions Submitting Partial Authorizations 6 Inquiry Transaction Parameter String Using the CUSTREF This is an example inquiry parameter string using the CUSTREF.
-
6 Submitting Credit Card Transactions Submitting Partial Authorizations When To Use Partial Authorizations Use partial authorizations to reduce the number of declines resulting from buyers spending more than their balance on prepaid cards. Say, for example, that you sell sportswear on your website. Joe purchases a pair of running shoes in the amount of $100.00. At checkout, Joe uses a giftcard with a balance of $80.00 to pay. You request partial authorization of $100.00.
-
Submitting Credit Card Transactions Submitting Purchasing Card Transactions 6 Approval&AUTHCODE=11111&HOSTCODE=E&PROCAVS=U&TRANSTIME=2010-04-21 11:30:45&AMT=80.00&ORIGAMT=100.00&BALAMT=0&ACCT=1111&EXPDATE=0119&IAVS=X RESPMSG is Partial Approval, AMT is now the actual amount approved, ORIGAMT is the original requested amount, and BALAMT is the balance on the card. Since the amount charged is greater than the amount available on the card, the response sets the balance amount (BALAMT) to zero.
-
6 Submitting Credit Card Transactions Submitting Reference Transactions (Tokenization) reference transaction based on the original authorization and charge an additional $10 to Joe’s credit card without having to ask him again for credit card information. NOT E : As a security measure, reference transactions are disallowed by default. Only your account administrator can enable reference transactions for your account.
-
Submitting Credit Card Transactions Submitting Reference Transactions (Tokenization) BILLTOFIRSTNAME BILLTOZIP BILLTOMIDDLENAME BILLTOCOUNTRY BILLTOLASTNAME SWIPE 6 BILLTOSTREET Example Reference Transaction In this example, you authorize an amount of $100 for a shipment and charge $66 for the first partial shipment using a normal delayed capture.
-
6 Submitting Credit Card Transactions Submitting Reference Transactions (Tokenization) 3. Submit a new sale transaction or an authorization and delayed capture transaction of $34 for the rest of the shipment. When you ship the remainder of the product, you can collect the remaining $34 in a sale transaction that uses the initial authorization as a reference transaction. (This is a sale transaction, because Payflow allows only one delayed capture transaction per authorization.
-
Submitting Credit Card Transactions Submitting Sale Transactions 6 zero dollar authorization (TRXTYPE=A). For details, see “Submitting Account Verifications” on page 64. Submitting Sale Transactions The sale transaction (TRXTYPE=S) charges the specified amount against the account, and marks the transaction for immediate fund transfer during the next settlement period. PayPal submits each merchant's transactions for settlement on a daily basis.
-
6 Submitting Credit Card Transactions Submitting Soft Merchant Information TRXTYPE=S&TENDER=C&USER=SuperUser&PWD=SuperUserPassword&VENDOR=SuperUser&PA RTNER=PayPal&ACCT=5105105105105100&EXPDATE=1215&CVV2=123&AMT=99.00&BILLTOFI RSTNAME=John&BILLTOLASTNAME=Smith&BILLTOSTREET=123 Main St.
-
Submitting Credit Card Transactions Submitting Voice Authorization Transactions 6 Soft Merchant Information (SM Record) Soft merchant information is for American Express credit cards only.
-
6 Submitting Credit Card Transactions Submitting Void Transactions When To Use a Voice Authorization Transaction Some transactions cannot be authorized over the Internet (for example, high dollar amounts) and require manual authorization. These referral transactions generate RESULT value 13. In these situations, you contact the customer service department of your merchant bank and provide the payment information as requested.
-
Submitting Credit Card Transactions Submitting Void Transactions 6 When To Use a Void Transaction Use the following guidelines when using void transactions: You can void delayed capture, sale, credit, authorization, and voice authorization transactions. You cannot void a void transaction. You can only use a void transaction on a transaction that has not yet settled. To refund a customer's money for a settled transaction, submit a credit transaction.
-
6 Submitting Credit Card Transactions Using Address Verification Service Example Void Transaction Parameter String The following is an example void transaction string: TRXTYPE=V&TENDER=C&PARTNER=PayPal&VENDOR=SuperMerchant&USER=SuperMerchant&P WD=x1y2z3&ORIGID=VPNE12564395&VERBOSITY=HIGH Using Address Verification Service To qualify for the lowest bank rate, pass address verification service information, including the street address and zip (postal) code.
-
Submitting Credit Card Transactions Using Card Security Code 6 Using Card Security Code The card security code is a 3- or 4-digit number (not part of the credit card number) that is printed on the credit card. Because the card security code appears only on the card and not on receipts or statements, the code provides some assurance that the physical card is in the buyer's possession. This fraud prevention tool has various names, depending on the payment network.
-
6 Submitting Credit Card Transactions Information for the PayPal Acquirer Countries and Regions Supported by PayPal PayPal uses 2-character alpha 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 alpha ISO-3166-1 codes, refer to the PayPal API reference list of Countries and Regions.
-
7 Testing Transactions Before you activate your website or application for use by buyers, test your integration. A simulated payment network handles transactions, enabling you to verify the configuration and operation of your website or application. No money changes hands. Setting Up The Payflow Gateway Testing Environment Before testing transactions be sure you are linked to the test servers. Direct all transactions to the host URL for testing. See “Host URL Addresses” on page 52.
-
7 Testing Transactions Processors Other Than PayPal Diners Club 38520000023237 Discover 6011111111111117 Discover 6011000990139424 JCB 3530111333300000 JCB 3566002020360505 MasterCard 5555555555554444 MasterCard 5105105105105100 Visa 4111111111111111 Visa 4012888888881881 Visa 4222222222222 NOT E : Even though this number has a different character count than the other test numbers, it is the correct and functional number.
-
Testing Transactions Processors Other Than PayPal Processing Platform RESULT Values Available for Testing First Data Merchant Services North 0, 4, 5, 12, 13, 23, 24,114, 1000 First Data Merchant Services Nashville 0, 12, 13, 104 First Data Merchant Services South 0, 12, 13, 104 Global Payments Central 0, 4, 5, 8, 12, 13, 23, 24, 104, 111, 114, 1000 Global Payments East 0, 4, 5, 12, 13, 23, 24, 30, 100, 104, 114, 1000 Paymentech Salem (New Hampshire) 0, 12, 13, 104 Paymentech Tampa 0, 3, 4, 5
-
7 90 Testing Transactions Processors Other Than PayPal RESULT value Definition How to test using Payflow Gateway 19 Original transaction ID not found Submit a delayed capture transaction with an invalid ORIGID 22 Invalid ABA number Applies only to ACH transactions – submit an invalid ABA number (8 digits) 23 Invalid account number Submit an invalid account number, for example, 000000000000000 24 Invalid expiration date Submit an invalid expiration date, for example, 0298 25 Transaction ty
-
Testing Transactions Processors Other Than PayPal RESULT value Definition How to test using Payflow Gateway 114 CVV2 Mismatch Use the AMOUNT 1114.
-
7 Testing Transactions Processors Other Than PayPal Testing Card Security Code If you submit a value for the card security code, the cardholder’s bank returns a Yes / No / Not Supported (Y / N / X) response on whether the value matches the number on file at the bank. Card security code is described in “Card Security Code Validation”. NOT E : Some processors will decline (RESULT value 12) a transaction if the card security code does not match without returning a CVV2MATCH value.
-
Testing Transactions PayPal Processor 7 2. In the EXPDATE request parameter, pass one of the following expiration dates: Expiration date passedin EXPDATE request parameter Updated expiration date returnedin EXPDATE response parameter 0000 0919 1213 1218 0120 0150 0230 0250 0340 0350 3. In the AMT request parameter, pass an amount that falls within one of the following ranges to bring about different account updater test cases: Amount passedin AMT request parameter Test case 1000.
-
7 Testing Transactions PayPal Processor Discover 6011000990139424 JCB 3530111333300000 JCB 3566002020360505 MasterCard 5555555555554444 MasterCard 5105105105105100 Visa 4111111111111111 Visa 4012888888881881 Visa 4222222222222 NOT E : Even though this number has a different character count than the other test numbers, it is the correct and functional number. Result Values Based On Amount The following table shows another method for obtaining RESULT values.
-
Testing Transactions PayPal Processor Result Definition How to test 7 Field format error Use any of these as AMOUNT: 10405 10406 10407 10408 10409 10410 10412 10413 10416 10419 10420 10421 10509 10512 10513 10514 10515 10516 10517 10518 10540 10542 12 Declined Use any of these as AMOUNT: 10417 15002 15005 15006 15028 15039 10544 10545 10546 13 Referral Use the AMOUNT 10422 23 Invalid account number Use any of these as AMOUNT: 105
-
7 96 Testing Transactions PayPal Processor Result Definition How to test 24 Invalid expiration date Use any of these as AMOUNT: 10502 10508 30 Duplicate Transaction Use the AMOUNT 10536 105 Credit error Attempt to credit an authorization 112 Failed AVS check Use the AMOUNT 10505 114 CVV2 Mismatch Use the AMOUNT 10504 1000 Generic Host (Processor) Error Use an AMOUNT other than those listed in this column 07 January 2014 Gateway Developer Guide and Reference
-
8 Transaction Responses When a transaction finishes, the Payflow server returns a response string made up of namevalue pairs. The following is an example response string: RESULT=0&PNREF=EFHP0D426A53&RESPMSG=APPROVED&AUTHCODE=25TEST&AVSADDR=Y&AVSZ IP=N&CVV2MATCH=Y Credit Card Transaction Responses The table below describes values that can be returned in response strings. Field Description PNREF Gateway transaction ID, a unique number that identifies the transaction.
-
8 Transaction Responses Credit Card Transaction Responses Field Description RESPMSG The response message returned with the transaction result. Exact wording varies. Sometimes a colon appears after the initial RESPMSG followed by more detailed information. NOTE: For account verification transactions, RESULT=0 with RESPMSG=Verified means a zero dollar authorization has been successfully performed. NOTE: The PayPal processor may also return a warning message in the RESPMSG string when RESULT=0.
-
Transaction Responses Credit Card Transaction Responses Field Description HOSTCODE The raw response code returned by the processor. This field is not normalized and is returned when VERBOSITY is set to HIGH. Use RESPTEXT to obtain the response message from the processor. For PayPal processor response code information, refer to the PayPal API error codes. For all other processors, please contact your merchant bank or processor directly.
-
8 100 Transaction Responses Credit Card Transaction Responses Field Description AMT This field returns the transaction amount or if performing a partial authorization it will return the amount approved for the partial authorization. ORIGAMT Partial authorizations: Original amount submitted for authorization. CARDTYPE The credit card type. Is returned in an inquiry response when you send a VERBOSITY request parameter value of HIGH.
-
Transaction Responses Address Verification Service Responses From PayPal Field Description PAYMENTADVICECODE A processor response code typically returned on declined recurring transactions. Its purpose is to provide merchants with information and specific instructions on how to handle the decline. It is the merchant’s responsibility to follow the instructions provided in order to avoid chargebacks. For details on the meanings of these codes, see: https://merchant.paypal.
-
8 Transaction Responses Address Verification Service Responses From PayPal PayPal processor AVS code Meaning AVSADDR AVSZIP A Address Y N B International “A” Y N C International “N” N N D International “X” Y Y E Not allowed for MOTO (Internet/Phone) transactions X X F UK-specific “X” Y Y G Global Unavailable X X I International Unavailable X X N No N N P Postal (International “Z”) N Y R Retry X X S Service not Supported X X U Unavailable X X W Whole
-
Transaction Responses Card Security Code Results 8 Card Security Code Results Normalized Card Security Code Results The CVV2MATCH parameter returns Y, N, or X. The following table shows the detailed results that the PayPal processor returns for card security codes. To obtain the PayPal processor value, set the VERBOSITY parameter to HIGH. The processor value is returned in the PROCCVV2 response parameter.
-
8 Transaction Responses PNREF TRXTYPE=A&TENDER=C&PWD=x1y2z3&PARTNER=PayPal&VENDOR=SuperMerchant&USER=Supe rMerchant&ACCT=5555555555554444&EXPDATE=1215&AMT=123.00&BILLTOSTREET=5199 M APLE&BILLTOZIP=94588 Because the response returns a BALAMT of 99.00, the authorization is declined. RESULT=12&PNREF=VXYZ01234567&RESPMSG=DECLINED&BALANCE=99.
-
Transaction Responses RESULT Values and RESPMSG Text 8 The response message (RESPMSG) provides a brief description for decline or error results. To obtain the raw response code and message returned by the processor set VERBOSITY to HIGH in your request and capture the response values of the HOSTCODE and RESPTEXT parameters.
-
8 106 Transaction Responses RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 10 Too many line items 11 Client time-out waiting for response 12 Declined. Check the credit card number, expiration date, and transaction information to make sure they were entered correctly. If this does not resolve the problem, have the customer call their card issuing bank to resolve. 13 Referral. Transaction cannot be approved electronically but can be approved with a verbal authorization.
-
Transaction Responses RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 37 Invalid recurring profile ID 50 Insufficient funds available in account 51 Exceeds per transaction limit 52 Permission issue. Attempting to perform a transaction type, such as Sale or Authorization, that is not allowed for this account. 99 General error. See RESPMSG.
-
8 108 Transaction Responses RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 106 Host not available The Payflow transaction server was unable to communicate with the financial host. This error is an internal failure, and the transaction will not make it to the processor. 107 Duplicate suppression time-out 108 Void error. RESPMSG. Make sure the transaction ID entered has not already been voided.
-
Transaction Responses RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 126 Fraud Protection Services Filter — Flagged for review by filters N O TE : 8 RESULT value 126 indicates that a transaction triggered a fraud filter. This is not an error, but a notice that the transaction is in a review status. The transaction has been authorized but requires you to review and to manually accept the transaction before it will be allowed to settle.
-
8 110 Transaction Responses RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 1011 Buyer Authentication Service unavailable 1012 Buyer Authentication Service unavailable 1013 Buyer Authentication Service unavailable 1014 Buyer Authentication Service — Merchant is not enrolled for Buyer Authentication Service (3-D Secure) 1016 Buyer Authentication Service — 3-D Secure error response received.
-
Transaction Responses RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 1052 Buyer Authentication Service — Validate Authentication failed: This PARES was already validated for a previous Validate Authentication transaction 8 RESULT Values For Communications Errors A RESULT value less than zero indicates that a communication error occurred. In this case, no transaction is attempted.
-
8 Transaction Responses Processor-specific Response Parameters RESULT Description -23 Host address not specified -24 Invalid transaction type -25 Failed to create a socket -26 Failed to initialize socket layer -27 Parameter list format error: invalid [ ] name length clause -28 Parameter list format error: name -29 Failed to initialize SSL connection -30 Invalid timeout value -31 The certificate chain did not validate, no local certificate found -32 The certificate chain did not valida
-
Transaction Responses Processor-specific Response Parameters 8 Litle Response Parameters Merchants using the Litle processing platform may see the following transaction response parameters. Parameter Description TYPE Defines the type of account used in the transaction in terms of card association, card company, Bill Me Later, PayPal, or eCheck. AFFLUENT Has two possible values: MASS AFFLUENTReturned for certain Visa and MasterCard cards indicating high income customers (>100K annual income).
-
8 Transaction Responses Processor-specific Response Parameters As a result, merchants utilizing this feature should check for the presence of the CCUPDATED=Y response parameter, and if it is returned should also check for the presence of the ACCT and EXPDATE response parameters to determine what information has been updated. If you would like to test your integration for this feature, see “Testing the Litle Automatic Account Updater Feature” on page 92.
-
A Processors Requiring Additional Transaction Parameters Additional parameters are those required by individual processors beyond the core parameters. Parameters are organized alphabetically by processor.
-
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.
-
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: 30 characters BILLTOZIP (Optional) Account holder’s 5- to 9-digit ZIP (postal) code excluding spaces, dashes, and non-numeric characters.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
Processors Requiring Additional Transaction Parameters Cielo Payments, Additional Credit Card Parameters A Cielo Payments, Additional Credit Card Parameters In addition to the core credit card parameters, Cielo Payments (formerly Merchant eSolutions) accepts the parameters described below. Field Description INVNUM (Optional) Merchant invoice number.
-
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.
-
Processors Requiring Additional Transaction Parameters Paymentech Salem (New Hampshire) Additional Credit Card Parameters for American Express 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. The Payflow API accepts 3-digit numeric country codes. Refer to: http://en.wikipedia.org/wiki/ISO_3166-1_numeric.
-
A Processors Requiring Additional Transaction Parameters PayPal Credit Card Transaction Request Parameters PayPal Credit Card Transaction Request Parameters In addition to the core credit card parameters, PayPal accepts the parameters described below. Parameter Description AMT (Required) Amount (US Dollars) U.S. based currency.
-
Processors Requiring Additional Transaction Parameters PayPal Credit Card Transaction Request Parameters Parameter Description 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 : A If CAPTURECOMPLETE is Y, any remaining amount of the original reauthorized transaction is automatically voided. Limitations: 12-character alphanumeric string. CUSTOM (Optional) A free-form field for your own use.
-
A Processors Requiring Additional Transaction Parameters PayPal Credit Card Transaction Request Parameters Parameter Description 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 characters plus decimal (.) character. No currency symbol. Specify the exact amount to the cent using a decimal point—use 34.
-
Processors Requiring Additional Transaction Parameters PayPal Credit Card Transaction Request Parameters Parameter Description L_SKUn (Optional) Product number. N O TE : A To enable line-item support, send an email from the Primary email address on the account to payflow-support@paypal.com Limitations: 18-characters. L_TAXAMTn (Optional) Line-item tax amount. N O TE : To enable line-item support, send an email from the Primary email address on the account to payflow-support@paypal.
-
A Processors Requiring Additional Transaction Parameters PayPal Credit Card Transaction Request Parameters Parameter Description BILLTOCOUNTRY (Conditional) Bill-to country address. For the PayPal acquirer, refer to PayPal's country codes: https://developer.paypal.com/webapps/developer/docs/classic/api/country_codes/. N O TE : Some merchants maybe required to pass this billing information. Please test your integration first to determine if the billing information fields are required.
-
Processors Requiring Additional Transaction Parameters SecureNet Additional Credit Card Parameters for American Express A 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.
-
A Processors Requiring Additional Transaction Parameters SecureNet Additional Credit Card Parameters for American Express Field Description SHIPTOCOUNTRY (Optional) Numeric country code of ship-to country. Example: USA: 840. The Payflow API accepts 3-digit numeric country codes. Refer to: http://en.wikipedia.org/wiki/ISO_3166-1_numeric. Character length and limitations: 3 alphanumeric characters SHIPMETHOD (Optional) Shipping method code.
-
Processors Requiring Additional Transaction Parameters SecureNet Additional Credit Card Parameters for American Express Field Description SHIPTOPHONENUM (Optional) Shipping telephone number. Character length and limitations: 10 alphanumeric characters A Location Transaction Advice Addendum Parameters Parameter Description MERCHANTNAME (Optional) Name of merchant.
-
A Processors Requiring Additional Transaction Parameters SecureNet Additional Credit Card Parameters for American Express 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.
-
Processors Requiring Additional Transaction Parameters SecureNet Additional Credit Card Parameters for American Express Field Description 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 A If not provided, this value is equal to the number of AIR-ROUTINGCITYn parameters.
-
A Processors Requiring Additional Transaction Parameters Vantiv Additional Credit Card Parameters 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.
-
Processors Requiring Additional Transaction Parameters Vantiv 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.
-
A Processors Requiring Additional Transaction Parameters WorldPay Additional Credit Card Parameters WorldPay Additional Credit Card Parameters 140 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.
-
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.
-
B TeleCheck Electronic Check Processing TeleCheck NFTF Processing Overview 142 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.
-
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.
-
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 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.
-
B TeleCheck Electronic Check Processing TeleCheck Parameters Field Description BILLTOLASTNAME (Required) Account holder’s last name as it appears on the check. Character length and limitations: 30 alphanumeric characters 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.
-
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).
-
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 149 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.
-
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.
-
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.
-
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
-
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.
-
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.
-
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.
-
C Payflow Header Parameters This section includes information on the Payflow header parameters. These header parameters can be used to bypass Payflow to send a request message directly to PayPal. They can also be used to post transactions to the Payflow servers directly without installing an SDK.
-
C Payflow Header Parameters Posting Transactions Directly Without the Payflow SDK Posting Transactions Directly Without the Payflow SDK The Payflow SDK is recommended for .NET and Java users, to simplify the Payflow integration. Developers who prefer to write code in other programming languages can go to the PayPal Labs integration wizard web site (https://devtools-paypal.com/integrationwizard/.). The wizard generates customizable code samples in languages such as PHP.
-
Payflow Header Parameters Posting Transactions Directly Without the Payflow SDK C Payflow Message Protocol Headers In addition to the Payflow parameters that you pass in your request, you must set the request headers described in the following table. Required Payflow Headers Header Name Description X-VPS-REQUEST-ID (Required) A unique identifier for each request, whether the request is a single name-value transaction or an XMLPay 2.0 document with multiple transactions.
-
C Payflow Header Parameters Posting Transactions Directly Without the Payflow SDK Header Name Description X-VPS-CLIENT-TIMEOUT (Required) Time-out value in seconds. A transaction times out if the elapsed time between ending the original transaction request and receiving the transaction response exceeds the value of X-VPS-CLIENT-TIMEOUT. The default value is 45. Standard HTTP Headers Required Header Name Description Connection State of the connection.
-
Payflow Header Parameters Posting Transactions Directly Without the Payflow SDK C Host: payflowpro.verisign.com X-VPS-REQUEST-ID: [See Required Payflow Headers] X-VPS-CLIENT-TIMEOUT: 45 X-VPS-VIT-[See Integrator-Provided Data] X-VPS-VIT-[See Integrator-Provided Data] The following is an example of a transaction request header associated with a message in name-value format.
-
C Payflow Header Parameters Posting Transactions Directly Without the Payflow SDK Content-Length: 145 X-VPS-REQUEST-ID: [Same ID as sent] Name-Value Pair Transaction Response Body The transaction response body contains the response to the request. The following is an example response body in name-value format.
-
Payflow Header Parameters Posting Transactions Directly Without the Payflow SDK Header Name Description X-VPS-VIT-RUNTIME-VERSION Version of runtime environment of the language in which the client is written and is running. Format: String XXX.XE Examples: 10.1, 2.5 Default Value: Blank C For more information on Payflow headers, see this Merchant Technical Support (MTS) knowledge base article.
-
C 162 Payflow Header Parameters Posting Transactions Directly Without the Payflow SDK 07 January 2014 Gateway Developer Guide and Reference
-
D Submitting Purchasing Card Level 2 and 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions About American Express Purchasing Card Transactions D Avoiding Downgrade If a transaction uses the purchasing card BIN range (see “Accepted BIN Ranges” on page 166) 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).
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions American Express Purchasing Card Transaction Processing D 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions American Express Purchasing Card Transaction Processing Field Description SHIPTOZIP (Required) Ship-to postal code (called zip code in the USA).
-
Submitting Purchasing Card Level 2 and 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions First Data Merchant Services (FDMS) Nashville Purchasing Card Transaction Processing D 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.
-
D Submitting Purchasing Card Level 2 and 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).
-
Submitting Purchasing Card Level 2 and 3 Transactions First Data Merchant Services South (FDMS) Purchasing Card Transaction Processing D 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions First Data Merchant Services South (FDMS) Purchasing Card Transaction Processing FDMS South Level 2 and Level 3 Purchasing Card Parameters 176 Field Description BILLTOCITY (Optional) Cardholder’s city. Character length and limitations: 13 alpha characters SHIPTOCOUNTRY (Optional) Destination Country Code. The Payflow API accepts 3-digit numeric country codes. Refer to the appendix at the end of this guide for FDMS South country codes.
-
Submitting Purchasing Card Level 2 and 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions Global Payments - Central Purchasing Card Transaction Processing D 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 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.
-
D 188 Submitting Purchasing Card Level 2 and 3 Transactions Litle 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions Cielo Payments Purchasing Card Transaction Processing D Cielo Payments Purchasing Card Transaction Processing Cielo Payments Level 2 Parameters Cielo Payments (formerly Merchant e-Solutions) supports MasterCard and Visa for Level 2 processing. Cielo Payments indicates in the authorization response whether the credit card in the transaction is a commercial card.
-
D Submitting Purchasing Card Level 2 and 3 Transactions Cielo Payments Purchasing Card Transaction Processing IM PORT AN T : The values required for Level 3 status vary by bank, so contact your bank for details. Cielo Payments 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions Cielo Payments Purchasing Card Transaction Processing Parameter Description ALTTAXAMT (Optional) Alternate tax amount. Character length and limitations: 9 numeric characters D Cielo Payments 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions Cielo Payments Purchasing Card Transaction Processing Cielo Payments Level 3 Visa Parameters For Cielo Payments (formerly Merchant e-Solutions), 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions Cielo Payments Purchasing Card Transaction Processing Parameter Description 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing D 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 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 : D 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.
-
D Submitting Purchasing Card Level 2 and 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing D . 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions Paymentech Salem (New Hampshire) Purchasing Card Transaction Processing Parameter Description L_TAXRATEn (Optional) Tax rate. Character length and limitations: 4 numeric characters . 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions Paymentech Tampa Level 2 Purchasing Card Transaction Processing D Paymentech Tampa Level 2 Purchasing Card Transaction Processing Paymentech Tampa supports Level 2 purchasing card processing for MasterCard and Visa. 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions Paymentech Tampa Level 2 Purchasing Card Transaction Processing Paymentech Tampa Level 3 Parameters 202 Description FREIGHTAMT (Required) Total shipping costs for this order. Character length and limitations: 9 numeric characters plus a decimal point. 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions Paymentech Tampa Level 2 Purchasing Card Transaction Processing Paymentech Tampa Level 3 Parameters D Description L_COST1 (Required) Unit price. (n is a line item number from 1 to 6.) Character length and limitations: 9 numeric characters plus a decimal point. 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions SecureNet Purchasing Card Transaction Processing 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions SecureNet Purchasing Card Transaction Processing D SecureNet Level 2 MasterCard Parameters Required for Level 3 Line Item Transactions 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).
-
D Submitting Purchasing Card Level 2 and 3 Transactions SecureNet Purchasing Card Transaction Processing 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions SecureNet Purchasing Card Transaction Processing D SecureNet Level 2 Visa Parameters for Level 3 Line Item Transactions 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions SecureNet Purchasing Card Transaction Processing Parameter Description 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).
-
Submitting Purchasing Card Level 2 and 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing D 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing D TSYS Acquiring Solutions Level 3 Required Parameters The parameters listed in the table below apply to Level 3 transactions as extended data. Parameter Description COMMCODE (Required) Commodity code identifier for the business. Character length and limitations: 4 alphanumeric characters SHIPTOZIP (Required) The zip code of the address to which the goods are shipped.
-
D Submitting Purchasing Card Level 2 and 3 Transactions TSYS Acquiring Solutions 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing D TSYS Acquiring Solutions Level 2 Visa Parameters for Level 3 Line Item Transactions 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).
-
D Submitting Purchasing Card Level 2 and 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing 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 DISCOUNT (Optional) Discount amount. Character length and limitations: 12 numeric characters FREIGHTAMT (Optional) Freight amount.
-
Submitting Purchasing Card Level 2 and 3 Transactions Vantiv Purchasing Card Transaction Processing Parameter Description 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.
-
D Submitting Purchasing Card Level 2 and 3 Transactions Vantiv Purchasing Card Transaction Processing Field Description 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).
-
Submitting Purchasing Card Level 2 and 3 Transactions WorldPay Purchasing Cards Transaction Processing Field Description 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.
-
D 218 Submitting Purchasing Card Level 2 and 3 Transactions WorldPay Purchasing Cards Transaction Processing Level 2 Parameters Description 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.
-
Submitting Purchasing Card Level 2 and 3 Transactions WorldPay Purchasing Cards Transaction Processing Level 2 Parameters Description 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.
-
D 220 Submitting Purchasing Card Level 2 and 3 Transactions WorldPay Purchasing Cards Transaction Processing Level 3 Parameters Description 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.
-
E VERBOSITY: Processor-Specific 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.
-
E 222 VERBOSITY: Processor-Specific Transaction Results 07 January 2014 Gateway Developer Guide and Reference
-
F Country Codes The Payflow 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 3-digit numeric country codes, refer to: http://en.wikipedia.org/wiki/ISO_3166-1_numeric IM PORT AN T : NOT E : If PayPal is your acquirer, refer instead to the “Countries and Regions Supported by PayPal” on page 86.
-
F 224 Country Codes 07 January 2014 Gateway Developer Guide and Reference
-
G Codes Used by FDMS South Only The following codes are used by FDMS South only.
-
G 226 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.
-
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
-
G 228 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
-
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 NIG
-
G 230 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.
-
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.
-
G 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 232 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 07 January 2014 Gate
-
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.
-
G 234 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
-
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 JAMA
-
G 236 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
-
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 SIER
-
G 238 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.
-
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 G 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 B
-
G 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.
-
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 k
-
G 242 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 anhydr
-
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
-
G 244 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 p
-
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 Squa
-
G 246 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 07 January 2014 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.
-
Additional Processor Information Moneris Solutions 248 07 January 2014 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.
-
I 250 Payflow Link Migration Migrating from a legacy Payflow Link Integration Payflow Link Legacy Parameter Payflow Parameter EMAILTOSHIP SHIPTOEMAIL FAX BILLTOFAX FAXTOSHIP SHIPTOFAX FIRSTNAME BILLTOFIRSTNAME INVOICE INVNUM LASTNAME BILLTOLASTNAME LOGIN VENDOR METHOD TENDER NAME BILLTOFIRSTNAME BILLTOLASTNAME NAMETOSHIP SHIPTOFIRSTNAME SHIPTOLASTNAME PHONE BILLTOPHONENUM PHONETOSHIP SHIPTOPHONENUM SHIPAMOUNT FREIGHTAMT STATE BILLTOSTATE STATETOSHIP SHIPTOSTATE TAX TAXAMT
-
J Payflow Gateway MagTek Parameters MagTek products for both merchants and consumers provide added security to payment transactions. For merchants, MagTek's MagneSafe card readers encrypt payment card data when the card is swiped. For consumers, MagTek has a subscription based service named Qwick Codes. Consumers can use Qwick Codes instead of their payment card details to purchase goods and services.
-
J Payflow Gateway MagTek Parameters Passing Encrypted Card Swipe Data and Qwick Codes to the Payflow Gateway USB MSR: Dynamag. Insert MSR for Kiosks, ATMs, etc.: MagneSafe I-65 for Chip Cards and MagStripe, PSeries MagneSafe for outdoors, Slim Seal MagneSafe. Mobile Readers: iDynamo for iOS, Bullet for Android, uDynamo for phones and tablets with audio jack port. PINPads: IPAD PINPad available as standard model and also with signature capture support. For more information, go to: http://www.
-
Payflow Gateway MagTek Parameters Passing Encrypted Card Swipe Data and Qwick Codes to the Payflow Gateway Delayed Capture (TRXTYPE=D) Sale (TRXTYPE=S) Void (TRXTYPE=V) J Encrypted Card Swipe Payflow Example The purpose of this example is to show you how to format a request.You cannot use the values in this example for testing. You must have a MagneSafe card reader and test credit cards or live credit cards to send a request to the Payflow Gateway.
-
J Payflow Gateway MagTek Parameters Parameters for Encrypted Card Swipe Transactions TRXTYPE=A&TENDER=C&VENDOR=MerchantUserID&PARTNER=PayPal&USER=UserIDI fAvailOrSameAsVendor&PWD=Pwd4Gateway&VERBOSITY=HIGH&AMT=18&SWIPEDECR HOST=MAGT&PCODE=23456789&MERCHANTID=MerchantID123&MERCHANTNAME=Merch antName&PAN4=1234&BILLTOLASTNAME=Miller&MAGTEKUSERNAME=MagTekUserNam e&MAGTEKPWD=MagTekPwd&BILLTOEMAIL=jmiller@anyemailprovider.
-
Payflow Gateway MagTek Parameters Parameters for Encrypted Card Swipe Transactions Field Required Description Data Type Length ENCRYPTIONBLOCK TYPE Required The code which indicates what type of Encryption Block is used. 1=MagneSafe V4/V5 compatible 2TDEA-CBC Encryption, IV=0 Block contains data only.2=iPad V1 compatible 2TDEACBC Encryption Block contains header + data. Integer 1 ENCTRACK2 Required Encrypted Track 2 information returned by a MagneSafe device when a card is swiped.
-
J Payflow Gateway MagTek Parameters Parameters for Encrypted Card Swipe Transactions Field Required Description Data Type SWIPEDECRHOST Required MAGT is the only value that is accepted in the SWIPEDECRHOST parameter. If you pass a different value you will see RESULT=7 and MAGTRESPONSE with an error message in the response. DEVICESN Optional The device serial number. String ENCTRACK1 Optional Encrypted Track 1 information returned by a MagneSafe device when a card is swiped.
-
Payflow Gateway MagTek Parameters Parameters for MagTek Qwick Code (PCode) Transactions J Parameters for MagTek Qwick Code (PCode) Transactions Qwick Code (PCode) Transactions - Request Parameters Field Required Description Data Type Length MERCHANTID Required Your Merchant ID or the Merchant ID of the merchant redeeming the Protection Code. String 1 to 40 characters PAN4 Required The last 4 digits of the PAN / account number encoded in the card.
-
J Payflow Gateway MagTek Parameters MagTek Error Codes and Messages Qwick Code (PCode) Transactions - Response Parameters Field Description Data Type Notes MAGTRESPONSE This only appears in the response if a data validation error occurs or if the MagTek processor throws an error. String See the error codes below for more information. MagTek Error Codes and Messages If an error occurs, you will see one of the following error codes in the MAGTRESPONSE response parameter.
-
Payflow Gateway MagTek Parameters MagTek Error Codes and Messages J Encrypted Card Swipe Transactions - Other Error Codes Error Message Notes Y001 - No PAN Found in Track2 Data Y003 - Device is not allowed MagTek maintains a list of registered Devices. Y093 - Invalid MagnePrint Error obtained while Scoring Transaction MagnePrint against a Reference MagnePrint made up of Zeros.
-
J Payflow Gateway MagTek Parameters MagTek Error Codes and Messages Error Message Notes H381 - Invalid AUTHVALUE2 H382 - Invalid AUTHVALUE3 H383 - Invalid MERCHANTNAME H384 - Invalid USERNAME Invalid MAGTEKUSERNAME H385 - Invalid PASSWORD Invalid MAGTEKPWD Qwick Code (PCode) Transactions - Other Error Codes Error Message Notes P021 - Invalid Protection Code - Not Found. P022 - Revoked Protection Code. This Protection Code has already been revoked. P028 - Expired Protection Code.
-
K Payflow Gateway FAQs Frequently Asked Questions How do I determine the version of the Payflow Gateway SDK I have? See this Merchant Technical Support (MTS) knowledge base article to determine your Payflow SDK version. How do I contact Payflow Support? Go to https://manager.paypal.com/jsp/common/contactUs.jsp for the Payflow Support phone number for your region.
