Payflow Gateway Developer Guide Revision History

Revision History for the Payflow Gateway Developer Guide and Reference:

21 October 2019

  • Added Card on File (Stored Credentials) section.
  • Added information about Online Refunds to the Submit Credit Transaction section.
  • Elavon: Removed COMMCARD and fixed length of PONUM.
  • Chase Paymentech: Added HSA/FSA test cards.
  • Added new section called 3D Secure and added 3rd-Party Merchant Plug-ins.
  • TeleCheck: Fixed examples to include CHKTYPE as it is a required parameter.
  • Removed references to SecureNet, Global Payments Central, American Express APAC, CitiBank Singapore and Planet Payment as these processors are no longer available.
  • Changed Global Payments East to Global Payments.
  • Changed Cielo Payments back to Merchant e-Solutions.

18 September 2019

  • Reorganized the guide into separate topics rather than a single HTML page for easier navigation and maintenance.

18 May 2017

  • The update on 26 October 2016 added additional MasterCard test credit card numbers to the credit card numbers for testing section. Merchants are required to update their websites to accept the new MasterCard BIN ranges of 222100 to 272099. Please see MasterCard for more information on the new range.

26 Apr 2017

27 Feb 2017

26 Oct 2016

Note: See the 18 May 2017 update for additional information on required changes for supporting new MasterCard BINs.

10 Dec 2015

10 Nov 2015

  • Corrected the names of the following parameters in the guide: VATAXAMT and VATAXPERCENT. Also, noted that the following fields should not contain more than two decimal places: ADDLAMTn, ALTTAXAMT, ALTERNATETAXAMT, LOCALTAXAMT, NATIONALTAXAMT and VATAXAMT.

15 Jun 2015

  • Noted that MODE parameter is now deprecated.

23 Apr 2015

05 Apr 2015

  • Clarified the format and uses of the PNREF response parameter.

30 Dec 2014

  • Corrected the merchant soft descriptor fields supported by the PayPal processor. Use the MERCHDESCR and MERCHANTCITY fields to pass merchant name and contact information for sale and authorization transactions. This information is displayed on the account holder's statement. See the PayPal Credit Card Transaction Request Parameters section for details.

10 Dec 2014

20 Nov 2014

5 Nov 2014

15 Oct 2014

  • Clarified that the Payflow Gateway does not charge any fees for account verifications (zero amount authorizations); however, the merchant's processor, including PayPal as a merchant bank, may charge a fee for account verifications. For information on whether transaction fees are charged for the various Payflow credit card transaction types, see Credit Card Features.

19 Sep 2014

7 Aug 2014

17 June 2014

06 Mar 2014

  • Expanded support for the HOSTCODE and EXTRSPMSG response fields for the WorldPay processor. (HOSTCODE and EXTRSPMSG return the processor's error code and message respectively.)

28 Feb 2014

  • Added the Planet Payment processor, which supports Multi-Currency Pricing (MCP).
  • Added a new transaction type, supported by Planet Payment only, for currency conversion rate lookups. See Submit Rate Lookups.

18 Feb 2014

07 Jan 2014

21 Nov 2013

08 Nov 2013

31 Oct 2013

20 Sep 2013

19 Jul 2013

  • Removed the ACCTTYPE parameter from this guide.

11 Jul 2013

15 Jun 2013

25 Apr 2013

22 Feb 2013

28 Jan 2013

28 Dec 2012

11 Dec 2012

04 Oct 2012

29 Aug 2012

31 July 2012

23 July 2012

16 July 2012

June 2012

  • Added the Who Should Use This Document section to the Preface.
  • In the Integrating the Secure Token Without the Hosted Checkout Pages: Transparent Redirect section, corrected the value of SILENTTRAN to True.
  • Added the Silent Posts section to the Hosted Checkout Pages chapter.
  • Removed the legacy parameter CORPCOUNTRY from Country Codes.

May 2012

  • Added new sections to the Testing Transactions chapter: Testing Address Verification ServiceTesting Card Security Code
  • Added PayPal Acquirer chapter: Contains links to PayPal API Ref country and currency codes

April 2012

  • Added new transaction type: Balance Inquiry(TRXTYPE=B) can be used to obtain the balance of a pre-paid card.
  • Updated TeleCheck chapter: Updated MICR values in Testing TeleCheck Transactions section
  • Added TeleCheck Adjustment Response Code Values table
  • Updated parameters and examples: Added a description for 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.
  • Updated the examples and removed legacy parameters to include: FIRSTNAME, LASTNAME, STREET, CITY, STATE, ZIP, COUNTRY.
  • Updated processor and entity names: Vantiv, previously known as Fifth Third Processing Solutions
  • PayPal Australia, previously known as First Data Australia

January 2012

Added new processors

  • First Third International
  • Heartland Payment Systems
  • Planet Payment
  • SecureNet
  • TeleCheck
  • WorldPay

Added new transaction types

  • TRXTYPE=L can be used to upload credit card data, easing PCI compliance. You can store the resulting PNREF locally for use in performing reference transactions.

Added request parameters

  • ADDLAMTn
  • ADDLAMTTYPEn
  • AUTHDATE
  • CATTYPE
  • CONTACTLESS
  • CUSTDATA
  • CUSTOMERID
  • CUSTOMERNUMBER
  • DISCOUNT
  • DUTYAMT
  • DLNAME
  • DLNUM
  • DOB
  • L_ALTTAXAMTn
  • L_ALTTAXIDn
  • L_ALTTAXRATEn
  • L_CARRIERSERVICELEVELCODEn
  • L_COMMCODEn
  • L_EXTAMTn
  • L_PRODCODEn
  • L_TAXTYPEn
  • ORDERID
  • MERCHANTDESCR
  • MERCHANTINVNUM
  • MERCHANTNAME
  • MERCHANTURL
  • MERCHANTVATNUM
  • MERCHANTZIP
  • MISCDATA
  • REPORTGROUP
  • SILENTTRAN
  • STREET3
  • VATINVNUM
  • VATAXAMT
  • VATAXRATE

Added response parameters

  • DUPLICATE (response)
  • EXTRMSG (response)

Added concepts

  • Gateway Product Solutions: PayPal Payments Advanced, PayPal Payments Pro, Payflow Pro, Payflow Link
  • Transaction Flow
  • Transparent Redirect

February 2011

  • First publication.