Home

PayPal Payflow Pro - 2009 Developer's Guide

1. SHIPTOFIRSTNAME First name in the shipping address No Alpha 30 numeric SHIPTOLASTNAME Last name in the shipping address No Alpha 30 numeric SHIPTOSTREET Shipping street address No Alpha 30 numeric SHIPTOCOUNTRY Numeric country code No Alpha 3 Example numeric USA 840 SHIPTOZIP Shipping 5 to 9 digit ZIP postal code excluding No Alpha 9 spaces dashes and non numeric characters numeric Example 951121737 SHIPTOPHONENUM Shipping telephone number No String 10 RECURRING Identifies the transaction as recurring This value No Alpha 1 does not activate the PayPal Recurring Billing numeric Service API YorN If the RECURRING parameter was set to Y for the original transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s Fraud Protection Services To avoid charging you to filter recurring transactions that you know are reliable the fraud filters do not screen recurring transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Virtual Terminal The filters screen the transaction in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results Payflow Pro Developer s Guide 81 Processors Requiring Additional Transaction Parameters Paymentech Paymentech Additional Credit Card Parameters Legacy In
2. Pay Flow SDK parameter INVNUM Defaults to PNREF if not present AUTHCODE Passed transparently for delayed capture Use only with voice authorized force capture transactions REQNAME PONUM SHIPTOZIP Ship to postal code called zip code in the USA This field must contain one of the following values e Zip code of the destination where the merchandise is to be shipped e If the above is not available Zip code of the location where the merchant executed the transaction INVOICEDATE Defaults to Transaction Date if not present XMLPayRequest parameter See Payflow Pro XMLPay Developer s Guide for detailed instructions Invoice InvNum ForceCapture Authcode ExtData REQNAME BillTo PONum ShipTo Address ZIP Invoice Date Format min max type 1 9 AN 1 40 AN 1 17 AN 5 6 AN YYYYMM DD string Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions American Express Phoenix Purchasing Card Transaction Processing TABLE C 4 American Express Phoenix Level 3 Parameters Continued gt AMEX Name o XMLPayRequest parameter per American 5 See Payflow Pro XMLPay Format Express 2 Developer s Guide for min max Specification Pay Flow SDK parameter detailed instructions type Total Transaction M AMT Invoice TotalAmt 1 8 NUM Amount The
3. LASTNAME INVNUM ORDERDATE Description Describes the transaction Describes the transaction Describes the transaction Describes the transaction Describes the transaction Account holder s first and last name Note 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 Account holder s last name 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 Specifies an order date For example July 28 2003 is 072803 Format mmddyy with no slashes or dashes Required Type No Alpha numeric No Alpha numeric No Alpha numeric No Alpha numeric No Alpha numeric No Alpha numeric No Alpha numeric No Alpha numeric No Numeric Length Brighton 40 Other American Express platforms 23 40 40 40 40 13 13 74 Payflow Pro Developer s Guide TABLE A 2 American Express legacy parameters Continued Processors Requiring Additional Transaction Parameters American Express Parameter ORDERDATET IME eJ ECURRING Description Re
4. 117 Merchant e Solutions Level 3 Visa 119 Elavon Formerly Nova Purchasing Card Transaction 0 123 Elavon Level 2 123 Elavon Additional 123 Example Elavon Level 2 Transaction Parameter String 124 Paymentech Salem New Hampshire Purchasing Card Transaction Processing 124 Paymentech Salem New Hampshire Level 2 Parameters CAPN 124 Paymentech Salem New Hampshire Level 2 Parameters Legacy 126 Paymentech Salem New Hampshire Level Purchasing Card Parameters 127 Paymentech Tampa Level 2 Purchasing Card Transaction Processing 130 Paymentech Tampa Level 2 Parameters 131 Example Paymentech Tampa Level 2 Visa and MasterCard Transaction Parameter String 2222 lll es 131 TSYS Acquiring Solutions Purchasing Card Transaction Processing 131 Payflow Pro Developer s Guide Contents TSYS Acquiring Solutions Level 2 Parameters 131 TSYS Acquiring Solutions Level MasterCard Parameters 132 TSYS Acquiring Solutions Level Visa 134 Appendix D VERBOSITY Viewing Processor sapere Transaction Results E 403 5 x x ko x 139 Supported Verbosity Setting
5. Paymentech MasterCard Mandatory Format data item Optional Payflow Parameter min max type Order Freight Amt M FREIGHTAMT NUM Duty Amt M DUTYAMT NUM Destination ZIP M SHIPTOZIP Destination Country M SHIPTOCOUNTRY Ship from ZIP M SHIPPEDFROMZIP Discount Amount M DISCOUNT NUM Alternate Tax ID M ALTERNATETAXID Alternate Tax Amt M ALTERNATETAXAMT NUM Line Item Record 1 Description M DESCn Product Code L_PRODCODEn Quantity M L NUM Unit of measure M L UOMn Tax Amt NUM Tax Rate TAXPERCENTAGEn Line Item Record 2 Line item Total L_AMTn NUM Discount Amt O L_DISCOUNTn NUM Tax Type Applied L_TAXTYPEn 128 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions Paymentech Salem New Hampshire Purchasing Card Transaction Processing Paymentech Salem New Hampshire Level 3 Visa Parameters Level 3 transactions should include at least one line item TABLE C 25 Paymentech Salem New Hampshire Level 3 Visa order and line item parameters Paymentech Visa data Mandatory Format item Optional Payflow Parameter min max type Order Freight Amt M FREIGHTAMT NUM Duty Amt M DUTYAMT NUM Destination ZIP M SHIPTOZIP Destination Country M SHIPTOCOUNTRY Ship from ZIP M SHIPPEDFROMZIP Discount Amount M DISCOUNT NUM VAT Tax Amt M TAXAMT NUM VAT Tax Rate M AXPERCENTAGE Line
6. 49 Testing 5 49 Credit Card Numbers Used for Testing 49 Result Values 50 Testing Result Values 50 RESULT Values Returned Based on Transaction 50 Alternative Methods for Generating Specific RESULT Values 51 Testing Address Verification Service 53 Testing Card Security 53 Chapter 6 Responses to Transaction Requests 55 Contents of a Response to a Credit Card Transaction Request 55 BALAMT Response Parameter and Stored Value Cards 57 American Express CAPN Stored Value Card Example 57 PNREF Val e 2 su a8 om ES a Sox ee a Y a 57 PNREF Format nues 3e x Rum mede deg om ee AD 58 RESULT Values and RESPMSG 58 RESULT Values for Transaction Declines 58 RESULT Values for Communications Errors 64 Appendix A Processors Requiring Additional Transaction Parameters 67 Payflow Pro Developer s Guide 5 Contents American Express sss s sacre rew raa XR OX ee ee REOR REOR ee 67 American Express Additional Credit Card Parame
7. Merchant e Solutions Purchasing Card Transaction Processing Merchant e Solutions Level 2 Parameters Merchant e Solutions supports MasterCard and Visa for Level 2 processing Merchant e Solutions indicates in the authorization response whether or not the credit card in the transaction is a commercial card Based in the commercial card indicator PayPal will format the Level 2 information in the settlement request 116 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions Merchant e Solutions Purchasing Card Transaction Processing Merchant e Solutions Level 2 Transaction Data Level 2 values marked as mandatory in Table C 12 are required to get the discount rate TABLE C 12 Merchant e Solutions Level 2 parameters The value must include a decimal and the exact amount to the cent 42 00 not 42 Do not include comma separators Merchant e Solutions Mandatory Name Optional Payflow Parameter Cust Ref ID M PONUM Tax Amount M TAXAMT 1234 56 not 1 234 56 Tax Amount TAXEXEMPT Y or N Identifier Format min max type 1 17 AN NUM 1A Example Merchant e Solutions Level 2 Visa Transaction Parameter String RXTYPE S amp ACC Testing amp Name amp PARTN E CardHolder E CA amp STRI EET 123 Main St amp TAXAl T 1 01 amp TAX PT N amp TI END ER C amp US ER
8. TABLE 2 values for testing E CA amp ZIP 95050 MICR 1234567804390850001001 1234567804390850011001 1234567804390850021001 1234567804390850031001 1234567804390850041001 1234567804390850051001 1234567804390850071001 HOSTCODE _ TeleCheck Result 000800 Check Approved ECA 000801 Check Approved No ECA 000802 Check Approved ECA No Guarantee 000803 Check Approved No ECA No Guarantee 000804 Check Decline Negative Data 000805 Check Decline Scoring 000807 Check Failed Preparing for TeleCheck Production Transactions Before going into production with your check integration you must certify your storefront with TeleCheck To begin the certification process send an e mail to ica certification 9 telecheck com Be sure to include the following information e Your test website address where test transactions can be processed e The name e mail address and phone number of the person to contact about any needed corrections The certification process usually takes 2 3 days Use the host address of the live server described in Host Addresses on page 13 Responses to Telecheck Transactions When a transaction finishes PayPal returns a response string made up of name value pairs For example 94 RESULT 0 amp PNREF VXYZ01234567 amp HOSTCODE 000500 amp RESPMSG Approved Payflow Pro Developer s Guide Performing TeleCheck Electronic Check Transactions HOSTCODE Values Tele
9. Codes Used FDMS South Only Visa Country Codes TABLE G 2 Visa country codes TABLE G 2 Visa country codes BHUTAN BT CZECH REPUBLIC CZ BOLIVIA BO DENMARK DK BOSNIA AND HERZIGOVINA BA DJIBOUTI DJ BOTSWANA BW DOMINICA DM BOUVET ISLAND BV DOMINICAN REPUBLIC DO BRAZIL BR EAST TIMOR TP BRITISH INDIAN OCEAN IO ECUADOR EC TERRITORY EGYPT EG BRUNEI BN EL SALVADOR SV BULGARIA BG EQUATORIAL GUINEA GQ BURKINA FASO BF ERITREA ER BURUNDI BI ESTONIA EE CAMBODIA KH ETHIOPIA ET CANADA CA FAEROE ISLANDS FO CAPE VERDE CV FALKLAND ISLANDS FK CAYMAN ISLANDS KY FIJI FJ ENTRAL AFRICAN REPUBLI F DE is FINLAND FI HA KEELING ISLAND CHACOS G IS CC FRANCE FR CHAD TD FRENCH GUIANA GF CHILE CL FRENCH METROPOLITAN FX CHINA CN FRENCH POLYNESIA PF CHRISTMAS ISLAND CX FRENCH SOUTHERN TERRITORY TF MEROON UNITED REP M E E GABON GA COLUMBIA CO GAMBIA GM MOR KM ao GEORGIA GE K ISLAND K aes B T GHANA GH TA RICA R Sn 5 n GIBRALTER GI TEDTVOIRE I is n is GRECE GR CROATIA HR GREENLAND GL YPR Y i m GD 158 Payflow Pro Developer s Guide TABLE G 2 Visa country codes Codes Used by FDMS South Only Visa Country Codes TABLE 6 2 Visa country codes GUADALUPE GUAM GUATEMALA GUINEA GUINEA BISSAU GUYANA HAITI HEARD amp MCDONALDS ISLAND HONDURAS HONG KONG HUNGARY ICELAND INDIA INDONESIA IRAN IRAQ IRELAND ISRAEL ITALY J
10. gt AMEX Name o S XMLPayRequest parameter per American 5 See Payflow Pro XMLPay Format Express 2 Developer s Guide for min max Specification Flow SDK parameter detailed instructions type Freight Amount FREIGHTAMTn Item FreightAmt 1 15 NUM Handling Amount O L HANDLINGAMIn Item HandlingAmt 1 15 NUM Tracking Number L TRACKINGNUMn Item TrackingNumber 1 30 AN Drop off L PICKUPSTREETn Item PickUp Address Street 1 40 AN Address1 Drop off City L_PICKUPCITYn Item PickUp Address City 2 30 AN Drop off State L_PICKUPSTATEn Item PickUp Address State 2 2 AN Drop off ZIP L_PICKUPZIPn Item PickUp Address ZIP 3 15 AN Drop off Country O L_PICKUPCOUNTRYn Item PickUp Address Country 2 3 AN UNSPSC Code L_UNSPSCCODEn Item UNSPSCCode 1 30 AN Example American Express Phoenix Level 3 Transaction Parameter String RXTYPE S amp TENDER C amp partner partner amp PWD test amp USER test amp ACCT 378734493671000 amp EXPDATE 12 13 amp AMT 5 00 amp COMMENT1 PCARD Test amp COMMENT2 Testing amp ZIP 940151234 amp STREET 123 Lincoln WAY amp CVV2 052 amp SHIPTOCOUNTRY USA amp CUSTCODE 12345 amp FREIGHTAMT 1 00 amp ORDERDATE 021700 amp HANDLI NGAMT 1 00 amp PONUM 1234567890123456789012345 amp SHIPFROMZIP 940151234 amp SHIPTOZIP 940151234 amp AXAMT 1 OO amp TAXEXEMPT N amp L_UPC1 PN amp L_OTY1 1 amp L_DESC1 Test 123 amp L UOMI1 12 amp L COST1 1 00 amp L PRODCODE1 123 amp L COSTCENTERNUM1 55 amp L TAXAMT1 0 amp L QT
11. Non Referenced Credits Allowed When non referenced credits are allowed then Credit transactions are permitted in any amount up to the transaction limit for the credit card account that you specify To submit a Credit transaction when non referenced credits are allowed you must pass values for the following parameters e ACCT e EXPDATE e AMT I MPORTANT The default security setting for Payflow Pro accounts is Allow non referenced credits 2 No so sending the ORIGID is the preferred method for performing Credit transactions Using the ACCT EXPDATE or AMT parameters for such accounts leads to RESULT value 117 failed the security check For information on setting the security settings see PayPal Manager online help Fields Copied From the Original Transaction into the Credit Transaction The following fields are copied from the original transaction into the Credit transaction if they exist in the original transaction If you provide a new value for any of these parameters when submitting the Credit transaction then the new value is used Exceptions are ACCT EXPDATE and SWIPE These parameters retain their original values Note These fields are not copied for referenced credits TAXAMT TAXEXEMPT DUTYAMT FREIGHTAMT and for American Express only DESCA For processors that use the RECURRING parameter If the RECURRING parameter was set to Y for
12. Square centimetre Square decimetre Square foot Square inch NPL NPT NRL OHM ONZ APZ PAL DWT PCE LBR PGL QTI QAN QTR DTN RPM RPS SCO SCR SEC SET SHT SST STN SIE CMK DMK FTK INK 164 Payflow Pro Developer s Guide Codes Used by FDMS South Only ESI Units of Measure TABLE G 3 Units of measure Square kilometre KMK Square metre MTK Square mile MIK Square millimetre MMK Square yard YDK Standard WSD standard atmosphere 101325 Pa ATM statue mile 1609 344 m SMI Stone GB 6 350293 kg STI Technical atmosphere 98066 5 Pa ATT Ten days DAD Ten pairs TPR Thousand MIL Thousand ampere hour TAH 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 Payflow Pro Developer s Guide 165 Codes Used FDMS South Only FDMS South Currency Codes and Decimal Positions FDMS South Currency Codes and Decimal Positions TABLE 6 4 FDMS South currency codes TABLE G 4 FDMS South currency codes Currency Decimal Currency Name Code Positions Currency Decimal Currency Name Code Positions Portuguese Escudo 620 0 Argentine Peso 32 2 Rand 710 2 Australian Dollar 36 2 Spa
13. TRXTYPE TENDER CHKTYPE PARTNER VENDOR USER PWD AMT GITY DL or SS CHKNUM EMAIL MICR NAME STATE Payflow Pro Developer s Guide 91 92 Performing TeleCheck Electronic Check Transactions TeleCheck Parameters STREET ZIP TABLE B 1 TeleCheck Parameters Parameter AMT CITY COMMENT 1 COMMENT 2 CHKNU CHKTYPE DL DOB EMAIL INVNUM MICR NAME Description Required Type Length This is the transaction amount Default U S dollars The Yes Numeric 7 transaction amount should always specify a decimal and US the exact amount to the cent for example 34 00 instead of Dollars 34 Do not include comma separators in the amount Use only 1199 95 not 1 199 95 Account holder s city Yes Alpha 20 User defined value for reporting and auditing purposes No Alpha 128 numeric User defined value for reporting and auditing purposes No Alpha 128 numeric Account holder s next unused available check number Yes Numeric 7 Check type P personal default or Yes Alpha C company If CHKTYPE P then a value for either DL or SS must be passed as an identifier If CHKTYPE C then the Federal Tax ID must be passed as the SS value Driver s license number If CHKTYPE P a value for either Yes Alpha 33 DL or SS must be passed as an identifier numeric Format XXnnnnnnnn XX State Code nnnnnnnn DL Number Account holder s da
14. Turkey Turkmenistan Turks and Caicos Islands Tuvalu ganda kraine cd nited Arab Emirates c nited Kingdom c nited States nited States Minor Outlying Islands ruguay Code 634 638 642 643 646 659 662 670 882 674 762 834 764 768 772 776 780 788 792 795 796 798 800 804 784 826 840 581 858 Payflow Pro Developer s Guide ISO Country Codes TABLE 1 1 50 country codes Country Name Code Country Name Code Swaziland 748 Uzbekistan 860 Sweden 752 Vanuatu 548 Switzerland 756 Vatican City State 336 Syrian Arab Republic formerly Syria 760 Venezuela 862 Taiwan Province of China 158 Viet Nam 704 Virgin Islands British 92 Western Samoa 882 Virgin Islands U S 850 Yemen 887 Wallis and Futuna Islands 876 Yugoslavia 891 Virgin Islands British 92 Zaire 180 Virgin Islands U S 850 Zambia 894 Western Sahara 732 Zimbabwe 716 Payflow Pro Developer s Guide 151 ISO Country Codes 152 Payflow Pro Developer s Guide Codes Used by FDMS South Only Codes used by FDMS South only are Country Codes Units of Measure and Currency Codes MasterCard Country Codes TABLE G 1 MasterCard country codes ALBANIA ALB ALGERIA DZA AMERICAN SAMOA ASM ANDORRA AND ANGOLA AGO ANGUILLA AIA ANTARCTICA ATA ANTIGUA ATG AO PEOPLES DEMOCRATIC LAO APHGANISTAN AFG ARGENTINA ARG ARMENIA ARN ARUBA ABW AUSTRALIA AUS AUSTRIA AUT AZERBAIJAN AZE BAHAMAS
15. 0 1000 RESULT value 0 Approved 1001 2000 Certain amounts in this range will return specific PayPal results and can be generated by adding 1000 to that RESULT value For example for RESULT value 13 Referral submit the amount 1013 If the amount is in this range but does not correspond to a PayPal result supported by this testing mechanism RESULT value 12 Declined is returned 2001 RESULT value 12 Declined RESULT Values Returned Based on Transaction Amount This table lists the RESULT values that you can generate using the amount of the transaction To generate a specific code submit an amount of 1000 plus the code number for example submit an amount of 1013 for a result code of 13 TABLE 5 3 Result values supporting the amount control Processing Platform RESULT Values Available for Testing American Express Phoenix 0 12 13 104 1000 American Express Brighton 50 Payflow Pro Developer s Guide Credit Card Testing a RESULT Values Returned Based on Transaction Amount TABLE 5 3 Result values supporting the amount control Processing Platform RESULT Values Available for Testing Elavon Formerly Nova 0 12 13 104 First Data Merchant Services Nashville 0 12 13 104 First Data Merchant Services North 0 4 5 12 13 23 24 114 1000 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
16. 1 QTY n and unit price 1 lt gt fields Item Descriptor M Product Code Quantity Unit of Measure Code Tax Rate Applied Tax Type Applied Tax Amount ololololz Discount Amount DI ESCn L UPCn L_OTYn L_UOMn L_TAXRATEn L_TAXTYPEn L_D L_TAXAMTn ISCOUNTn 35 AN 12 AN 12 NUM 12 AN 4 NUM 4 AN 12 NUM 12 NUM Example Merchant e Solutions Level 3 MasterCard Transaction Parameter String TRXTYPE S amp TENDER C amp PARTNER Partner amp USER User amp PWD Password amp ACCT 552500000000 0005 amp EXPDATE 0406 amp AMT 1 00 amp STREET 5199 JOHNSON amp ZIP 94588 amp ALTTAXAMT 1 00 amp CUSTVATREGNUM 11111 amp E 22222 amp VATAXAMT 1 00 amp VATAXPERC NALTAXAMT 1 00 amp COMMCOD COUNT 1 00 amp FREIGHTAMT 1 0 HIPTOCOUNTRY 840 amp ORDERDAT item 1 O amp DUTYAMT 1 00 amp S E 020725 amp L COMMCOD LOCALTAXAMT 1 00 amp NATIO ENT 10 amp TAXEXEMPT Y amp DIS description amp L UPC1 CBA987654321 amp L QTY1 1 amp L 00 1 12345 _TAXAMT1 1 00 amp L_TAXRAT Merchant e Solutions Level 3 Visa Parameters HIPTOZIP 33333 amp SHIPFROMZIP 44444 amp S E1 123456789ABC amp L DESC1l Line 6789012 amp L COST1 1 00 amp L E1 1 00 amp L DISCOUNT1 1 00 amp L AMT1 1 00 amp L TAXTYPE1 TT3 To qualify for Level 3 transactions the authorization re
17. 129 131 133 135 Software Development Kit 9 SS parameter 93 SSL 17 SSL see Secure Sockets Layer STARTTIME parameter 39 STATE parameter 82 113 Stored Value 57 storefront testing 49 STREET parameter 27 69 80 84 93 SWIPE 68 83 SWIPE parameter 28 73 75 76 78 82 89 113 T TAXAMT 101 TAXAMT parameter 107 109 111 113 116 117 118 120 126 129 131 132 133 135 TAXAMTn parameter 128 TAXEXEMPT parameter 109 113 117 118 120 131 132 133 135 TAXPERCENTAGE parameter 129 TAXPERCENTAGEn parameter 128 TENDER parameter 26 testing operation 49 testing transactions host address 13 transaction types supporded for Level 3 procdessing 101 transaction levels described 99 transaction response PNREF parameter 57 RESPMSG parameter 58 RESULT parameter 58 transactions credit 34 inquiry 38 175 176 sale 28 void 36 TRXTYPE parameter 26 TSYS Acquiring Solutions 83 type N transactions 26 U USER parameter 21 V VATREGNUM parameter 121 136 VATTAXAMT parameter 121 136 VATTAXPERCENT parameter 121 136 VENDOR parameter 21 VERBOSITY 101 VERBOSITY parameter 139 void transaction type 36 Z zero dollar Authorization 23 32 ZIP parameter 27 69 81 84 Payflow Pro Developer s Guide
18. 38 Required Parameters When Using the 38 Inquiry Transaction Parameter String Using the PNREF 38 Required Parameters When Using the CUSTREF 39 Inquiry Transaction Parameter String Using the CUSTREF 39 4 Payflow Pro Developer s Guide Contents E Recharging to the Same Credit Card Reference Transactions 40 When To Use a Reference 40 Transaction Types that Can Be Used as the Original Transaction 41 Fields Copied From Reference Transactions 41 Example Reference 41 Submitting Card Present SWIPE 42 Supported Processing Platforms 43 Card present Transaction 43 Submitting Purchasing Card Transactions 2 ee 44 Using Address Verification Service 44 Processing Platforms Supporting Address Verification Service 44 Example Address Verification Service Request Parameter List 45 Example Address Verification Service Response 45 Card Security Code 46 Processing Platforms and Credit Cards Supporting Card Security Code 46 Chapter5 Credit Card Testing
19. Amount Total Line Item Amount Transaction Amount Total amount for the transaction AMT Total Tax Amount TAXAMT Total Freight Amount FREIGHTAMT or if not present the summation of L_FREIGHTAMTn for all line items Payflow Pro Developer s Guide 101 Submitting Purchasing Card Level 2 and Level 3 Transactions American Express Phoenix Purchasing Card Transaction Processing Total Handling Amount HANDLINGAMT or if not present the summation of HANDLINGAMTn for all line items Total Line Item Amount Summation of L_QTYn L_COSTn for all line items n as the line item number For example if there are 2 line items then the Total Line Item Amount would be LOTY1 LCOST1 LOTY2 LCOST2 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 Phoenix Purchasing Card Transaction Processing The American Express Phoenix platform supports Level 2 transaction data The parameters to meet card acceptance and processor network CAPN requirements are described in Table C 2 Level 2 parameters supported for legacy applications are described in Table C 3 Norte Most merchants in the United States follow CAPN requirements international merchants do not There are a few exceptions If you are not sure contact Customer Service See How to Contact Customer Support on page 9 for contact information 10
20. Do not include the ACCT or EXPDATE parameters in card present transactions as this data is included in the SWIPE value This is an example card present transaction parameter string TRXTYPE S amp TENDER C amp PARTNER PayPal amp USER SuperMerchant amp PWD SuperMerchant amp SWI 40 4912000033330026 15121011000012345678 amp 21 00 Payflow Pro Developer s Guide 43 Credit Card Transactions Submitting Purchasing Card Transactions Submitting Purchasing Card Transactions A purchasing card also referred to as a commercial card corporate card procurement card or business card is a credit card that is issued at the request of an employer It is usually reserved for business related charges The card issuer provides specialized reporting for this card type so the employer can monitor the use of the card There is no method for determining whether a card is a purchase card or a commercial card based on the card number To obtain the best bank interchange rates for commercial cards you must pass specific additional transaction information Commercial card support and parameters vary from processor to processor See Submitting Purchasing Card Level 2 and Level 3 Transactions on page 97 Note Purchasing card transactions are not supported by the PayPal processor Using Address Verification Service To qualify for the lowest bank rate you must pass address verification service inf
21. Global Payments Central 115 Merchant e Solutions 116 Paymentech Salem New Hampshire 124 126 Paymentech Tampa 131 Level 3 MasterCard transactions TSYS Acquiring Solutions 117 Level 3 parameters Merchant e Solutions 119 Paymentech Salem New Hampshire 127 128 129 TSYS Acquiring Solutions 132 134 Level 3 transactions American Express Brighton 108 American Express Phoenix 105 111 Level 3 Visa transactions TSYS Acquiring Solutions 119 levels transaction parameters 99 Line item parameters First Data Merchant Services North 111 Line item paramters First Data Merchant Services South 113 live transactions 18 live transactions host address 13 LOCALTAXAMT parameter 118 120 133 135 Logging Transaction Information 97 MERCHDESCR parameter 82 MERCHSVC parameter 77 82 MICR parameter 92 Moneris Solutions 14 169 MOTO 169 N NATIONALTAXAMT parameter 118 120 133 135 Nova See Elavon 79 123 O operation Payflow Pro Developer s Guide testing 49 ORDERDATE parameter 73 74 88 112 120 135 ORDERDATETIME parameter 73 75 89 ORDERTIME parameter 113 ORIGID parameter 30 35 37 38 P parameters required for electronic check 91 PARTNER parameter 21 Payflow parameters ACCT 21 28 30 31 35 37 41 43 ACCTTYPE 41 ADDLAMTn 71 86 104 126 ADDLAMTTYPEn 71 86 104 126 ADDLMSGS 101 140 ALTERNATETAXAMT 128 ALTERNATETAXID 128 ALTTAXAMT 118 133 AMEXID 142 AMEXPOSDATA 142 AMT 21 27 28 30 31 35 37 91
22. L_oTy4 Description Description of this line item if not provided DESCI if present is used 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 Quantity of this line item Description of this line item if not provided DESC2 if present is used 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 Quantity of this line item Description of this line item if not provided DESC3 if present is used 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 Quantity of this line item Description of this line item if not provided DESC4 if present is used 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 Quantity of this line item Location Transaction Advice Addendum Parameters ERCHANTNAME ERCHANTSTREET ERCHANTCITY ERCHANTSTATE Name of merchant Merchant s street address number and street name Merchant s city Merchant s state Required No No No No No No Type Alpha numeric Numeric Numeric Alpha numeric Numeric Numeric Alpha
23. PROCCVV2 140 PROXYADDRESS 20 PROXYLOGON 20 PROXYPASSWORD 20 PROXYPORT 20 PWD 21 91 93 RECURRING 35 37 70 75 76 78 81 82 85 90 RECURRINGTYPE 83 REQNAME 106 RESPMSG 58 95 RESPTEXT 140 RESULT 58 64 95 SETTLE DATE 141 SHIPFROMZIP 110 113 118 121 133 136 SHIPMETHOD 69 80 84 SHIPPEDFROMZIP 128 129 SHIPTOCITY 31 36 37 146 SHIPTOCOUNTRY 31 36 37 69 80 81 84 85 110 112 118 121 129 133 136 SHIPTOFIRSTNAME 31 36 37 69 81 85 146 SHIPTOLASTNAME 31 36 37 69 81 85 146 SHIPTOMIDDLENAME 31 36 37 SHIPTOPHONENUM 70 81 85 SHIPTOSTATE 31 36 37 146 SHIPTOSTREET 31 36 37 69 81 85 146 SHIPTOZIP 31 36 37 70 81 85 103 105 106 109 110 118 120 124 129 131 133 135 146 SKU 69 80 84 SS 91 93 STARTTIME 39 STATE 31 36 37 41 82 91 93 113 146 STREET 27 31 36 37 41 45 53 69 80 84 92 93 146 SWIPE 28 31 36 37 41 42 43 73 75 76 78 82 89 113 TAXAMT 31 35 37 101 103 107 109 111 113 115 116 117 118 120 124 126 129 131 132 133 135 146 TAXAMTn 128 TAXEXEMPT 31 35 37 109 113 117 118 120 131 132 133 135 TAXPERCENTAGE 129 TAXPERCENTAGEn 128 TENDER 26 91 93 TIMEOUT 20 TRANSSTATE 141 TRXTYPE 26 28 29 33 34 36 57 91 93 USER 21 91 93 VATREGNUM 121 136 VATTAXAMT 121 136 VATTAXPERCENT 121 136 VENDOR 21 91 93 VERBOSITY 19 20 101 139 Payflow Pro Developer s Guide ZIP 24
24. Required No No Type Length Alpha 13 Alpha 4 Alpha 17 numeric Currency 10 Currency 10 Alpha 15 Currency 10 Alpha 9 numeric Alpha 15 Numeric 6 112 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions First Data Merchant Services South FDMS Purchasing Card Transaction Processing TABLE C 8 FDMS South Level 2 and Level 3 purchasing card parameters Continued Parameter ORDERT IME PONUM SHIPFROMZIP SHIPTOZIP STATE SWIPE TAXAMT TAXEXEMPT Description Order time and date Format is either YYYY MM DD or YYYY MM DD HH MI SS where is in 24 hour time If the value does not conform to one of the formats or if the date is not valid for example 2004 17 35 then the transaction is rejected with a RESULT 7 SIG FIELD ERR and RESPMSG Invalid ORDERTIME A truncated version of the ORDERTIME value up to 7 characters overwrites any value provided by ORDERDATE If no value is provided a NULL value is stored Purchase order number merchant related data The postal code called zip code in the USA from which shipping occurs Ship to postal code called zip code in the USA Cardholder s state Allows Track 1 and Track 2 data to be passed to enable a card present transaction Tax amount The value must include a decimal and the exact amount to the cent 42 00 not 42
25. SHIPTOCOUNTRY 4 AN VATREGNUM 20 AN Can be part of the registration data or passed with each transaction INVNUM 9 AN Can be part of the registration data or passed with each transaction CUSTVATREGNUM 13 AN VATTAXAMT 12 NUM VATTAXPERCENT 4 NUM Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing TSYS Acquiring Solutions Level 3 Visa Line item Detail Records TABLE C 33 TSYS Acquiring Solutions Level 3 Visa line item detail record Mandatory ional Payflow Parameter Type Name Opt NOTE For these values n is a sequence counter that should begin with and increase in sequence Each line item Length Data should also contain quantity L QTY n and unit price L_COST lt n gt fields Item Commodity Code Item Descriptor Product Code Quantity Unit of Measure Code Unit Cost VAT Tax Amount VAT Tax Rate Discount Per Line Item lt lt Line item Total L_COMMCODEn 12 AN DESCn 35 AN IL UPCn 12 AN L QTYn 12 NUM I UOMn 12 AN L_COSTn 12 NUM L_TAXAMTn 12 NUM L_TAXRATEn 4 NUM L_DISCOUNTn 12 NUM L_AMTn 12 NUM Example TSYS Acquiring Solutions Level 3 Visa Transaction Parameter String TRXTYPE S amp TENDER C amp PARTNER Partner amp USER User amp PWD Password amp ACCT 411111111111 1111 amp EXPDATE 0406 amp AMT 1 00 amp STREET 5199 JO
26. excluding tax No Currency 10 L PRODCODEn Supplier specific product code No Alpha 12 numeric L_DISCOUNTn Discount per line item No Currency 10 L_AMTn Total line item amount including tax and discount Yes Currency 10 for debit for credits L_TAXAMTn Line item tax amount No Currency 10 Example FDMS South Purchasing Card Level 2 and 3 Parameter String TRXTYPE S amp TENDER C amp PARTNER P ayPal amp VENDOR SuperMerchant amp USER SuperMerchant amp PWD xly2z3 amp STATE CA amp FIRSTNAME John amp LASTNAME Smith amp CITY Redwood amp SHIPTOCOUNTR Y USA amp CUSTCCDE 12345 amp DISCOUNT 25 amp DUTYAMT 34 00 amp FREIGHTAMT 12 00 amp INVNUM 123 45678 9 amp ORDERDATE 021700 amp PONUM 1234567890123456789012345 amp SHIPFROMZIP 9401512 34 amp SHIPTOZIP 94065 amp TAXAMT 1 00 amp TAXEXEMPT Y Example FDMS South Line Item Parameter String TRXTYPE S amp TENDER C amp PARTNER PayPal amp VENDOR SuperMerchant amp USER SuperMerchant amp PWD xly2z3 amp STATE CA amp FIRSTNAME John amp LASTNAME Smith amp CITY Redwood amp SHIPTOCOUNTR Y USA amp CUSTCCDE 12345 amp DISCOUNT 25 amp DUTYAMT 34 00 amp FREIGHTAMT 12 00 amp INVNUM 123 45678 9 amp ORDERDATE 021700 amp PONUM 1234567890123456789012345 amp SHIPFROMZIP 9401512 34 amp SHIPTOZIP 940 65 amp TAXAMT 1 OO amp TAXEXEMPT Y amp L_OTY1 1 amp L_UPC1 PN amp L_DESC1 Test amp UOMI INO amp L COST1 1 00 amp L PRODCODE1 123
27. from 1 to 6 Internet Transaction Data Parameters PHON EMAIL ENUM PHONE CUSTHOSTNAME CUSTBROWSER Account holder s email address Account holder s telephone number Telephone company provided ANI information identifier digits indicating the telephone call type Examples cellular 61 63 payphone 27 Name of the server that the account holder is connected to Example PHX QW AOL COM Account holder s HTTP browser type Example MOZILLA 4 0 COMPATIBLE MSIE 5 0 W INDOWS 95 No No No No Alpha numeric Numeric Numeric Alpha numeric String Alpha numeric Alpha numeric and special characters Alpha numeric and special characters Length 19 60 20 60 68 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters A American Express TABLE A 1 American Express CAPN parameters Continued Parameter Description Required Type Length CUSTIP Account holder s IP address No Alpha 15 numeric and special characters SHIPTOCOUNTRY Numeric country code of ship to country No Alpha 3 Example numeric USA 840 SHIPMETHOD Shipping method code The values are No Alpha 2 01 Same day numeric 02 Overnight next day 03 Priority 2 3 days 04 Ground 4 or more days 05 Electronic delivery 06 ZZ Reserved for future use SKU Merchant product SKU No Alpha 15
28. numeric Numeric Numeric Alpha numeric Numeric Numeric Alpha numeric Length 140 12 40 40 40 38 38 21 Payflow Pro Developer s Guide 125 Submitting Purchasing Card Level 2 and Level 3 Transactions Paymentech Salem New Hampshire Purchasing Card Transaction Processing TABLE C 21 Paymentech Salem New Hampshire CAPN Level 2 parameters Parameter Description Required Type ERCHANTCOUNTRY Merchant s numeric country code No Alpha CODE Example numeric USA 840 ERCHANTZIP Merchant s 5 to 9 digit zip postal code excluding No Alpha spaces dashes and non numeric characters numeric Example 951121737 Transaction Advice Detail Parameters ADDLAMTn Detail of a charge n is the line item number a value No Numeric from 1 5 use for additional breakdown of the charge 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 ADDLAMTTYPEn A 3 digit code indicating the type of the No Alpha corresponding charge detail n is the line item numeric number a value from 1 5 Length 12 Paymentech Salem New Hampshire Level 2 Parameters Legacy Paymentech Salem New Hampshire supports Level 2 parameters for American Express MasterCard Visa and Switch Solo Maestro Both Level 2 parameters listed in Table C 22 are required t
29. 172 H HANDLINGAMT parameter 107 HOSTCODE parameter 95 inquiry transaction type 38 INVNUM parameter 73 74 76 78 82 88 89 106 112 118 121 133 136 INVOICEDATE parameter 106 L L_AMTn parameter 111 114 122 128 129 137 L CATALOGNUMIn parameter 107 L COMMCODERn parameter 111 114 122 137 L COSTCENTERNUMIn parameter 107 L_COSTn parameter 107 111 114 122 129 L_COSTn parameterPayflow parameters L_COSTn 137 L_DESCn parameter 107 111 114 119 122 128 129 134 137 L_DISCOUNTn 137 L_DISCOUNTn parameter 111 114 119 122 128 129 134 137 L FREIGHTAMTn 101 L FREIGHTAMTn parameter 108 L HANDLINGAMTn parameter 108 L PICKUPCITYn parameter 108 L PICKUPCOUNTRYn parameter 108 L PICKUPSTATEn parameter 108 L PICKUPSTREETn parameter 108 L PICKUPZIPn parameter 108 L PRODCODEn parameter 107 114 128 129 L QTYn 137 L QTYn parameter 107 111 114 119 122 128 129 134 137 L TAXAMTn parameter 107 111 114 119 122 129 134 137 L TAXRATEn parameter 119 122 129 134 137 L TAXTYPEn parameter 119 128 134 L TRACKINGNUMn parameter 108 L_UNSPSCCODEn parameter 108 L_UOMn parameter 107 111 114 119 122 128 129 134 137 L_UPCn parameter 107 111 119 122 129 134 137 LASTNAME parameter 27 73 74 88 112 length tags 21 Level 2 parameters American Express Phoenix CAPN 103 American Express Phoenix legacy 105 Elavon Formerly Nova 123 Global Payments East 116
30. 27 31 36 37 41 44 45 53 69 81 84 92 93 146 payflowpro paypal com 13 payment types 15 PayPal Developer Central 9 PHONENUM parameter 69 81 84 93 pilot payflowpro paypal com 13 PINless debit 26 pinless debit 15 26 27 28 PNREF format of value 58 PNREF parameter 95 PNREF value 57 PONUM parameter 103 105 106 109 110 113 117 118 120 124 126 131 132 133 135 Purchasing card transactions American Express Phoenix 100 First Data Merchant Services Nashville 108 First Data Merchant Services North 110 First Data Merchant Services South 112 Global Payments Central 115 Global Payments East 115 Merchant e Solutions 116 Nova 123 Paymentech Salem New Hampshire 124 Paymentech Tampa 130 TSYS Acquiring Solutions 131 purchasing cards about 99 BIN ranges 100 PWD parameter 21 R RECURRING parameter 70 75 76 78 81 82 85 90 REQNAME parameter 106 required parameters electronic check 91 RESPMSG parameter 95 RESPMSG value 58 RESULT parameter 95 RESULT value 58 S sale transaction type 28 Secure Sockets Layer 14 Payflow Pro Developer s Guide settlement operation 14 SHIPFROMZIP parameter 110 113 118 121 133 136 SHIPPEDFROMZIP parameter 128 129 SHIPTOCOUNTRY parameter 110 112 118 121 128 129 133 136 SHIPTOFIRSTNAME parameter 69 81 85 SHIPTOLASTNAME parameter 69 81 85 SHIPTOSTREET parameter 69 81 85 SHIPTOZIP parameter 70 81 85 103 105 106 109 110 113 118 120 124
31. 92 101 107 AUTHCODE 33 34 106 AVSADDR 53 AVSZIP 53 BALAMT 57 BATCHID 141 BILLTOCOUNTRY 31 36 37 41 82 145 CHKNUM 91 92 CHKTYPE 91 92 CITY 31 35 37 41 82 91 92 112 145 COMMCARD 109 COMMCODE 120 135 COMMENT 27 31 35 37 92 145 2 27 31 36 37 92 145 COMPANYNAME 31 36 37 145 CUSTBROWSER 68 80 84 CUSTCODE 31 36 37 112 115 116 145 CUSTHOSTNAME 668 80 84 CUSTIP 31 36 37 69 80 84 CUSTREF 39 CUSTVATREGNUM 121 136 CVV2 54 CVV2MATCH 53 DATE_TO_SETTLE 141 DESC 74 107 Payflow Pro Developer s Guide DESCI 74 105 DESC2 74 105 DESC3 74 105 DESC4 35 74 105 DISCOUNT 110 112 120 128 129 135 DL 91 92 DOB 92 DUTYAMT 31 35 37 109 110 112 118 120 129 133 135 145 EMAIL 31 36 37 68 79 83 91 92 145 ENDTIME 39 EXPDATE 22 27 28 30 31 35 36 37 41 43 FIRSTNAME 27 31 36 37 41 73 74 88 112 145 FREIGHTAMT 31 35 37 101 107 109 110 112 118 120 128 129 133 135 145 HANDLINGAMT 102 107 HOSTADDRESS 20 HOSTCODE 95 140 HOSTPORT 20 INVNUM 31 36 37 73 74 76 78 82 88 89 92 106 112 118 120 121 133 136 INVOICEDATE 106 L AMTI 103 125 L AMT2 103 125 L AMT3 103 125 L AMTA 104 125 L 68 83 111 114 122 128 129 137 L CATALOGNUMn 107 L COMMCODEn 111 114 122 137 L COSTCENTERNUMn 107 L COSTn 102 107 111 114 122 129 L DESCI 103 125 L DESC2 103 125 L DESC3 103 125 L DESCA 1
32. Additional Credit Card Parameters Legacy In addition to the parameters in Table 4 1 Credit card transaction request parameters TSYS Acquiring Solutions accepts the following legacy parameters TABLE A 11 TSYS Acquiring Solutions additional parameters legacy Parameter INVNUM SWIPE Description 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 Allows Track 1 and Track 2 data to be passed to enable a card present transaction Required No Type Length Alpha 9 numeric Alpha 80 numeric Payflow Pro Developer s Guide 89 90 Processors Requiring Additional Transaction Parameters TSYS Acquiring Solutions TABLE 11 TSYS Acquiring Solutions additional parameters legacy Continued Parameter Description Required Type Length RECURRING Identifies the transaction as recurring This value does No Alpha 1 not activate PayPal s Recurring Billing Service API numeric If the RECURRING parameter was set to Y for the original Yor N transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s Fraud Protection Services To avoid charging you to filter recurring transaction
33. BHS BAHRAIN BHR BANGLADESH BGD BARBADOS BRB BELARUS BLR BELGIUM BEL Payflow Pro Developer s Guide 153 Codes Used by FDMS South Only MasterCard Country Codes TABLE G 1 MasterCard country codes TABLE G 1 MasterCard country codes BELIZE BLZ COTED IVOIRE CIV BENIN BEN CROATIA HRV BERMUDA BMU CYPRUS CYP BHUTAN BTN CZECH REPUBLIC CZE BOLIVIA BOL DENMARK DNK BOSNIA AND HERZIGOVINA BIH DJIBOUTI DJI BOTSWANA BWA DOMINICA DMA BOUVET ISLAND BVT DOMINICAN REPUBLIC DOM BRAZIL BRA EL SALVADOR SLV BRITISH INDIAN OCEAN IOT EQUATORIAL GUINEA GNQ TERRITORY ESTONIA EST BRUNEI BRN ETHIOPIA ETH BULGARIA BGR FAEROE ISLANDS FRO BURKINA FASO BFA FALKLAND ISLANDS MALVINAS FLK BURUNDI BDI FIJI FJI CAMBODIA KHM FINLAND FIN CANADA CAN FRANCE FRA CAPE VERDE CPV FRENCH GUIANA GUF CAYMAN ISLANDS CYM FRENCH POLYNESIA PYF CENTRAL AFRICAN REPUBLIC CAF FRENCH SOUTHERN TERRITORY ATF CHAD TCD GABON GAB CHILE CHL GAMBIA GMB CHINA CHN GEORGIA GEO CHRISTMAS ISLAND CXR GERMAN DEMOCRATIC REP DDR MEROON UNITED REP MR s OUN M GERMANY DEU KEELING ISLAND K COCOS G IS GHANA GHA LOMBIA L GIBRALTER GIB COMOROS COM GRECE GRC oe GREENLAND GRL COOK ISLANDS COK GRENADA GRD TA RICA RI oe E GUADALUPE GLP 154 Payflow Pro Developer s Guide Codes Used by FDMS South Only MasterCard Country Codes TABLE G 1 MasterCard country codes TABLE G 1 MasterCard country codes GUAM GUM LIEC
34. ERCHANTCOUNTRYCO Merchant s numeric country code No Alpha 3 DE Example numeric USA 840 ERCHANTZIP Merchant s 5 to 9 digit ZIP postal code No Alpha 9 excluding spaces dashes and non numeric numeric characters Example 951121737 Transaction Advice Detail Parameters ADDLAMTn Detail of a charge where n is a value from 1 5 No Numeric 12 Use for additional breakdown of the amount Must include a decimal and be exact to the cent 42 00 not 42 and exclude comma separators 1234 56 not 1 234 56 Examples tip 3 00 convenience charge 2 00 ADDLAMTTYPEn A 3 digit code indicating the type of the No Alpha 3 corresponding charge detail where n is a value numeric from 1 5 Airline Passenger Data Parameters AIR DEPARTUREDATE Departure date in the format YYYYMMDD No Alpha 8 numeric AIR PASSENGERNAME of the passenger in the following format No Alpha 60 with fields separated by a space numeric surname firstname middleinitial title AIR ORIGIN Airport code of the originating airport No Alpha 5 For a list of airport codes see http www world numeric airport codes com alphabetical airport code a html NOTE Present day airport codes are three characters in length The five character length is designed to allow for future expansion 86 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters TSYS Acquiring Solutions TABLE A 10 A
35. 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 12 13 23 24 1000 TSYS Acquiring Solutions Formerly Vital Processing 0 4 12 13 23 104 114 1000 Services Alternative Methods for Generating Specific RESULT Values The table below shows another method for obtaining RESULT values Non zero RESULT values from processors are not returned by the servers and therefore cannot be simulated using the amount In some cases you may get certain results using the RESULT value plus 1000 even though this table suggests another means of obtaining the RESULT value TABLE 5 4 Obtaining RESULT value RESULT Definition How to test using Payflow Pro 0 Approved Use an AMOUNT of 1000 or less For all Processors except Global Payments Central MAPP and FDI Credit C and Force F transactions will always be approved regardless of dollar amount or card number 1 User authentication failed Use an invalid PWD 2 Invalid tender Use an invalid TENDER such as G 3 Invalid transaction type Use an invalid TRXTYPE such as G 4 Invalid amount Use an invalid AMOUNT such as 1 5 Invalid merchant Use the AMOUNT 1005 Applies only to the following processors information Global Payments East and Central and American Express 7 Field format error Submit a Delayed Capture transaction with no ORIGID 12 Declined Use the AMOUNT 1012 or an
36. Example Account Verification This is an example of account verification TRXTYPE A amp TENDER C amp USER SuperUser amp PWD SuperUserPassword amp VENDOR Super USer amp PARTNER PayPal amp ACCT 4111111111111111 amp EXPDATE 0712 amp CVV2 123 amp AMT 0 00 amp CURRENCY USD amp STREET 123 Main St amp ZIP 11232 amp VERBOSITY MEDIUM This is the response RESULT 0 amp PNREF V79EIE4610CE amp RESPMSG Verified amp AUTHCODE 010101 amp AVSADDR Y amp AVSZIP Y amp CVV2MATCH Y amp HOSTCODE 00 amp P ROCAVS Y amp PROCCVV2 M amp IAVS N Submitting Voice Authorization Transactions A Voice Authorization TRXTYPE F transaction is a transaction that is authorized over the telephone from the processing network Note The PayPal processor does not support Voice Authorization 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 transactions generate RESULT value 13 and are called Referral transactions In these situations you contact the customer service department of your merchant bank and provide the payment information as requested If the transaction is approved the bank provides you with a voice Authorization code AUTHCODE for the transaction Once a Voice Authorization transaction has been approved it is treated like a Sale transaction and is settl
37. Fraud Protection Services To avoid charging you to filter recurring transactions that you know are reliable the fraud filters do not screen recurring transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Manual Transactions page The filters screen the transaction in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results Paymentech Paymentech Salem New Hampshire Additional Credit Card Parameters CAPN In addition to the parameters in Table 4 1 Credit card transaction request parameters Paymentech Salem New Hampshire accepts the parameters in Table A 8 to meet CAPN requirements TABLE A 8 Additional Paymentech parameters to meet CAPN requirements Parameter Description Required Type Length Internet Transaction Data Parameters EMAIL Account holder s email address No Alpha 60 numeric Payflow Pro Developer s Guide 79 80 Processors Requiring Additional Transaction Parameters Paymentech TABLE A 8 Additional Paymentech parameters to meet CAPN Parameter PHONENUM PHONETYPE CUSTHOSTNAME CUSTBROWSER CUSTIP SHIPTOCOUNTRY SHIPMETHOD SKU AVS Parameters STREET Description Account holder s telephone number Telephone company provided ANI information identifier digits indicating the telephone call type Examples
38. Guide 75 EE Processors Requiring Additional Transaction Parameters First Data Merchant Services FDMS Nashville First Data Merchant Services FDMS Nashville FDMS Nashville Additional Credit Card Parameters In addition to the parameters in Table 4 1 Credit card transaction request parameters FDMS Nashville accepts the following parameters TABLE FDMS Nashville additional parameters Parameter Description Required Type Length INVNUM Merchant invoice number The merchant invoice number is Alpha 9 used for authorizations and settlements and depending on numeric 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 RECURRING Identifies the transaction as recurring This value does not Alpha 1 activate PayPal s Recurring Billing Service API numeric If the RECURRING parameter was set to Y for the original Yor N transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s Fraud Protection Services To avoid charging you to filter recurring transactions that you know are reliable the fraud filters do not screen recurring transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Manual Transactions page The filters screen the transaction
39. Item Record 1 Description M DESCn Product Code M L PRODCODEn Quantity M L NUM Unit of measure M L UOMn Tax Amt L_TAXAMTn NUM Tax Rate L_TAXRATEn Line Item Record 2 Line item Total M L_AMTn NUM Discount Amt M L_DISCOUNTn NUM Item commodity code M L_UPCn Unit cost M COSIn NUM Payflow Pro Developer s Guide 129 Submitting Purchasing Card Level 2 and Level 3 Transactions Paymentech Tampa Level 2 Purchasing Card Transaction Processing Example Paymentech Salem New Hampshire Level 3 MasterCard Transaction Parameter String TRXTYPE S amp TENDER C amp PARTNER Partner amp PWD Password amp USER User amp ACCT 548018000000 0024 amp EXPDATE 1203 amp AMT 1 00 amp COMMENT1 20508 amp NAME Robert amp STREET 1600 amp Z1P 94065 amp CVV2 42 6 amp PONUM ABCDEF GHIJ amp TAXAMT 1 00 amp FREIGHTAMT 2 00 amp DUTYAMT 3 00 amp SHIPTOZI P 94543 amp SHIPTOCOUNTRY 8 40 amp SHIPFROMZIP 9450 9 amp SALTERNATETAXID 10 amp ALTERNATETAXA MT 4 00 amp L_DESC1 MC Pcard amp L_UPC1 1 amp L_OTY1 2 amp L_UOM1 3 amp L_TAXAMT1 4 amp L_TAXRATE1 5 amp L_AMT1 6 amp L_DISCOUNT1 7 amp L_TAXTYPE1 8 Example Paymentech Salem New Hampshire Level 3 Visa Transaction Parameter String TRXTYPE S amp TENDER C amp PARTNER Partner amp PWD Password amp USER User amp ACCT 427533001234 5626 amp EXPDATE 1203 amp AMT 1 005 COMMENT 1 0508 amp NAME Robert amp STREET 1 600 amp Z1IP 94065 amp CVV2 42 6 amp PONUM ABCDEFGHIJ amp TAXAMT 1 OO amp FREIGHTAMT 2 O
40. Name HOSTCODE RESPTEXT PROCAVS PROCCVV2 PROCCARDSECURE ADDLMSGS Type Char Char Char Char Char char Length 17 1 Up to 1048 characters Typically 50 characters Description Response code returned by the processor This value is not normalized by PayPal Text corresponding to the response code returned by the processor This text is not normalized by PayPal Address Verification Service response from the processor CVV2 buyer authentication response from the processor VPAS SPA response from the processor Additional error message that indicates that the merchant used a feature that is disabled Payflow Pro Developer s Guide VERBOSITY Viewing Processor Specific Transaction Results Supported Verbosity Settings TABLE D 2 Processor responses Continued Field Name Type Length Description TRANSSTATE Integer 10 State of the transaction The values are 0 Account Verification no settlement involved 1 General error state 3 Authorization approved 6 Settlement pending transaction is scheduled to be settled 7 Settlement in progress transaction involved in a currently ongoing settlement 8 Settled successfully 9 Authorization captured once an authorization type transaction is captured its TRANSSSTATE becomes 9 10 Capture failed an error occurred while trying to capture an authorization because the transaction was a
41. 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 RESULT value 126 is intended to give you an idea of the kind of transaction that is considered suspicious to enable you to evaluate whether you can benefit from using the Fraud Protection Services To eliminate RESULT 126 turn the filters off For more information see the fraud documentation for your payments solution Fraud Protection Services Filter Not processed by filters Fraud Protection Services Filter Declined by merchant after being flagged for review by filters Card has not been submitted for update Data mismatch in HTTP retry request Issuing bank timed out Issuing bank unavailable Reauth error Order error Cybercash Batch Error Cybercash Query Error Generic host error This is a generic message returned by your credit card processor The RESPMSG will contain more information describing the error Buyer Authentication Service unavailable Buyer Authentication Service Transaction timeout Buyer Authentication Service Invalid client version Buyer Authentication Service Invalid timeout value Buyer Authentication Service unavailable Buyer Authentication Service unavailable Website Payments Pro Payflow Edition Developer s Guide Responses to Transaction Requests RESULT Values and RESPMSG Text TABLE 6 9 Payflow Transacti
42. addition to the parameters in Table 4 1 Credit card transaction request parameters Paymentech accepts the following legacy parameters For best AVS results pass the city and state parameters in the parameter list TABLE A 9 Additional Paymentech parameters legacy Parameter CITY BILLTOCOUNTRY INVNUM HDESCR STATE SWIPE HSVC RECU RRING Description Cardholder s billing city Cardholder s billing country code 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 Merchant descriptor For example ABCCMPY FALLCATALOG Merchant telephone number For example 603 555 1212 Cardholder s billing state Allows Track 1 and Track 2 data to be passed to enable a card present transaction Identifies the transaction as recurring This value does not activate PayPal s Recurring Billing Service APIs If the RECURRING parameter was set to Y for the original transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s Fraud Protection Services To avoid charging you to filter recurring transactions that you know are reliable the fraud filters do not screen recurrin
43. amp AVSADDR Y amp AVSZ 45 46 Credit Card Transactions Card Security Code Validation Card Security Code Validation 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 card security code provides some assurance that the physical card is in the possession of the buyer This fraud prevention tool has various names depending on the payment network Visa calls it CVV2 and MasterCard calls it CVC2 To ensure that your customers see a consistent name PayPal recommends use of the term card security code on all end user materials IMPORTANT To comply with credit card association regulations do not store the CVV2 value On most cards the card security code is printed on the back of the card usually in the signature field All or part of the card number appears before the card security code 567 in the example For American Express the 4 digit number 1122 in the example is printed on the front of the card above and to the right of the embossed account number Be sure to explain this to your customers FIGURE 4 1 Card security code Processing Platforms and Credit Cards Supporting Card Security Code Note You need to contact American Express to be set up to accept their CID card security code TABLE 4 13 Processing platforms supporting card security code A
44. and convey the results of the payment requests to the client Payflow Pro XMLPay Developer s Guide Payflow Pro XMLPay Developer s Guide defines an XML syntax for payment transaction requests responses and receipts in a payment processing network You may obtain a copy of this document via the PayPal Manager Documentation page For specific examples of how to submit XML documents using the Payflow client API see the Payflow SDK Download package Payflow Pro Developer s Guide 167 Payflow Pro XMLPay Developer s Guide 168 Payflow Pro Developer s Guide Additional Processor Information This appendix provides additional processor information Moneris Solutions The Moneris Solutions processor has the following characteristics e It supports ecommerce and mail order or telephone order MOTO transactions e Itsupports the four basic credit card types American Express Discover MasterCard and Visa e To process live transactions it requires undergoing a certification process For details see the Moneris Receipts Specification available on the Payflow Pro page on Developer Central Payflow Pro Developer s Guide 169 Additional Processor Information Moneris Solutions 170 Payflow Pro Developer s Guide Index A Account Verification 23 32 ADDLMSGS 101 address verification service 44 ALTERNATETAXAMT parameter 128 ALTERNATETAXID parameter 128 ALTTAXAMT parameter 118 133 American Expre
45. capture for a previous Authorization succeeds subsequent attempts to capture it again will return an error Submitting Account Verifications With TRXTYPE A Account Verification also known as zero dollar Authorization TRXTYPE A verifies credit card information While Account Verification and normal Authorization transactions are submitted using TRXTYPE A Account Verification differs from ways Authorization in the following e The AMT value is always 0 If any other amount is submitted the transaction as a normal Authorization that places a hold on the cardholder s open to buy limit e Although the RESULT value returned is 0 Approved the RESPMSG value is Verified instead of Approved 32 Payflow Pro Developer s Guide Credit Card Transactions E Submitting Voice Authorization Transactions e The TRANSSTATE is set to 0 to prevent these types of transactions from being credited voided or captured See VERBOSITY Viewing Processor Specific Transaction Results on page 139 for details on TRANSSTATE Note RESULT value 4 Invalid Amount is returned if the processor does not support Account Verifications When To Use Account Verification Use an Account Verification to validate account numbers and other authentication elements such as CVV2 and AVS You can also use an Account Verification as a Reference Transaction See Recharging to the Same Credit Card Reference Transactions on page 40
46. cellular 61 63 payphone 27 Name of the server that the account holder is connected to Example PHX QW AOL COM Account holder s HTTP browser type Example MOZILLA 4 0 COMPATIBLE MSIE 5 0 WI NDOWS 95 Account holder s IP address Numeric country code of ship to country Example USA 840 Shipping method code The values are 01 Same day 02 Overnight next day 03 Priority 2 3 days 04 Ground 4 or more days 05 Electronic delivery 06 ZZ Reserved for future use Merchant product SKU Account holder s street address number and street name Required No No No No No No Type String Alpha numeric Alpha numeric and special character s Alpha numeric and special character s Alpha numeric and special character s Alpha numeric Alpha numeric Alpha numeric Alpha numeric Length 20 60 60 15 15 30 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters a Paymentech TABLE A 8 Additional Paymentech parameters to meet CAPN Parameter Description Required Type Length ZIP Account holder s 5 to 9 digit ZIP postal code No String 9 excluding spaces dashes and non numeric characters Example 951121737 PHONENUM Account holder s telephone number The formats No String 20 are US numbers TXXXXXXXXXXX international numbers
47. comma separators 1234 56 not 1 234 56 LOCALTAXAMT 12 NUM TAXEXEMPT Y or N 1 AN NATIONALTAXAMT 12 NUM You may omit this parameter if there is no such tax INVNUM 9 AN Value of PNREF is sent if no value is provided Merchant e Solutions Level 3 MasterCard Extended Data The parameters listed in Table C 14 apply to Level 3 MasterCard transactions as extended data TABLE C 14 Merchant e Solutions Level 3 MasterCard Extended Data Merchant e Solutions Name Freight Amt Duty Amt Dest Postal ZIP Code Ship from Postal ZIP Code Dest Country Code Alt Tax Amt Mandatory Length Optional Payflow Parameter Data Type FREIGHTAMT 12 NUM DUTYAMT 12 NUM M SHIPTOZIP 10 AN The zip code of the address to which the goods are shipped M SHIPFROMZIP 10 AN The postal code called zip code in the USA from which shipping occurs SHIPTOCOUNTRY 4 AN ALTTAXAMT 9 NUM Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions Merchant e Solutions Purchasing Card Transaction Processing Merchant e Solutions Level 3 MasterCard Line item Detail Records TABLE C 15 Merchant e Solutions Level 3 MasterCard line item detail record Mandatory Merchant e Solutions Name Optional Payflow Parameter Length Data Type NOTE For these values n is a sequence counter that should begin with 1 and increase in sequence Each line item should also contain quantity
48. in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results SWIPE Allows Track 1 and Track 2 data to be passed to enable a No Alpha 80 card present transaction numeric 76 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters A First Data Merchant Services FDMS South First Data Merchant Services FDMS South FDMS South Additional Credit Card Parameters In addition to the parameters in Table 4 1 Credit card transaction request parameters FDMS South accepts the following parameters TABLE 4 FDMS South additional parameters Parameter Description Required Type Length SWIPE Allows Track 1 and Track 2 data to be passed to enable a No Alpha 80 card present transaction numeric First Data Merchant Services FDMS North FDMS North Additional Credit Card Parameters In addition to the parameters in Table 4 1 Credit card transaction request parameters FDMS North also known as FDMS CardNet accepts the parameters in Table A 5 TABLE 5 FDMS North additional parameters Parameter Description Required Type Length DESC Use the DESC parameters to pass in your name No Alpha 25 and other data describing the transaction This numeric information will be displayed in the end user s statement Note FDMS North passes the descriptive data to the card associations with the followi
49. information from an existing transaction Credit card information must be supplied As an example Sally Smith calls you on the telephone to cancel an order from your business To refund her money you credit her credit card by submitting a non referenced Credit transaction Guidelines and parameter requirements for Credit transactions differ depending on whether or not non referenced credits are allowed Non Referenced Credits Not Allowed When non referenced credits are not allowed the setting recommended by PayPal then Credit transactions are permitted only against existing Sale Delayed Capture and Voice Authorization transactions To submit a Credit transaction when non referenced credits are not allowed you must pass the following parameter 34 Payflow Pro Developer s Guide Credit Card Transactions E Submitting Credit Transactions ORIGID TABLE 4 5 Credit required parameter Parameter Description ORIGID Required by some transaction types ID of the original transaction that is being referenced This ID is returned by the PNREF parameter and 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 PNREF is displayed as the Transaction ID in PayPal Manager reports If you do not specify an amount then the amount of the original transaction is credited to the cardholder
50. name did not match URL 40 Unexpected Request ID found in request 41 Required Request ID not found in request 99 Out of memory 100 Parameter list cannot be empty 103 Context initialization failed 104 Unexpected transaction state 105 Invalid name value pair request 106 Invalid response format 107 This XMLPay version is not supported 108 The server certificate chain did not validate 109 Unable to do logging 111 The following error occurred while initializing from message file lt Details of the error message gt 113 Unable to round and truncate the currency value simultaneously Website Payments Pro Payflow Edition Developer s Guide 65 Responses to Transaction Requests RESULT Values and RESPMSG Text 66 Website Payments Pro Payflow Edition Developer s Guide Processors Requiring Additional Transaction Parameters This appendix lists both required and optional parameters supplementary to the common parameter set In this Appendix American Express on page 67 First Data Merchant Services FDMS Nashville on page 76 First Data Merchant Services FDMS South on page 77 First Data Merchant Services FDMS North on page 77 Elavon Formerly Nova on page 79 Paymentech on page 79 TSYS Acquiring Solutions on page 83 American Express In addition to the parameters in Table 4 1 Credit card transaction request parameters American Express accepts the par
51. numbers such as the question mark A PNREF typically contains letters and numbers only The PNREF in a transaction response tells you that your transaction is connecting to PayPal RESULT Values and RESPMSG Text The RESULT parameter and value is the first name value pair returned in the response string The value of RESULT indicates the overall status of the transaction attempt e A value of 0 zero indicates that no errors occurred and the transaction was approved Note For Account Verification transactions RESULT 0 with RESPMSG Verified means a zero dollar authorization has been successfully performed e A value less than 0 indicates that a communication error occurred In this case no transaction is attempted e A value greater than 0 indicates a decline or error The response message RESPMSG provides a brief description for decline or error results RESULT Values for Transaction Declines or Errors For non zero RESULT values the response string includes a RESPMSG name value pair The exact wording of the RESPMSG shown in bold may vary Sometimes a colon appears after the initial RESPMSG followed by more detailed information TABLE 6 9 Payflow Transaction RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 0 Approved NOTE PayPal processor Warning information may be returned that may be useful to the request applicaton See the PayPal API documentation on the PayPal w
52. numeric AVS Parameters STREET Account holder s street address number and street No Alpha 30 name numeric ZIP Account holder s 5 to 9 digit ZIP postal code No String 9 excluding spaces dashes and non numeric characters Example 951121737 PHONENUM Account holder s telephone number The formats String 20 are US numbers TXXXXXXXXXXX international numbers SHIPTOFIRSTNAME First name in the shipping address No Alpha 30 numeric SHIPTOLASTNAME Last name in the shipping address No Alpha 30 numeric SHIPTOSTREET Shipping street address No Alpha 30 numeric SHIPTOCOUNTRY Numeric country code No Alpha 3 Example numeric USA 840 Payflow Pro Developer s Guide 69 Processors Requiring Additional Transaction Parameters American Express TABLE A 1 American Express CAPN parameters Continued Parameter SHIPTOZIP SHIPTOPHONENUM RECURRING Description Required Shipping 5 to 9 digit ZIP postal code excluding No spaces dashes and non numeric characters Example 951121737 Shipping telephone number Identifies the transaction as recurring This value does not activate PayPal s Recurring Billing Service APIs If the RECURRING parameter was set to Y for the original transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s Fraud Protection Services To avoid c
53. pairs are valid 14 Ruff amp Johnson COMMENT 1 7 Level 5 NOTE Quotation marks are not allowed even if you use a length tag User Parameters All Payflow Pro transactions require the user parameters described below TABLE 3 2 User parameters Parameter Description USER Required If you set up one or more additional users on the account this value is the ID of the user authorized to process transactions If however you have not set up additional users on the account USER has the same value as VENDOR Limitations Sixty four alphanumeric case sensitive characters VENDOR Required Your merchant login ID that you created when you registered for the account Limitations Sixty four alphanumeric case sensitive characters PARTNER Required The ID provided to you by the authorized PayPal Reseller who registered you for the Payflow SDK If you purchased your account directly from PayPal use PayPal Limitations Sixty four alphanumeric case sensitive characters PWD Required The password that you defined while registering for the account Limitations Six to thirty two alphanumeric case sensitive characters Sale Transaction Example In addition to the connection and user parameters each transaction type has additional parameter requirements and can include a number of optional parameters as well The transaction parameters common to all processors are descri
54. types you must contact your acquiring bank the merchant that holds 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 you must add the card to your Payflow Pro account through PayPal help for details Manager See PayPal Manager online Parameters Used in Credit Card Transactions All credit card processors accept the basic parameters exception the PayPal processor does not support SWI described in the table below with one PE Some processors require additional parameters described the following sections e Additional Reporting Parameters on page 143 TABLE 4 1 Credit card transaction request parameters Processors Requiring Additional Transaction Parameters on page 65 Parameter Description TENDER A Automated clearinghouse C Credit card D Pinless debit K Telecheck P PayPal Required The method of payment Values are See the Payflow ACH Payment Service Guide for details on the Automated clearinghouse tender type TRXTYPE Required Indicates the type of transactio e S Sale transaction e Credit e A Authorization e D Delayed Capture e V Void e F Voice Authorization e I Inquiry e N Duplicate transaction n to perform Values are NOTE A type N transaction represents a duplicate transaction version 4 SDK or HTTPS interfa
55. used by merchants who authorize transactions through the payflow gateway but settle through a third party solution Character length and limitations 15 numeric characters 56 Website Payments Pro Payflow Edition Developer s Guide Responses to Transaction Requests BALAMT Response Parameter Stored Value Cards TABLE 6 8 Transaction response values Field Description AMEXPOSDATA Value returned when VERBOSITY MEDIUM or VERBOSITY HIGH Character length and limitations 12 alphanumeic characters BALAMT Response Parameter and Stored Value Cards BALAMT is a parameter that may be returned by transactions meeting Card Acceptance Processing Network CAPN requirements when that transaction involves a stored value card Stored value cards typically are offered as gift cards allowing the user to spend any amount up to the balance remaining on the card BALAMT returns the balance on the card provided that the card is active and is not compromised If the card is used to purchase merchandise exceeding the card balance American Express declines the transaction and returns the card balance in BALAMT For details on American Express CAPN request transaction parameters see Appendix C Submitting Purchasing Card Level 2 and Level 3 Transactions American Express CAPN Stored Value Card Example The Authorization request is for a purchase of 123 00 TRXTYPE A amp TENDER C amp PW
56. 04 125 L_DESCn 68 83 107 111 114 119 122 128 129 134 137 L_DISCOUNTn 111 114 119 122 128 129 134 L FREIGHTAMTn 101 108 L HANDLINGAMTn 102 108 L PICKUPCITYn 108 L PICKUPCOUNTRYn 108 L PICKUPSTATEn 108 L PICKUPSTREETn 108 L PICKUPZIPn 108 L PRODCODEn 107 114 128 129 L 103 125 173 174 L_QTY2 103 125 L_QTY3 103 125 L_QTY4 104 125 L_QTYn 68 83 102 107 111 114 119 122 128 129 134 L_TAXAMTn 107 111 114 119 122 129 134 137 L_TAXRATEn 119 122 129 134 137 L_TAXTYPEn 119 128 134 L TRACKINGNUMn 108 L UNSPSCCODEn 108 L UOMn 107 114 119 122 128 129 134 137 L UPCn 107 111 119 122 129 134 137 LASTNAME 27 31 36 37 41 73 74 88 112 145 LOCALTAXAMT 118 120 133 135 MERCHANTCITY 70 85 104 125 MERCHANTCOUNTRYCODE 70 86 104 126 MERCHANTNAME 70 85 104 125 MERCHANTSTATE 70 85 104 125 MERCHANTSTREET 70 85 104 125 MERCHANTZIP 70 86 104 126 MERCHDESCR 82 MERCHSVC 77 82 MICR 91 92 MIDDLENAME 31 36 37 41 NAME 91 92 146 NATIONALTAXAMT 118 120 133 135 ORDERDATE 73 74 88 112 120 135 ORDERDATETIME 73 75 89 ORDERTIME 113 ORIGID 30 35 37 38 57 PARMLIST 20 PARTNER 21 91 93 PHONENUM 31 36 37 68 69 80 81 83 84 93 PHONETYPE 68 80 83 PNREF 30 35 37 38 57 95 PONUM 31 36 37 103 105 106 109 110 113 117 118 120 124 126 131 132 133 135 146 PROCAVS 140 PROCCARDSECURE 140
57. 10 format as required by American Express during settlement processing About Purchasing Cards Purchasing Cards are used in the procurement process to eliminate paper based order systems and associated costs to improve control and accountability through itemized statements to foster better risk controls through spending limits and buying from approved vendors to reduce administrative overhead because employees are empowered to make small purchases and to enable enterprises to negotiate better contract pricing and discounts with suppliers through the use of vendor detail reports To promote acceptance and usage of Purchasing Card programs card issuers have established incentive rates for merchants These rates are available for merchants who comply at either Level 2 or Level 3 described in the next section Transactions that comply at Level 1 qualify as normal credit card transactions Card issuing institutions perform strict data verification on the enhanced data that is submitted with Level 2 or Level 3 transactions Issuers may charge stiff penalties if fields contain either inaccurate or filler data Only transactions that contain accurate data are eligible for the incentive rates About Program Levels The term Level does not apply to the card but to the transaction data submitted for that card Generally a higher level means more detailed data for reporting Table C 1 describes the transaction levels that are reco
58. 1234 56 not 1 234 56 Purchase order number Ship to postal code called zip code in the USA 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 Is the customer tax exempt Y or N Required No defaults to U Unknown No No No but provides best rate when used No but provides best rate when used No but provides best rate when used Type Alpha numeric Currency Currency Alpha numeric Numeric Currency Alpha Length 25 Payflow Pro Developer s Guide 109 Submitting Purchasing Card Level 2 and Level 3 Transactions First Data Merchant Services FDMS North Purchasing Card Transaction Processing First Data Merchant Services FDMS North Purchasing Card Transaction Processing The following parameters are recommended to obtain the best rates for Level 2 and Level 3 purchasing card transactions with FDMS North TABLE 6 FDMS North purchasing card parameters Parameter SHIPTOCOUNTRY DISCOUNT DUTYAMT FREIGHTAMT PONUM SHIPFROMZIP SHIPTOZIP Description Destination country code Visa and MasterCard are different Refer to country code tables See Appendix F ISO Country Codes Discount amount on total sale Sometimes called import tax If the currency uses a decimal then the value must include a decimal and the exact amount to th
59. 2 Payflow Pro Developer s Guide American Express Phoenix Level 2 Parameters CAPN Submitting Purchasing Card Level 2 and Level 3 Transactions American Express Phoenix Purchasing Card Transaction Processing TABLE C 2 American Express Phoenix CAPN Level 2 parameters Parameter Description CPC Level 2 Transaction Advice Addendum Parameters PONUM SHIPTOZIP TAXAMT L_DESC1 L_AMT1 L_OTY1 DESC2 L_AMT2 L QTY2 DESC3 L_AMT3 Purchase order number Ship to postal code called zip code in the USA This field must contain one of the following values e Zip code of the destination where the merchandise is to be shipped e If the above is not available Zip code of the location where the merchant executed the transaction Total tax amount Must include a decimal and be exact to the cent 42 00 not 42 and exclude comma separators 1234 56 not 1 234 56 Description of this line item if not provided DESCI if present is used 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 Quantity of this line item Description of this line item if not provided DESC2 if present is used 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 Quantity of this line item Description of
60. 2 case sensitive alphanumeric characters Set ORIGID to the PNREF Transaction ID in PayPal Manager reports value returned for the original transaction Inquiry Transaction Parameter String Using the PNREF This is an example Inquiry transaction parameter string using the ORIGID parameter set to the PNREF value TRXTYP 1 amp END ER C amp PARTN amp USER Super 38 ER PayPal amp VENDOR SuperMerchant erchant amp PWD xly2z3 amp ORIGID VPNE12564395 Payflow Pro Developer s Guide Credit Card Transactions Submitting Inquiry Transactions Required Parameters When Using the CUSTREF To submit an Inquiry transaction when using the CUSTREF you must pass the following parameter CUSTREF Optionally specify the STARTTIME and ENDTIME parameters The Inquiry transaction request parameters are described below TABLE 4 10 nquiry transaction request parameters when using the CUSTREF Parameter Description CUSTREF Required Merchant defined identifier for reporting and auditing purposes For example you can set CUSTREF to the invoice number You can use CUSTREF when performing Inquiry transactions To ensure that you can always access the correct transaction when performing an Inquiry you must provide a unique CUSTREF when submitting any transaction including retries Limitations 12 alphanumeric characters STARTTIME Opti
61. 45 amp L DISCOUNT1 25 amp amp L AMT1 75 amp L TAX AMT1 0 114 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions Global Payments Central Purchasing Card Transaction Processing 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 Both Level 2 parameters in Table C 10 are required to get the discount rate You must pass the following parameters TABLE C 10 Global Payments Central Level 2 parameters Mandatory Format Data Items Optional Payflow Parameter min max type Customer Code M CUSTCODE 1 16 Char Sales Tax M TAXAMT NUM 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 Example Global Payments Central Level 2 Visa or MasterCard Transaction Parameter String TRXTYPE S amp ACCT 5105105105105100 amp AMT 20 10 amp CITY Mountain View amp COMMENT1 L2 Test ing amp EXPDATE 1209 amp NAME Cardholder Name amp PARTNER PayPal amp PWD pwd amp STATE CA amp STREET 123 Main St amp TENDER C amp USER user amp Z1P 94043 amp CUSTCODE 123456 amp TAXAM
62. 6 Niue 570 Malta 470 Norfolk Island 574 Marshall Islands 584 Northern Mariana Islands 580 Martinique 474 Norway 578 Mauritania 478 Oman 512 Mauritius 480 Pakistan 586 Mayotte 175 Palau 585 Mexico 484 Panama 591 Micronesia Federated States of 583 Papua New Guinea 598 Moldova Republic of 498 Paraguay 600 Monaco 492 Peru 604 Mongolia 496 Philippines 608 Montserrat 500 Pitcairn 612 Morocco 504 Poland 616 Mozambique 508 Portugal 620 Myanmar formerly Burma 104 Puerto Rico 630 Payflow Pro Developer s Guide 149 ISO Country Codes 150 TABLE 1 1 50 country codes Country Name Namibia Nauru Nepal Netherlands Netherlands Antilles New Caledonia New Zealand Nicaragua Niger Nigeria Sao Tome and Principe Saudi Arabia Senegal Seychelles Sierra Leona Singapore Slovakia Slovak Republic Slovenia Solomon Islands Somalia South Africa South Georgia and the South Sandwich Islands Spain Sri Lanka St Helena St Pierre and Miquelon Sudan Suriname Svalbard and Jan Mayen Islands Code 516 520 524 528 530 540 554 558 562 566 678 682 686 690 694 702 703 705 90 706 710 239 724 144 654 666 736 740 744 Country Name Qatar Reunion Romania Russian Federation Rwanda Saint Kitts and Nevis Saint Lucia Saint Vincent and the Grenadines Samoa San Marino Tajikistan Tanzania United Republic of Thailand Togo Tokelau Tonga Trinidad and Tobago Tunisia
63. ABLE B 4 Sale Approved HOSTCODE values Code 000500 000501 000502 000504 000505 000800 000801 000802 000803 Response Sale Approved Sale Time out Test Card ANI Sale Approved PB Sale Approved Sale Approved Sale Approved Sale Approved Sale Approved Description Sale Approved by credit card network Sale transaction time out in credit card network Test card sale approved never billed 900 Telco sale approved Private billing sale approved Direct Check Sale ECA approved Direct Check Sale approved no ECA Direct Check Sale ECA approved no guarantee Direct Check Sale approved no ECA no guarantee Frequency Common Common Common ANI bill only PB only Direct Check Direct Check Direct Check Direct Check Payflow Pro Developer s Guide 95 Performing TeleCheck Electronic Check Transactions HOSTCODE Values TABLE B 5 Sale Declined HOSTCODE values Code Response Description Frequency 000300 Sale Declined Sale declined by credit card network Common 000301 Sale Rejected Sale does not meet risk standards Common 000804 Check Declined Direct Check Sale declined negative data Direct Check 000805 Check Declined Direct Check Sale Decline Scoring Direct Check 000807 Check Failure Direct Check Sale Direct Check TABLE B 6 Inquiry Approved HOSTCODE values Code Response Description Frequency 000400 OTB Approved Preauthorization approved AVS matches if provided Common 000401 No Response No respon
64. ACCT and AMT parameters The First Data Merchant Services FDMS South processing platform supports Sale and Credit transactions only 28 Payflow Pro Developer s Guide Credit Card Transactions Submitting Authorization Delayed Capture Transactions Typical Sale Transaction Parameter String The following is a typical PARMLIST string passed in a Sale transaction IRXTYPE S amp TENDER C amp USER SuperUser amp PWD SuperUserPassword amp VENDOR SuperUser amp PA RTNER PayPal amp ACCT 5105105105105100 amp EXPDATE 1209 amp CVV2 2123 amp AMT 99 00 amp FIRSTNAM E John amp LASTNAME Smith amp STREET 123 Main St amp CITY San JOSe amp STATE CA amp ZIP 12345 amp COMMENTl Reservation amp INVNUM 1234567890 amp PONUM C12345 amp CVV2 567 amp VERBOSITY MEDIUM Note that besides the required parameters that you pass in a Sale transaction this string includes other typical parameters The COMMENT1 and COMMENT2 fields help to track transaction information The customer s street address STREET and zip should be passed to use address verification service CVV2 is needed for card security code validation For details on address verification service and card security code see the following sections e Submitting Card Present SWIPE Transactions on page 42 e Card Security Code Validation on page 46 Submitting Authorization Delayed Capture Transactions An Autho
65. AMAICA JAPAN JORDAN KAZAKHSTAN KENYA KIRIBATI KOREA REPUBLIC OF KUWAIT KYRGYZSTAN LAO PEOPLES DEMOCRATIC LATVIA LEBANON GP GU GT GN GW GY HT HM HN HK HU IS IN ID IR IQ IE IT JM JP JO KE KI KR KW KG LA LV LB LESOTHO LIBERIA LIBYAN ARAB JAMAHIRIYA LIECHTNSTIEN LITHUANIA LUXEMBOURG MACAU MACEDONIA MADAGASCAR MALAWI MALAYSIA MALDIVES MALI MALTA MANACO MARSHALL ISLANDS MATINIQUE MAURITANIA MAURITIUS MAYOTTE MEXICO MICRONESIA MOLDOVA MONGOLIA MONTSERRAT MOROCCO MOZAMBIQUE MYANMAR NAMIBIA NAURU NEPAL LS LR LI LT LU MO MK MG MW MY MV ML MT MC MH MQ MR MU YT MX FM MD MN MS MA MZ MM NA NR NP Payflow Pro Developer s Guide 159 Codes Used by FDMS South Only Visa Country Codes TABLE G 2 Visa country codes TABLE G 2 Visa country codes NETHERLANDS NL SAUDI ARABIA SA NETHERLANDS ANTILLES AN SENEGAL SN NEW CALDONIA NC SEYCHELLES SC NEW ZEALAND NZ SIERRA LEONE SL NICARAGUA NI SINGAPORE SG NIGER NE ST HELENA SH NIGERIA NG ST KITTS NEVIS ANGUILLA KN NIUE NU ST LUCIA LC NORFOLK ISLAND NF ST PIERRE AND MIQUELON PM NORTHERN MARIANA ISLAND MP ST VINCENT AND THE VC GRENADINES NORWAY NO DAN D OMAN OM a P SURINAM SR PAKISTAN PK VALBARD amp JAN MAYEN IS PALAU PW E oa RE SWAZILAND SZ PANAMA PA SWEDEN SE PAPAU NEW GUINEA PG SWITZERLAND CH PARAGUAY PY YRIAN ARAB REPUBLI Y PERU PE eo E TAIW
66. AMOUNT of 2001 or more 13 Referral Use the AMOUNT 1013 Payflow Pro Developer s Guide 51 52 Credit Card Testing RESULT Values Returned Based on Transaction Amount TABLE 5 4 Obtaining RESULT value RESULT 19 22 23 24 25 29 30 50 99 100 101 103 104 105 108 111 112 113 114 Definition Original transaction ID not found Invalid ABA number Invalid account number Invalid expiration date Transaction type not mapped to this host Processor Invalid XML document Duplicate Transaction Insufficient funds available General error Invalid transaction returned from host Processor Time out value too small Error reading response from host Processor Timeout waiting for processor response Credit error Void error Capture error Failed AVS check Cannot exceed sales cap CVV2 Mismatch How to test using Payflow Pro Submit a Delayed Capture transaction with an invalid ORIGID Applies only to ACH transactions submit an invalid ABA number 8 digits Submit an invalid account number for example 000000000000000 Submit an invalid expiration date for example 0298 Submit a transaction for a card or tender you are not currently set up to accept for example a Diners card if you aren t set up to accept Diners Pass a bad XML document XMLPay users only Use the AMOUNT 1030 Only applies to Global Payments East and Central processors Use
67. AN PROVIDENCE OF CHINA TW PHILIPPINES PH TAJIKISTAN TJ PITCAIRN ISLAND PN TANZANIA UNITED REPUBLIC TZ POLAND PL THAILAND TH PORTUGUL PT T T PUERTO RICO PR DES id TOKELAU TK QATAR QA TONGA T REUNION RE kit id TRINIDAD AND TOBAGO TT ROMANIA RO TUNISIA TN RUSSIAN FERERATION RU TURKEY TR RWANDA RW TURKMENISTAN TM SAMOA WS TURKS amp CAICOS ISLANDS TC SAN MARINO SM TUVALU TV SAN TOME AND PRICIPEL ST 160 Payflow Pro Developer s Guide Codes Used by FDMS South Only ESI Units of Measure TABLE G 2 Visa country codes U S MINOR OUTLYING ISL UM UGANDA UG UKRAINIAN SSR UA UNITED ARAB EMIRATES AE UNITED KINGDOM GB UNITED STATES US URAGUAY UY 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 Units of Measure TABLE Units of measure TABLE G 3 Units of measure Ampere hour 3 6 kC AMH Acre 4840 yd2 ACR Are 100 m2 ARE Alcoholic strength by mass ASM Bar BAR Alcoholic strength by volume ASV Barrel petroleum 158 987 dm3 BLL Ampere AMP Becquerel BQL Billion EUR BIL Payflow Pro Developer s Guide 161 162 Codes Used by FDMS South Only Units of Measure TABLE G 3 Units of measure TABLE G 3 Units of measure Billion US Board foot Brake horse power 245 7 watts British thermal unit 1 055 ki
68. D x1y2z3 amp PARTNER PayPal amp VENDOR SuperMerchant amp USER Supe rMerchant amp ACCT 5555555555554444 amp EXPDATE 0308 amp AMT 123 00 amp STREET 5199 MAPLE amp ZIP 94588 Because the response returns a BALAMT of 99 00 the Authorization is declined RESULT 12 amp PNREF VXYZ01234567 amp RESPMSG DECLINED amp BALANCE 99 00 amp AVSADDR Y amp AVSZI P N PNREF Value The PNREF is a unique transaction identification number issued by PayPal that identifies the transaction for billing reporting and transaction data purposes The PNREF value appears in the Transaction ID column in PayPal Manager reports e The PNREF value is used as the ORIGID value original transaction ID in Delayed Capture transactions TRXTYPE D Credits TRXTYPE C Inquiries and Voids TRXTYPE V e The PNREF value is used as the ORIGID value original transaction ID value in reference transactions for Authorization TRXTYPE A and Sale TRXTYPE S NOTE The PNREF is also referred to as the Transaction ID in PayPal Manager Website Payments Pro Payflow Edition Developer s Guide 57 BE Responses to Transaction Requests RESULT Values and RESPMSG Text PNREF Format The PNREF is a 12 character string of printable characters for example e VADEOB248932 e ACRAF23DB3C4 Note Printable characters also include symbols other than letters and
69. DERDATET IME Order time and date No 19 Format is either YYYY MM DD or YYYY MM DD HH MI SS where HH is in 24 hour time If the value does not conform to one of the formats or if the date is not valid for example 2004 17 35 then the transaction is rejected with RESULT 7 SIG FIELD ERR RESPMSG Invalid ORDERTIME A truncated version of the ORDERTIME value up to 7 characters overwrites any value provided by ORDERDATE If no value is provided a NULL value is stored SWIPE Allows Track 1 and Track 2 data to be passed to No Alpha 80 enable a card present transaction numeric American Express Additional Credit Card Parameters Legacy In addition to the parameters in Table 4 1 Credit card transaction request parameters American Express Phoenix accepts the following legacy parameters Note Merchants in the United States follow the CAPN requirements and use the parameters described in Table A 1 international merchants do not and instead use the legacy Payflow Pro Developer s Guide 73 EE Processors Requiring Additional Transaction Parameters American Express TABLE A 2 American Express legacy parameters parameters described in Table A 2 There are a few exceptions If you are not sure contact Customer Service See How to Contact Customer Support on page 9 for contact information Parameter DESC DESC1 DESC2 DESC3 DESC4 FIRSTNAME
70. Do not include comma separators 1234 56 not 1 234 56 See FDMS South Currency Codes and Decimal Positions on page 166 Is the customer tax exempt Y or N Required No No but provides best rate when used No but provides best rate when used No but provides best rate when used No No No but provides best rate when used Type Alphanum eric Alpha numeric Numeric Numeric Alpha Alpha numeric Currency Alpha Length 19 25 80 10 FDMS South Line Item Parameters Line item data Level 3 describes the details of the item purchased and can be can be passed for each transaction The convention for passing line item data in name value pairs is that each Payflow Pro Developer s Guide 113 Submitting Purchasing Card Level 2 and Level 3 Transactions First Data Merchant Services South FDMS Purchasing Card Transaction Processing name value starts with L_ and ends with n where nis the line item number For example OTYO 1 is the quantity for line item 0 and is equal to 1 with n starting at 0 TABLE 9 FDMS South purchasing card line item parameters Parameter Description Required Type Length OTYn Quantity whole units only Yes Numeric 10 L COMMCODEn Item commodity code No Alpha 12 numeric DESCn Item description No Alpha 35 numeric L_UOMn Item unit of measure See Units of Measure on No Alpha 3 page 161 COSTh Cost per item
71. ER amp PARTNER PARTNER amp ACCT 4275330012345675 amp EXPDATE 0 209 amp AMT 12 59 amp VERBOSITY 1 amp STREET 123 main street amp ZIP 49801 amp CVV2 2 48 amp TAXAMT 1 22 amp PONUM AB12345678 amp SHIPTOZIP 98765 amp TAXEXEMPT N TSYS Acquiring Solutions Purchasing Card Transaction Processing TSYS Acquiring Solutions supports MasterCard and Visa for performing Level 2 and Level 3 purchasing card transactions TSYS Acquiring Solutions Level 2 Parameters TSYS Acquiring Solutions supports MasterCard and Visa for Level 2 purchasing card transactions TSYS Acquiring Solutions indicates in the authorization response whether or not the credit card in the transaction is a commercial card Based in the commercial card indicator PayPal will format the Level 2 information in the settlement request Payflow Pro Developer s Guide 131 Submitting Purchasing Card Level 2 and Level 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing Level 2 parameters marked as mandatory in Table C 27 are required to get the discount rate TABLE C 27 TSYS Acquiring Solutions Level 2 parameters Format Mandatory min max Name Optional Payflow Parameter type Cust Ref ID M PONUM 1 17 AN Tax Amount M TAXAMT NUM 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 Tax Amount TAXEXEMPT or N 1A Identifier Exa
72. HNSON amp TAXAMT 106 amp 21P 94588 amp ALTTAXAMT 1 00 amp CUSTVATREGNUM 11111 amp LOCALTAXAMT 1 01 amp NATIONALTAXAMT 1 0O2 amp COMMCODE 2 2222 amp VATAXAMT 1 03 amp VATAXPERCENT 55 amp TAXE XEMPT N amp DISCOUNT 50 amp FREIGHTAMT 1 00 amp DUTYAMT 1 00 amp SH TP 44444 amp SHIPTOCOUNTRY 8 40 amp ORDERDATE 0811258 amp 1 1 1 item 1 L COMMCODE1 123456789ABC amp L_D IPTOZIP 33333 amp SHIPFROMZ ESC description amp L UPC1 CBA987654321 amp L QTY1 1 amp L UOM1 123456789012 amp L COST1 1 50 amp L _TAXAMT1 1 05 amp L_TAXRAT Payflow Pro Developer s Guide E1 12 amp L DISCOUNT1 50 amp 1 L AMT1 1 00 amp L_TAXTYPE1 TT1 137 Submitting Purchasing Card Level 2 and Level 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing 138 Payflow Pro Developer s Guide VERBOSITY Viewing Processor Specific Transaction Results Transaction results especially values for declines and error conditions returned by each PayPal supported processor vary in detail level and in format The Payflow VERBOSITY parameter described below enables you to control the kind and level of information you want returned TABLE D 1 VERBOSITY parameter Parameter Description VERBOSITY Optional Enables you to obtain additional processor information for a transaction V
73. HTNSTIEN LIE GUATEMALA GIM LITHUANIA LTU GUINEA GIN LUXEMBOURG LUX GUINEA BISSAU GNB MACAU MAC GUYANA GUY MALAYSIA MYS HAITI HTI MALDIVES MDV HEARD amp MCDONALDS ISLAND HMD MALI MLI HONDURAS HND MALTA MLT HONG KONG HKG MANACO MCO HUNGARY HUN MARSHALL ISLANDS MHL ICELAND ISL MATINIQUE MTQ INDIA IND MAURITANIA MRT INDONESIA IDN MAURITIUS MUS IRAN IRN MEXICO MEX IRAQ IRQ MICRONESIA FSM IRELAND IRL MOLDOVA MDA ISRAEL ISR MONGOLIA MNG ITALY ITA MONTSERRAT MSR JAMAICA JAM MOROCCO MAR JAPAN JPN MOZAMBIQUE MOZ JORDAN JOR MYANMAR MMR KAZAKHSTAN KAZ NAMIBIA NAM KENYA KEN NAURU NRU KOREA REPUBLIC OF KOR NEGEL SEN KUWAIT KWT NEPAL NPL KYRGYZSTAN KGZ NETHERLANDS NLD LATVIA LVA NETHERLANDS ANTILLES ANT LEBANON LBN NEW CALDONIA NCL LESOTHO LSO NEW ZEALAND NZL LIBERIA LBR NICARAGUA NIC LIBYAN ARAB JAMAHIRIYA LBY NIGER NER Payflow Pro Developer s Guide 155 Codes Used by FDMS South Only MasterCard Country Codes TABLE G 1 MasterCard country codes TABLE G 1 MasterCard country codes NIGERIA NGA ST LUCIA LCA NIUE NIU ST PIERRE AND MIQUELON SPM NORFOLK ISLAND NFK ST VINCENT AND THE VCT GRENADINES NORTHERN MARIANA ISLAND MNP SUDAN SDN NORWAY NOR RINAM R OMAN OMN ix E SVALBARD amp JAN MAYEN IS SJM PAKISTAN PAK SWAZILAND SWZ PALAU PLW SWEDEN SWE PANAMA PAN SWITZERLAND CHE PAPAU NEW GUINEA PNG SYRIAN ARAB REPUBLIC SYR PARAGUAY PRY TAIWAN PROVIDENCE OF CHINA TWN PERU PER TAJIKISTAN TJK PHILIPPINES PHI TANZANIA
74. IP 94065 amp D ESC Descriptor amp DESCl Descriptorl amp DESC2 Descriptor2 amp DESC3 Descriptor3 amp DESC4 Descriptor4 Paymentech Salem New Hampshire Level 3 Purchasing Card Parameters Paymentech Salem New Hampshire supports Level 3 parameters for MasterCard and Visa Both Level 2 transaction parameters are required for Level 3 transactions Level 3 transactions that do not include the Level 2 values are rejected Paymentech Salem New Hampshire Level 2 Parameters Required for Level 3 Transactions Both Level 2 parameters listed in Table C 23 are required to get the discount rate TABLE C 23 Paymentech Salem New Hampshire Level 2 parameters Format Paymentech Data Mandatory min max Items Optional Payflow Parameter type Customer Ref No M PONUM 1 17 char Sales Tax M TAXAMT NUM Must include a decimal and be exact to the cent 42 00 not 42 and exclude comma separators 1234 56 not 1 234 56 To qualify for Level 2 discounts this value must not be all zeros or blank spaces Payflow Pro Developer s Guide 127 Submitting Purchasing Card Level 2 and Level 3 Transactions Paymentech Salem New Hampshire Purchasing Card Transaction Processing Paymentech Salem New Hampshire Level 3 MasterCard Parameters TABLE C 24 Paymentech Salem New Hampshire Level 3 MasterCard order and line item parameters
75. Manager reports Limitations 12 case sensitive alphanumeric characters Set ORIGID to the PNREF Transaction ID in PayPal Manager reports value returned for the original transaction Fields Copied From the Original Transaction into the Void Transaction The following fields are copied from the original transaction into the Void transaction if they exist in the original transaction If you provide a new value for any of these parameters when submitting the Void transaction then the new value is used Exceptions are ACCT EXPDATE and SWIPE These parameters retain their original values For processors that use the RI ECURRJ NG parameter If the RECURRING parameter was set to Y for the original transaction then the setting is ignored when forming the Void transaction TABLE 4 8 Fields copied from original Void transaction ACCT AMT COMMENT2 COMPANYNAME CUSTIP DUTYAMT FIRSTNAME MIDDLENAME INVNUM PONUM SHIPTOFIRSTNAME SHIPTOMIDDLENAME SHIPTOSTREET SHIPTOZIP SWIPE TAXAMT ZIP CITY BILLTOCOUNTRY EMAIL LASTNAME SHIPTOCITY SHIPTOLASTNAME STATE PHONENUM COMMENT1 CUSTCODE EXPDATE FREIGHTAMT SHIPTOCOUNTRY SHIPTOSTATE STREET TAXEXEMPT Example Void Transaction Parameter
76. Mapping You are trying to process a tender type such as Discover Card but you are not set up with your merchant bank to accept this card type e You are trying to process a tender type such as Discover Card but you are not set up with your merchant bank to accept this card type e You are trying to process an Express Checkout transaction when your account is not set up to do so Contact your account holder to have Express Checkout added to your account Invalid vendor account Login information is incorrect Verify that USER VENDOR PARTNER and PASSWORD have been entered correctly VENDOR is your merchant ID and USER is the same as VENDOR unless you created a Payflow Pro user All fields are case sensitive Insufficient partner permissions Insufficient user permissions Invalid XML document This could be caused by an unrecognized XML tag or a bad XML format that cannot be parsed by the system Duplicate transaction Error in adding the recurring profile Error in modifying the recurring profile Error in canceling the recurring profile Error in forcing the recurring profile Error in reactivating the recurring profile OLTP Transaction failed Invalid recurring profile ID Insufficient funds available in account Exceeds per transaction limit General error See RESPMSG Transaction type not supported by host Time out value too small Processor not available Error reading response from host Website Payments Pro Payflow Edition Deve
77. O amp DUTYAMT 3 0O0 amp SHIPTOZI P 94543 amp SHIPTOCOUNTRY 8 40 amp SHIPFROMZIP 94509 amp DISCOUNT 4 OO amp VATAXAMT 5 OO amp VAT AXPERCENT 10 amp L_DESC1 TSYS Acquiring Solutions Pcard amp L_UPC1 1 amp L_UOM1 2 amp L_OTY 1 3 amp L TAXAMT1 4 amp L TAXRATE1 5 amp L AMT1 6 amp L DISCOUNT1 7 amp L COMMCODE1 8 amp L 5 1 9 amp L COST1 10 Paymentech Tampa Level 2 Purchasing Card Transaction Processing Paymentech Tampa supports Level 2 purchasing card processing for MasterCard and Visa 130 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing Paymentech Tampa Level 2 Parameters TABLE C 26 Paymentech Tampa Level 2 parameters Format Paymentech Mandatory min max Data Items Optional Payflow Parameter type Customer Ref M PONUM 1 17 char No Sales Tax M TAXAMT NUM 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 Tax Exempt TAXEXEMPT Y or N 1 Contact your acquiring bank to determine if your transactions are tax exempt Ship to ZIP SHIPTOZIP 1 16 Code called zip code in the USA Example Paymentech Tampa Level 2 Visa and MasterCard Transaction Parameter String TRXTYPE S amp TENDER C amp PWD PWD amp USER US
78. PONUM 25 AN Value of TransID is sent if no value is provided Tax Amt M TAXAMT NUM 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 Lcl Tax LOCALTAXAMT 12 NUM Lcl Tax Incl Flag Y or N 1 AN National Tax Amt NAT IONALTAXAMT 12 NUM You may omit this parameter if there is no such tax Purch Ord Cust M INVNUM 9 AN Ref ID Value of PNREF is sent if no value is provided TSYS Acquiring Solutions Level 3 MasterCard Extended Data The parameters listed in Table C 29 apply to Level 3 MasterCard transactions as extended data TABLE C 29 TSYS Acquiring Solutions Level 3 MasterCard Extended Data Mandatory Length Name Optional Payflow Parameter Data Type Freight Amt FREIGHTAMT 12 NUM Duty Amt DUTYAMT 12 NUM Dest Postal ZIP Code M SHIPTOZIP 10 AN The zip code of the address to which the goods are shipped Ship from Postal ZIP M SHIPFROMZIP 10 AN Code The postal code called zip code in the USA from which shipping occurs Dest Country Code SHIPTOCOUNTRY 4 AN Alt Tax Amt O ALTTAXAMT 9 NUM Payflow Pro Developer s Guide 133 134 Submitting Purchasing Card Level 2 and Level 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing TSYS Acquiring Solutions Level 3 MasterCard Line item Detail Records TABLE C 30 TSYS Acquiring Solut
79. PT Y or N 1 AN National Tax Amt O NAT IONALTAXAMT 12 NUM Purch Ord Cust M INVNUM 9 AN Ref ID Value of TransID is sent if no value is provided TSYS Acquiring Solutions Level 3 Visa Extended Data The parameters listed in Table C 32 apply to Level 3 Visa transactions as extended data TABLE C 32 TSYS Acquiring Solutions Level 3 Visa extended data Mandatory Length Name Optional Payflow Parameter Data Type Summary Commodity M COMMCODE 4 AN Code Commodity code identifier for the business Discount Amt DISCOUNT 12 NUM Freight Amt M FREIGHTAMT 12 NUM Duty Amt DUTYAMT 12 NUM Order Date ORDERDATE 6 NUM Format is yymmdd with no slashes or dashes For example November 28 2008 is 081128 Dest Postal ZIP Code M SHIPTOZIP 10 AN The zip code of the address to which the goods are shipped Payflow Pro Developer s Guide 135 136 Submitting Purchasing Card Level 2 and Level 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing TABLE C 32 TSYS Acquiring Solutions Level 3 Visa extended data Continued Name Ship from Postal ZIP Code Dest Country Code VAT Registration Number Unique VAT Inv Ref Cust VAT Registr VAT Tax Amt Freight Ship VAT Tax Rate Freight Ship Mandatory Optional M Length Payflow Parameter Data Type SHIPFROMZIP 10 AN The postal code called zip code in the USA from which shipping occurs
80. Parameters CAPN The Paymentech Salem New Hampshire platform supports Level 2 parameters for American Express MasterCard Visa and Switch Solo Maestro The parameters to meet card acceptance and processor network CAPN requirements are described in Table C 21 Level 2 parameters supported for legacy applications are described in Table C 22 Note Most merchants in the United States follow CAPN requirements international merchants do not There are a few exceptions If you are not sure contact Customer Service See How to Contact Customer Support on page 9 for contact information TABLE C 21 Paymentech Salem New Hampshire CAPN Level 2 parameters Parameter Description Required Type Length CPC Level 2 Transaction Advice Addendum Parameters PONUM Purchase order number Yes Alpha 17 numeric SHIPTOZIP Ship to postal code called zip code in the USA Yes Alpha 15 numeric TAXAMT Total tax amount No Numeric 12 Must include a decimal and be exact to the cent 42 00 not 42 and exclude comma separators 1234 56 not 1 234 56 124 Payflow Pro Developer s Guide TABLE C 21 Paymentech Salem New Hampshire CAPN Level 2 parameters Submitting Purchasing Card Level 2 and Level 3 Transactions Paymentech Salem New Hampshire Purchasing Card Transaction Processing Parameter DESC1 L_AMT1 L_OTY1 DESC2 L_AMT2 L QTY2 DESC3 L_AMT3 DESC4 L_AMT4
81. PayPal Payflow Pro Developer s Guide Last updated October 2009 Payflow Pro Developer s Guide Document Number 200010 en_US 200910 2009 PayPal Inc All rights reserved PayPal is a registered trademark of PayPal Inc The PayPal logo is a trademark of PayPal Inc Other trademarks and brands are the property of their respective owners The information in this document belongs to PayPal Inc It may not be used reproduced or disclosed without the written approval of PayPal Inc Copyright PayPal All rights reserved PayPal Europe S r l et Cie S C A Soci t en Commandite par Actions Registered office 22 24 Boulevard Royal L 2449 Luxembourg R C S Luxembourg B 118 349 Consumer advisory The PayPal payment service is regarded as a stored value facility under Singapore law As such it does not require the approval of the Monetary Authority of Singapore You are advised to read the terms and conditions carefully Notice of non liability PayPal Inc is providing the information in this document to you AS IS with all faults PayPal Inc makes no warranties of any kind whether express implied or statutory with respect to the information contained herein PayPal Inc assumes no liability for damages whether direct or indirect caused by errors or omissions or resulting from the use of this document or the information contained in this document or resulting from the application or use of the product or s
82. R KTN KVR KVT KVA KWT KWH KNT LEF GLL QTL LTR LPA LTN CWI LUM LUX MHZ MAL 163 Codes Used by FDMS South Only Units of Measure TABLE G 3 Units of measure TABLE G 3 Units of measure Megametre Megapascal Megavolt ampere 1000 KVA Megawatt Megawatt hour 100 kW h Metre per second squared Metre per second Metre Metric carat 200 mg 2 10 4 kg Metric ton 1000 kg Milliard Millibar Millicurie Milligram Millilitre Millimetre Million Million cubic metres Million international units Minute Month Nautical mile 1852 m Net register ton Newton Number Number of articles Number of bobbons Number of cells Number of international units Number of packs Number of pairs MAM MPA MVA MAW MWH MSK MTS MTR CTM TNE MLD MBR MCU MGM MLT MMT MIO HMQ MIU MIN MON NMI NTT NEW NMB NAR NBB NCL NIU NMP NMR Number of parcels Number of parts Number of rolls Ohm Ounce GB US 28 349523 g Ounce GB US 31 103448 g syn Troy ounce Pascal Pennyweight GB US 1555174 g Piece Pint 0 568262 dm3 Pound GB US 0 45359237 kg Proof gallon Quart 1 136523 dm3 Quarter of a year Quarter GB 12 700586 kg Quintal metric 100 kg Revolution per minute Revolution per second Score scruple GB 1 2955982 g Second Set Shipping ton Short standard 7200 matches Short ton GB US 0 90718474 t Siemens
83. RIGID Required by some transaction types ID of the original transaction that is being referenced This ID is returned by the PNREF parameter and appears as the Transaction ID in PayPal Manager reports Limitations 12 case sensitive alphanumeric characters Set ORIGID to the PNREF Transaction ID in PayPal Manager reports value returned from the original transaction In addition if the amount of the capture differs from the amount of the Authorization you also must pass a value for AMT Fields Copied From the Authorization Transaction into the Delayed Capture Transaction The following fields are copied from the Authorization transaction into the Delayed Capture transaction if they exist in the original transaction If you provide a new value for any of these parameters when submitting the Delayed Capture transaction then the new value is 30 Payflow Pro Developer s Guide used Exceptions are ACCT EXPDATE and SWI values Credit Card Transactions Submitting Authorization Delayed Capture Transactions P E These parameters retain their original TABLE 4 3 Fields copied from Authorization to Delayed Capture transaction ACCT AMT CITY COMMENT1 COMMENT2 COMPANYNAME BILLTOCOUNTRY CUSTCODE CUSTIP DUTYAMT EMAIL EXPDATE FIRSTNAME MIDDLENAME LA
84. SHIPFROMZ IP 44444 amp SHIPTOCOUNTRY 840 amp ORDERDATE 020725 amp L COMMCODE1 2123456789ABC amp L DESC 1 1 item 1 description amp L_UPC1 CBA987654321 amp L_OTY1 1 amp L_UOM1 123456789012 amp L_COST1 1 50 amp L _TAXAMT1 1 05 amp L_TAXRATE1 12 amp L_DISCOUNT1 50 amp L_AMT1 1 00 amp L_TAXTYPE1 TT1 122 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions Elavon Formerly Nova Purchasing Card Transaction Processing Elavon Formerly Nova Purchasing Card Transaction Processing Elavon supports Level 2 for Visa or MasterCard Sale Credit or Delayed Capture transactions Elavon Level 2 Parameters Both Level 2 parameters listed in Table C 19 are required to get the discount rate You must pass these parameters in Authorization and Sale transactions TABLE C 19 Elavon Level 2 parameters Mandatory Data Items Optional Payflow Parameter Customer M CUSTCODE Code Value of ServerID TransID is sent if no value is provided Sales Tax M TAXAMT Value of 0 zero is sent if no value is provided 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 Format min max type 1 16 char NUM Elavon Additional Parameters The following parameters ar
85. STNAME FREIGHTAMT INVNUM PONUM SHIPTOCITY SHIPTOCOUNTRY SHIPTOFIRSTNAME SHIPTOMIDDLENAME SHIPTOLASTNAME SHIPTOSTATE SHIPTOSTREET SHIPTOZIP STATE STREET SWIPE TAXAMT PHONENUM TAXEXEMPT ZIP To perform the Delayed Capture 1 Perform the Authorization transaction The Authorization transaction uses the same parameters as Sale transactions except that the transaction type is A The return data for an Authorization transaction is the same as for a Sale transaction To capture the authorized funds perform a Delayed Capture transaction that includes the value returned for PNREF as described in Step 2 below Example Au TRXTYPE A amp TI ENDER C amp PWI thorization only Transaction D x1y2z3 amp PARTNER PayPal amp VENDOR SuperMerchant amp USER S uperMerchant amp ACCT 5555555555554444 amp EXPDATE 0308 amp AMT 1 nd purchase amp COMMENT2 MAPLE amp ZIP 94588 risk customer amp INVNUM 1234567 Example Authorization Response RESULT 0 amp PNRI amp AVSADDR Y amp AVSZIP N Payflow Pro Developer s Guide EF VXYZ01234567 amp RESPMSG APPROVED amp AUTHCODI Lr 23 00 amp COMMENT1 Seco 89 amp STREET 5199 123456 31 Credit Card Transactions Submitting Account Verifications With TRXTYPE A 2 Perform the Delayed Capture transaction Set ORIGID to the PNREF value returned in the original Authorization transaction response strin
86. String This is an example Void transaction parameter string Payflow Pro Developer s Guide 37 pea Credit Card Transactions Submitting Inquiry Transactions TRXTYPE V amp PWD x1y2z3 amp 0 TEND ER C amp PARTNER PayPal amp V RIGID VPN E12564395 ENDOR SuperMerchant amp US ER SuperMerchant amp Submitting Inquiry Transactions An Inquiry transaction TRXTYPE 1 returns the result and status of a transaction When To Use an Inquiry Transaction You perform an inquiry using a reference to an original transaction either the PNREF value returned for the original transaction or the CUSTREF value that you specified for the original transaction While the amount of information returned in an Inquiry transaction depends upon the VERBOS TY setting Inquiry responses mimic the verbosity level of the original transaction as much as possible For details on VERBOSITY see VERBOSITY Viewing Processor Specific Transaction Results on page 137 Required Parameters When Using the PNREF To submit an Inquiry transaction when using the PNREF you must pass the following parameter ORIGID TABLE 4 9 nquiry request required parameter when using the PNREF Parameter Description ORIGID Required by some transaction types ID of the original transaction that is being referenced This ID is returned by the PNREF parameter Limitations 1
87. T 1 34 Global Payments East Purchasing Card Transaction Processing Global Payments East NDCE supports Level 2 parameters for American Express MasterCard and Visa Payflow Pro Developer s Guide 115 Submitting Purchasing Card Level 2 and Level 3 Transactions Merchant e Solutions Purchasing Card Transaction Processing Global Payments East Level 2 Parameters Both Level 2 parameters listed in Table C 11 are required to get the discount rate You must pass these parameters in Authorization and Sale transactions TABLE C 11 Global Payments East Level 2 parameters Length Data Items Payflow Parameter Required Type min max Customer Code CUSTCODE Yes char 1 16 Sales Tax TAXAMT Yes numeric 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 Example Global Payments East Level 2 Visa or MasterCard Transaction Parameter String TRXTYPE S amp ACCT 5105105105105100 amp AMT 20 10 amp CITY Mountain View amp COMMENT1 L2 Test ing amp EXPDATE 1209 amp NAME Cardholder Name amp PARTNER PayPal amp PWD pwd amp STATE CA amp STREET 123 Main St amp TENDER C amp USER user amp ZIP 94043 amp CUSTCODE 123456 amp TAXAMT 1 34 Global Payments Central MAPP supports Level 2 for MasterCard and Visa Sale Credit and Delayed Capture transactions
88. UNITED REPUBLIC TZA PITCAIRN ISLAND PCN THAILAND THA POLAND POL T T PORTUGUL PRT iis ES TOKELAU TKL PUERTO RICO PRI TONGA TON QATAR QAT TRINIDAD AND TOBAGO TTO REUNION REU TUNISIA TUN ROMANIA ROM UNS iu TURKEY TR RUSSIAN FERERATION RUS TURKMENISTAN TM RWANDA RWA TURK AI ISLAND T SAMOA WSM URKS amp CAICOS IS S C TUVALU TUV SAN MARINO SMR J S MINOR OUTLYING ISL MI SAN TOME AND PRICIPEL STP He SEDE TE n JGANDA A SAUDI ARABIA SAU ld bis UKRAINIAN SSR UKR SEYCHELLES SYC UNITED ARAB EMIRATES ARE SIERRA LEONE SLE JNITED KINGDOM BR SINGAPORE SGP BS UNITED STATES USA ST HELENA SHN URAGUAY URY ST KITTS NEVIS ANGUILLA KNA 156 Payflow Pro Developer s Guide Codes Used by FDMS South Only Visa Country Codes TABLE G 1 MasterCard country codes UZBEKISTAN UZB VANUATU VUT VATICAN CITY STATE VAT VENEZUELA VEN VIETNAM VNM VIRGIN ISLANDS BRITISH VGB VIRGIN ISLANDS US VIR WALLIS AND FUTUNA IS WLF WESTERN SAHARA ESH YEMEN YEM YUGOSLAVIA YUG ZAIRE ZAR ZAMBIA ZMB ZIMBABWE RHO Visa Country Codes TABLE 6 2 Visa country codes TABLE G 2 Visa country codes ARUBA AW ALBANIA AL AUSTRALIA AU ALGERIA DZ AUSTRIA AT AMERICAN SAMOA AS AZERBAIJAN AZ ANDORRA AD BAHAMAS BS ANGOLA AO BAHRAIN BH ANGUILLA AI BANGLADESH BD ANTARCTICA AQ BARBADOS BB ANTIGUA AG BELARUS BY APHGANISTAN AF BELGIUM BE ARGENTINA AR BELIZE BZ ARMENIA AM BENIN BJ BERMUDA BM Payflow Pro Developer s Guide 157
89. Used by FDMS South Only Units of Measure TABLE G 3 Units of measure Gross Gross register ton Half year six months Hectare Hectobar Hectogram Hectokilogram Hectolitre of pure alcohol Hectolitre Hectometre Hertz Hour Hundred Hundred boxes Hundred international units Hundred leaves Hundred packs Hundredweight US 45 3592 kg Inch 25 4 mm Joule Kelvin Kilobar Kilogram of caustic potash Kilogram of caustic soda Kilogram of named substance Kilogram of nitrogen Kilogram of phosphonic anhydride Kilogram of phosphorus pentoxide Kilogram of potassium hydroxide Kilogram of potassium oxide GRO GRT SAN HAR HBA HGM DTH HPA HLT HMT HTZ HUR CEN BHX HIU CLF CNP CWA INH JOU KEL KPH KSH KNS KNI KPP KPP KPH Payflow Pro Developer s Guide Kilogram of sodium hydroxide Kilogram of substance 90 percent dry Kilogram per cubic meter Kilogram per second Kilogram Kilohertz Kilojoule Kilometre per hour Kilometre Kilopascal Kilorgram of uranium Kilotonne Kilovar Kilovolt Kilovolt ampere Kilowatt Kilowatt hour Knot 1 nautical mile per hour Leaf Liquid gallon 3 78541 dm3 Liquid pint 0 473176 dm3 Liquid quart 0 946353 dm3 Litre 1 dm3 Litre of pure alcohol Long ton GB US 1 0160469 t long hundredweight GB 50 802345 kg Lumen Lux Megahertz Megalitre KSH KSD KMQ KGS KGM KHZ KJO KMH KMT KPA KU
90. Y2 1 amp L UPCI PN amp L DESC2 Test amp L UOM2 12 amp L COST2 1 00 amp L PRODCODE2 1234 amp L COSTCENTERNUM2 55 amp L T AXAMT2 1 00 amp REQNAME Robert amp SHIPTOZIP 543210 amp INVNUM 123456789 amp VERBOSITY 2 First Data Merchant Services FDMS Nashville Purchasing Card Transaction Processing Note FDMS Nashville supports Level 2 transaction processing only 108 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions First Data Merchant Services FDMS Nashville Purchasing Card Transaction Processing The following parameters are recommended to obtain the best rates for purchasing card transactions with FDMS Nashville TABLE 5 FDMS commercial card parameters Parameter COMMCARD DUTYAMT FREIGHTAMT PONUM SHIPTOZIP TAXAMT TAXEXEMPT Description One character value representing type of purchasing card account number sent P Purchase Card C Corporate Card B Business Card U Unknown default N None Sometimes called import tax The value must include a decimal and the exact amount to the cent 42 00 not 42 Do not include comma separators 1234 56 not 1 234 56 Freight amount The value must include a decimal and the exact amount to the cent 42 00 not 42 Do not include comma separators
91. a Merchant Services FDMS North First Data Merchant Services FDMS South First Data TeleCheck Global Payments Central Global Payments East Merchant e Solutions Elavon Formerly Nova Paymentech Salem New Hampshire Paymentech Tampa TSYS Acquiring Solutions Formerly Vital Processing Services Moneris Solutions Payflow Pro Developer s Guide Introduction Supported Payment Types Supported Payment Types Payflow Pro supports multiple payment types in a single installation including e Credit cards e PayPal supported by PayPal s Express Checkout product e Pinless debit cards e Electronic checks e Check cards e Purchasing cards also referred to as commercial cards corporate cards procurement cards or business cards Level II and Level III e Automated Clearing House ACH For information on performing ACH transactions contact your PayPal Sales Representative at paymentsales PayPal com Payflow Pro Recurring Billing Service The Recurring Billing Service is a scheduled payment solution that enables you to automatically bill your customers at regular intervals for example a monthly fee of 42 for 36 months with an initial fee of 129 You enroll separately for the Payflow Pro Recurring Billing Service Using Payflow Pro to define and manage recurring transactions programmatically is described in Payflow Pro Recurring Billing Service User s Guide You can manage Recurring Billing tasks in PayP
92. a library e HTTPS interface Using the HTTPS interface you can build your own API by posting directly to the Payflow servers via HTTPS Note If you prefer to have Payflow Pro integration performed for you you can obtain Payflow Pro pre integrated with leading e commerce solutions For a list of pre integrated solutions see the Partner Solutions gt Shopping Carts page on PayPal Developer Central Payflow Pro Documentation Payflow Pro is described in the Payflow Pro documentation set on PayPal Developer Central If you are implementing PayPal as a solution into your website use this guide for general guidelines and guidelines on integrating credit card processing If you are also implementing PayPal Express Checkout as a payment solution see the Express Checkout for Payflow Pro guide for integration details Host Addresses Use the following host addresses for the Payflow V4 SDK e For live transactions use payflowpro paypal com e For testing purposes use pilot payflowpro paypal com How Payflow Pro Works Payflow Pro uses a client server architecture to transfer transaction data from you to the processing networks and then returns the authorization results to you Payflow Pro can process real time credit card transactions and other transaction types to most of the financial processing centers in the United States Payflow Pro Developer s Guide 13 Introduction Supported Processing Platforms 1 The Payflow client encry
93. acter Y N X or no response Address Verification Service address response returned if you are using Address Verification Service Address Verification Service address responses are for advice only This process does not affect the outcome of the authorization Character length and limitations 1 alpha character Y N X or no response International Address Verification Service address responses may be returned if you are using Address Verification Service AVS responses are for advice only This value does not affect the outcome of the transaction Indicates whether Address Verification Service response is international Y US N or cannot be determined X Client version 3 06 or later is required Character length and limitations 1 alpha character Y N X or no response Address Verification Service response from the processor when you use Address Verification Service and send a VERBOSITY request parameter value of MEDIUM Character length and limitations 1 character CVV2 response from the processor when you send a VERBOSITY request parameter value of MEDIUM Character length and limitations 1 character Value used for tracking this Direct Payment transaction Character length and limitations 13 alphanumeric characters Unique transaction ID returned when VERBOSITY MEDIUM or VERBOSITY HIGH for tracking American Express CAPN transactions NoTE American Express CAPN transactions only
94. al Manager See the online help for details About Security It is your responsibility to protect your passwords and other confidential data and to implement security safeguards on your website and in your organization or to ensure that your hosting company or internal web operations team is implementing them on your behalf IMPORTANT To enable testing of Payflow Pro PayPal provides sample transaction scripts that you customize with your Payflow Pro account information and password Because the password is initially stored in the text of the program it is vulnerable Do not use the test scripts in your production environment To minimize fraud machine passwords should always be encrypted You must write a program that encrypts and decrypts your Payflow Pro account password Payflow Pro Developer s Guide 15 Introduction About Security 16 Payflow Pro Developer s Guide Downloading Installing and Activating The Payflow Software Development Kit SDK is a set of APIs to allow you to integrate Payflow Pro with your application or website IMPORTANT Full API documentation is included with each SDK Supported Platforms Payflow Pro is available on all major web server platforms in a variety of formats to support your integration requirements Payflow Pro is available as a NET or Java library or you can build your own API by posting directly to the Payflow servers via HTTPS Preparing the Payflow Client App
95. ale or Authorization transaction e Authorization To capture the funds for an approved Authorization transaction be sure to perform a Delayed Capture transaction not a Reference transaction e Credit e Delayed Capture e Sale e Voice Authorization The Voice Authorization code is not copied to the new transaction e Void Fields Copied From Reference Transactions The following fields are copied from the reference transaction into the new Sale or Authorization transaction if they exist in the original transaction If you provide a value for any of these parameters when submitting the new transaction then the new value is used TABLE 4 11 Fields copied from reference transactions ACCTTYPE STREET ACCT CIIY EXPDATE STATE FIRSTNAME ZIP IDDLENAME BILLTOCOUNTRY LASTNAME SWIPE 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 transaction You charge the 34 for the final part of the shipment using a reference transaction to draw credit card and shipping address information from the initial Authorization transaction This example procedure creates a reference transaction Payflow Pro Developer s Guide 41 42 Credit Card Transactions Submitting Card Present SWIPE Transactions 1 Submit the initial transaction su
96. alues are LOW or MEDIUM e LOWis the default setting normalized values e MEDIUM returns the processor s raw response values VERBOSITY is also part of an Inquiry transaction For more information see Submitting Inquiry Transactions on page 38 By default VERBOSITY is set to LOW A LOW setting causes PayPal to normalize the transaction result values Normalizing the values limits them to a standardized set of values and simplifies the process of integrating the Payflow SDK By setting VERBOSITY to MEDIUM you can view the processor s raw response values This setting is more verbose than the LOW setting in that it returns more detailed processor specific information Supported Verbosity Settings The following VERBOSITY settings are supported for PayPal supported processors Contact your processor or bank for definitions of the returned values e LOW This is the default setting for PayPal accounts The following values are returned RESULT PNREF RESPMSG AUTHCODE AVSADDR AVSZIP CVV2MATCH IAVS CARDSECURE e MEDIUM All of the values returned for a LOW setting plus the following values Note For information on interpreting the responses returned by the processor for the MEDIUM VERBOSITY setting contact your processor directly Payflow Pro Developer s Guide 139 140 VERBOSITY Viewing Processor Specific Transaction Results Supported Verbosity Settings TABLE D 2 Processor responses Field
97. ameters described in this section Parameters to meet American Express Card Acceptance and Processing Network CAPN requirements are described in Table A 1 American Express legacy platform parameters are described in Table A 2 Payflow Pro Developer s Guide 67 Processors Requiring Additional Transaction Parameters American Express American Express Additional Credit Card Parameters CAPN Note You should start coding to the CAPN parameters if you want to be able to impact what TABLE A 1 American Express CAPN parameters appears on AMEX statements and reports With a few exceptions most merchants in the United States follow CAPN requirements international merchants do not If you are not sure whether you should make the coding changes contact Customer Service See How to Contact Customer Support on page 9 for contact information American Express Phoenix accepts the following parameters to meet CAPN requirements Parameter Description Required Type Retail Transaction Advice Addendum Parameters for SWIPE transactions DESCn L_AMTn L_OTYn Description of this line item n is a line item number from 1 to 6 Amount of this line item n is a line item number from 1 to 6 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 Quantity of this line item n is a line item number
98. arding any other errors For information on firewall configuration see Chapter 2 Downloading Installing and Activating Details of the response message may vary slightly from that shown in the table depending on your SDK integration TABLE 6 10 Communications RESULT values RESULT Description 1 Failed to connect to host 2 Failed to resolve hostname 5 Failed to initialize SSL context 6 Parameter list format error amp in name 7 Parameter list format error invalid name length clause 8 SSL failed to connect to host 9 SSL read failed 10 SSL write failed 11 Proxy authorization failed 12 Timeout waiting for response 13 Select failure 14 Too many connections 15 Failed to set socket options 20 Proxy read failed Website Payments Pro Payflow Edition Developer s Guide Responses to Transaction Requests RESULT Values and RESPMSG Text TABLE 6 10 Communications RESULT values RESULT Description 21 Proxy write failed 22 Failed to initialize SSL certificate 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 validate common
99. back history Common 000225 Chargeback ANI ANI with chargeback history Common 000230 Exceed card profile Card has exceeded usage limits Uncommon 000240 Too many Cards ANI has excessive number of cards Uncommon 000250 Exceed ANI profile ANI has exceeded usage limits Uncommon 000260 Too Many Phones Card has been used from excessive ANI Uncommon 000270 OTB AVS Decline OTB decline and AVS mismatch AVS OTB only 000271 OTB AVS Decline OTB approved and AVS mismatch AVS OTB only 000272 OTB AVS Decline OTB decline and AVS match AVS OTB only 000280 Risk Referral Temporary Risk referral AVS necessary Common 000281 Card Not Qualified Card does not meet minimum bank restrictions Not Used 000282 PB Risk Referral Private billing risk referral AVS necessary PB Only a This data is included in risk scoring decisions and a response of 210 has higher precedence Payflow Pro Developer s Guide 97 Performing TeleCheck Electronic Check Transactions HOSTCODE Values 98 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions PayPal Payment Services supports passing Purchasing Card Level 2 information such as purchase order number tax amount and charge description in the settlement file If additional required invoice information and line item details are included in the transaction PayPal formats Purchasing Card Level 3 information in an appropriate format for example EDI Electronic Data Interchange 8
100. bed in detail in Table 4 1 on page 26 To perform a credit card Sale transaction you are required to pass the following parameters e TRXTYPE The type of the transaction such as S for Sale e TENDER The method of payment such as C for credit card e ACCT The buyer s credit card number e AMT The amount of the sale Website Payments Pro Payflow Edition Developer s Guide 21 Simple Payflow Transaction Formatting Transactions e EXPDATE The expiration date of the credit card Typical Sale Transaction The following is a typical request transaction string for a Sale transaction TRXTYPE S amp TENDER C amp USER SuperMerchant amp PWD SuperUserPassword amp PARTNER PayPal amp ACCT 5105105105105100 amp EXPDATE 1209 amp AMT 99 06 amp COMMENT1 Reservat ion amp FIRSTNAME John amp LASTNAME Jones amp STREET 123 Main St amp CITY San JOSe amp STATE CA amp ZIP 123451234 amp BILLTOCOUNTRY US amp CVV2 2123 amp CUSTIP 0 0 0 0 Note that besides the required Sale transaction parameters the above string includes other Payflow Pro parameters typically included in a credit card Sale transaction request When the transaction completes the Payflow server returns a response string made up of name value pair response parameters If the transaction is successful a RESULT value of 0 is returned The value of PNREF identifies the transaction in future requests and RESPMSG is a string indicating whethe
101. ce only with a PNRI EF the same as the original It appears only in the PayPal Manager user interface and will never settle 26 Payflow Pro Developer s Guide Credit Card Transactions Parameters Used in Credit Card Transactions TABLE 4 1 Credit card transaction request parameters Parameter Description ACCT Required for credit cards Credit card or purchase card number For the Pinless debit TENDER type ACCT can be the bank account number Limitations This value may not contain spaces non numeric characters or dashes For example ACCT 5555555555554444 EXPDATE Required Expiration date of the credit card Limitations mmyy format For example 1008 represents November 2008 AMT Required Amount Default U S based currency Limitations 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 Your processor and or Internet Merchant Account provider may stipulate a maximum amount 10 numeric characters plus decimal COMMENT 1 Optional Merchant defined value for reporting and auditing purposes Limitations 128 alphanumeric characters COMMENT 2 Optional Merchant defined value for reporting and auditing purposes Limitations 128 alphanumeric characters CVV2 Optional A code that is printed not imprinted on the back of a credit card Used as partial assurance t
102. cessor informaion Currently includes Moneris processor information Added Account Verification as a type of transaction that uses TRXTYPE A and AMT 0 to verify credit card information Updated length of PARTNER USER and VENDOR to 64 characters FDMS supports unreferenced credits Minor corrections for technical accuracy and clarification e Moved coverage of Express Checkout to a separate new document Express Checkout for Payflow Pro Removed coverage of the version 3 Payflow SDK including test and live URLs Changed Paymentech New Hampshire to Paymentech Salem New Hampshire Updated name of Nova processor to Elavon Corrected format of TSYS ORDERDATE field Added more clarification to description of RESULT value 25 Added more clarification of AMEX CAPN parameters in Appendix A Updated Table 4 1 Credit card transaction request parameters to reflect credit card parameter descriptions only and moved the non credit card parameter descriptions to new tables in applicable sections of the chapter e Minor corrections for technical accuracy and clarification Updated live and test URLs to reflect PayPal only payflowpro paypal com live URL and pilot payflowpro paypal com test URL Added Help Center URL to Preface Added Paymentech New Hampshire processor specification updates including e CAPN requirements e Support of card security code for American Express and Discover cards e Support of Switch Solo Maestro card e Full a
103. ch as an Authorization You use an Authorization transaction for the full amount of the purchase of 100 as shown in this transaction request TRXTYPE A amp TENDER C amp PWD x1y2z3 amp PARTNER PayPal amp VENDOR SuperMerchant amp USER S uperMerchant amp ACCT 5555555555554 444 amp EXPDATE 0 308 amp AMT 100 OO amp INVNUM 123456 789 amp STREET 5199 MAPLE amp ZIP 94588 Note the value of the PNREF in the response RESULT 0 amp PNREF VXYZ01234567 amp RESPMSG APPROVED amp AUTHCODE 123456 amp AVSADDR Y amp A VSZIP N Note The PNREF returned in the original transaction is valid for use in reference transactions for a period of 12 months Capture the authorized funds for a partial shipment of 66 When you deliver the first 66 worth of product you use a normal Delayed Capture transaction to collect the 66 Set ORIGID to the value of PNREF in the original Authorization as in this transaction request See Required Delayed Capture Transaction Parameters on page 30 TRXTYPE D amp TENDER C amp PWD x1y2z3 amp PARTNER PayPal amp VENDOR SuperMerchant amp USER S uperMerchant amp ORIGID VXYZ01234567 amp AMT 66 00 This is the response RESULT 0 amp PNREF VXYZ01234568 amp AUTHCODE 25TEST amp AVSADDR Y amp AVSZIP N Submit a new Sale transaction or Authorization Delayed Capture transaction of 34 for the rest of the shipment Once you have sh
104. chant information Processor does not recognize your merchant account information Contact your bank account acquirer to resolve this problem 6 Invalid or unsupported currency code 7 Field format error Invalid information entered See RESPMSG 8 Not a transaction server 9 Too many parameters or invalid stream 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 Contact your merchant bank to obtain an authorization and submit a manual Voice Authorization transaction 19 Original transaction ID not found The transaction ID you entered for this transaction is not valid See RESPMSG 20 Cannot find the customer reference number 22 Invalid ABA number Website Payments Pro Payflow Edition Developer s Guide 59 60 Responses to Transaction Requests RESULT Values and RESPMSG Text TABLE 6 9 Payflow Transaction RESULT Values and RESPMSG Text RESULT 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 50 51 99 100 101 102 103 RESPMSG and Explanation Invalid account number Check credit card number and re submit Invalid expiration date Check and re submit Invalid Host
105. check transaction response values are described in Table B 3 TABLE B 3 Transaction responses common to all tender types Field RESULT PNREF HOSTCODE RESPMSG Description Type Length The outcome of the attempted transaction A result of 0 zero indicates Numeric X Variable the transaction was approved Any other number indicates a decline or error RESULT values are described in RESULT Values and RESPMSG Text on page 58 PayPal Reference ID a unique number that identifies the transaction Alpha 12 PNREF is described in HOSTCODE Values on page 95 TeleCheck s response code representing the results of the transaction numeric Numeric 6 authorization attempt These values are described in HOSTCODE Values on page 95 A descriptive message associated with decline or error RESULTs Alpha Response messages are described in Chapter Responses to Variable numeric Transaction Requests HOSTCODE Values The HOSTCODE reflects the TeleCheck server result The following tables describe the HOSTCODE values TeleCheck requires that you display certain verbiage to the purchaser based on the returned HOSTCODE value check with TeleCheck for details Note Many of these codes will not be encountered under normal operating conditions they are included as a troubleshooting aid In the tables the Frequency column indicates the likelihood that you will encounter the code T
106. ck 5 93 Example Test 93 Preparing for TeleCheck Production 94 Responses to Telecheck 94 HOSTCODE Values dodo kom R 5 mn XS RU eh 95 Appendix C Submitting Mange Card Level 2 and Level 3 Transactions at a wn D About Purchasing 99 About Program 99 Accepted BIN 100 About American Express Purchasing Card Transactions Phoenix Processor 100 Supported Transaction 101 Avoiding 101 Submitting Successful Level 3 Transactions 101 6 Payflow Pro Developer s Guide Contents E Edit Check x uos loo Xx alee ERROR Ku ded e m ERE de ec eee 101 Accepted BIN 102 American Express Phoenix Purchasing Card Transaction Processing 102 American Express Phoenix Level 2 Parameters 103 American Express Phoenix Level 2 Parameters Legacy 105 Example American Express Phoenix Level 2 Transaction Parameter String 105 American E
107. codes see http en wikipedia org wiki Airline codes All List discounts associated with the travel No Number of passengers on this trip No If this is an electronic ticket The values are No Y yes N no Code assigned to the travel reservation before the No ticket was purchased Type Length Numeric Alpha 5 numeric Alpha 5 numeric Alpha 24 numeric Numeric Alpha 1 numeric Alpha 15 numeric 72 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters A American Express TABLE A 1 American Express CAPN parameters Continued Parameter Description Required Type Length Other FIRSTNAME Account holder s first and last name Note Even No Alpha 13 though the parameter name indicates only the first numeric name this single parameter holds all of the person s name information both first and last name at a minimum LASTNAME Account holder s last name No Alpha 13 numeric INVNUM Merchant invoice number The merchant invoice Alpha 9 number is used for authorizations and settlements numeric 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 ORDERDATE Order date No Numeric 7 For example July 28 2003 is 072803 Format mmddyy with no slashes or dashes OR
108. d 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 name value starts with and ends with n where n is the line item number For example OTYO 1is the quantity for line item 0 and is equal to 1 with n starting at 0 In addition the SHIPFROMZIP parameter is required for Level 3 transactions TABLE 7 FDMS North line item parameters Parameter Description Required Type Length L OTYn Quantity whole units only Yes Numeric 10 L COMMCODEn Item commodity code No Alpha 12 numeric DESCn Item description No Alpha 35 numeric L UOMn Item unit of measure See Units of Measure on No Alpha 3 page 161 L 5 Cost per item excluding tax No Currency 10 L UPCn Supplier specific product code No Alpha 12 numeric L DISCOUNTn Discount per line item No Currency 10 L AMIn Total line item amount including tax and discount Yes Currency 10 for debit for credits L TAXAMTn Line item tax amount No Currency 10 Payflow Pro Developer s Guide 111 Submitting Purchasing Card Level 2 and Level 3 Transactions First Data Merchant Services South FDMS Purchasing Card Transaction Processing First Data Merchant Services South FDMS Purchasing Card Transaction Processing The following parameters are recommended to obtain the best rates for Level 2 and Level 3
109. d non numeric characters Example 951121737 Transaction Advice Detail Parameters ADDLAMIn ADDLAMTTYPEn Detail of a charge n is the line item number a value from 1 5 use for additional breakdown of the charge 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 3 digit code indicating the type of the corresponding charge detail n is the line item number a value from 1 5 Required No No No No No Type Alpha numeric Numeric Numeric Alpha numeric Alpha numeric Alpha numeric Numeric Alpha numeric Length 40 12 38 38 21 3 104 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions American Express Phoenix Purchasing Card Transaction Processing American Express Phoenix Level 2 Parameters Legacy TABLE C 3 American Express Phoenix Legacy Level 2 parameters Parameter PONUM SHIPTOZIP DESC1 DESC2 DESC3 DESC4 Description Purchase order number Ship to postal code called zip code in the USA This field must contain one of the following values e Zip code of the destination where the merchandise is to be shipped e If the above is not available Zip code of the location where the merchant executed the transaction Freeform description Freeform description Freeform descri
110. dditional TSYS Acquiring Solutions parameters to meet CAPN requirements Continued Parameter AIR DESTINATION AIR NUMBEROFCITIES AIR ROUTINGCITYn Description Required Type Length Destination airport code for the first segment of No Alpha 5 the trip this is not necessarily the final numeric destination For example if a passenger flies from STL to MIA with a layover at JFK the destination airport is JFK For a list of airport codes see http www world airport codes com alphabetical airport code a html NOTE Present day airport codes are three characters in length The five character length is designed to allow for future expansion Number of unique cities in this trip including the No Numeric cities of origin and destination where a maximum value of 10 is allowed For example AIR NUMBEROFCITIES is 3 for the following trip DEN to LAX LAX to SFO SFO to DEN If not provided this value is equal to the number of AIR ROUTINGCITYn parameters Airport codes of each city in this flight including No Alpha 5 cities of origin and destination where n is a value numeric from 1 to 10 For a list of airport codes see http www world airport codes com alphabetical airport code a html NOTE Present day airport codes are three characters in length The five character length is designed to allow for future expansion Payflow Pro Developer s Guide 87 OA Pr
111. ding on your bank Obtaining an Internet Merchant Account To accept credit cards over the internet you need a special account called an Internet Merchant Account Your account provider or merchant acquiring bank works with a PayPal supported credit card processor such as First Data TSYS Acquiring Solutions formerly Vital Processing Services or Paymentech To use Payflow Pro to accept live credit cards you must provide certain details about your account to PayPal during the Go Live part of the enrollment process Note An Internet Merchant Account is a different type of merchant account than a merchant account used for face to face in person retail transactions It has additional risks associated with card not present e commerce transactions You need to obtain an Internet Merchant Account even if you already accept credit cards at your location To apply for an Internet Merchant Account contact your merchant acquiring bank Planning Your Payflow Pro Integration In designing your Payflow Pro integration you should evaluate the following e Whether to use a one step or two step transaction process One step Submit a Sale transaction which performs the Authorization and if successful then flags the transaction for settlement Two step Perform an Authorization only transaction and then later perform a Delayed Capture transaction The Delayed Capture transaction can be for the same amount as the original transaction or fo
112. e numeric USA 840 SHIPMETHOD Shipping method code The values are No Alpha 2 01 Same day numeric 02 Overnight next day 03 Priority 2 3 days 04 Ground 4 or more days 05 Electronic delivery 06 ZZ Reserved for future use SKU Merchant product SKU No Alpha 15 numeric AVS Parameters STREET Account holder s street address number and street No Alpha 30 name numeric ZIP Account holder s 5 to 9 digit ZIP postal code No String 9 excluding spaces dashes and non numeric characters Example 951121737 PHONENUM Account holder s telephone number The formats String 20 are US numbers TXXXXXXXXXXX international numbers Payflow Pro Developer s Guide TABLE A 10 Additional TSYS Acquiring Solutions parameters to meet CAPN Processors Requiring Additional Transaction Parameters A TSYS Acquiring Solutions requirements Continued Parameter SHIPTOFIRSTNAME SHIPTOLASTNAME SHIPTOSTRE ET SHIPTOCOUNTRY SHIPTOZIP SHIPTOPHONENUM RECURRING Description First name in the shipping address Last name in the shipping address Shipping street address Numeric country code Example USA 840 Shipping 5 to 9 digit ZIP postal code excluding spaces dashes and non numeric characters Example 951121737 Shipping telephone number Identifies the transaction as recurring This value does not activate PayPal s Recurring Billing S
113. e Verbosity Setting Table D 3 shows the increments that are possible on basic TRANSSTATE values TABLE D 3 TRANSSTATE increments Increment Meaning 100 If no client acknowledgment ACK is received for the transaction the original TRANSSTATE value is incremented by 100 For example if the original TRANSSTATE is 6 it is incremented to 106 Transactions in this range do not settle For transactions in TRANSSTATE 106 use Auto Resettle in PayPal Manager s Virtual Terminal to submit them for settlement or void them using a manual Void 200 If the host process never receives an ACK from the transaction broker or backend payment server for the transaction the original TRANSSTATE value is incremented by 200 For example if the original TRANSSTATE is 6 it is incremented to 206 Transactions in this range are basically in limbo and will not be settled 1000 If a Void transaction is run through the API PayPal Virtual Terminal or by PayPal Customer Service against a successful Authorization or Sale transaction the original TRANSSTATE is incremented by 1000 For example if the original TRANSSTATE is 6 it is incremented to 1006 Changing the Verbosity Setting Setting the Verbosity Level on a Per Transaction Basis To specify a setting for Verbosity that differs from your account s current setting include the VERBOSITY lt value gt name value pair in the transaction request where lt value gt is LOW o
114. e cent 42 00 not 42 Do not include comma separators 1234 56 not 1 234 56 See FDMS South Currency Codes and Decimal Positions on page 166 Freight amount If the currency uses a decimal then the value must include a decimal and the exact amount to the cent 42 00 not 42 Do not include comma separators 1234 56 not 1 234 56 See FDMS South Currency Codes and Decimal Positions on page 166 Purchase order number merchant related data The postal code called zip code in the USA from which shipping occurs Ship to postal code called zip code in the USA Required No No No No but provides best rate when used No but provides best rate when used No but provides best rate when used Type Alpha Currency Currency Currency Alpha numeric Numeric Numeric Length 25 110 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions First Data Merchant Services FDMS North Purchasing Card Transaction Processing TABLE 6 FDMS North purchasing card parameters Continued Parameter Description Required Type Length TAXAMT Tax amount No but Currency 10 The value must include a decimal and the exact provides amount to the cent 42 00 not 42 Do not include best rate comma separators 1234 56 not 1 234 56 See when used FDMS South Currency Codes and Decimal Positions on page 166 FDMS North Purchasing Car
115. e only the value K Yes Alpha 1 electronic check RXTYPE Type of transaction that should be processed Allowed Yes Alpha 1 transaction types Sale S Void V Inquiry 1 USER Case sensitive login ID for the Payflow Pro account that Yes Alpha 64 you created while registering for the account numeric In the future each account will allow multiple users This parameter will specify the user VENDOR Case sensitive Vendor ID that you created while Yes Alpha 64 registering for the account numeric ZIP Account holder s 5 to 9 digit postal code called ZIP code Yes Alpha 9 in the USA Do not use spaces dashes or non numeric characters Testing TeleCheck Transactions PayPal provides a test server to support testing and configuration For information on the test server URL see Host Addresses on page 13 Example Test Transaction TRXTYPE S amp TENDER K amp CHKTYPE P amp PARTNER your Partner Name typically PayPal gt amp VENDOR lt your Merchant Login Name gt amp USER lt your Merchant Login Payflow Pro Developer s Guide 93 Performing TeleCheck Electronic Check Transactions Preparing for TeleCheck Production Transactions Name gt amp PWD lt your Payflow password gt amp AMT 42 00 amp STREET 1234 Main amp CITY Buffalo amp DL CA123456 amp CHKNUM 1001 amp EMAIL y our e mail address gt amp MICR lt Use a MICR value from Table 2 gt 6 E Sally amp STATI
116. e recommended to obtain the best rates for purchasing card transactions with Elavon TABLE C 20 Elavon additional parameters Parameter Description COMMCARD One character value representing the type of commercial card P Purchase Card C Corporate Card B Business Card U Unknown default N None PONUM Purchase Order Number Required Type No defaults to AN U Unknown No when used AN provides best rate Length 1 25 Payflow Pro Developer s Guide 123 Submitting Purchasing Card Level 2 and Level 3 Transactions Paymentech Salem New Hampshire Purchasing Card Transaction Processing TABLE C 20 Elavon additional parameters Continued Parameter Description Required Type Length TAXAMT Tax Amount when used Currency 10 The value must include a decimal and the exact provides best amount to the cent 42 00 not 42 Do not include rate comma separators 1234 56 not 1 234 56 Example Elavon Level 2 Transaction Parameter String RXTYPE S amp ACCT 5105105105105100 amp AMT 20 10 amp CITY Mountain View amp COMMENT1 L2 Testing amp EXPDATE 1209 amp NAME Cardholder Name amp PARTNER PayPal amp PWD pwd amp STATE CA amp STREET 123 Main St amp TENDER C amp USER user amp ZIP 94043 amp CUSTCODE 123456 amp TAXAMT 1 34 Paymentech Salem New Hampshire Purchasing Card Transaction Processing Paymentech Salem New Hampshire Level 2
117. e time that it sends the transaction request to the server Optional Proxy server address Use the PROXY parameters for servers behind a firewall Your network administrator can provide the values Optional Proxy server port Optional Proxy server logon ID Optional Proxy server logon password PARMLIST Syntax Guidelines Follow these guidelines when creating the PARMLIST Spaces are allowed in values Enclose the PARMLIST in quotation marks Do not place quotation marks within the body of the PARMLIST Separate Set the VI all name value pairs in the PARMLIST using an ampersand amp response ERBOSITY transaction parameter to MEDIUM default is LOW if you want the to return more detailed information For details see Appendix A Verbosity Viewing Processor Specific Transaction Results Using Special Characters in Values Because the ampersand amp and equal sign characters have special meanings in the PARML ST name value pairs like the following examples are not valid Website Payments Pro Payflow Edition Developer s Guide Simple Payflow Transaction 27 Sale Transaction Example NAME Ruff amp Johnson 1 1 1 5 To use special characters in value of a name value pair use length tag The length tag specifies the exact number of characters and spaces that appear in the value The following name value
118. ebsite for information on corrective actions 58 Website Payments Pro Payflow Edition Developer s Guide Responses to Transaction Requests RESULT Values and RESPMSG Text TABLE 6 9 Payflow Transaction RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 1 User authentication failed Error is caused by one or more of the following e Login information is incorrect Verify that USER VENDOR PARTNER and PASSWORD have been entered correctly VENDOR is your merchant ID and USER is the same as VENDOR unless you created a Payflow Pro user All fields are case sensitive e Invalid Processor information entered Contact merchant bank to verify e Allowed IP Address security feature implemented The transaction is coming from an unknown IP address See PayPal Manager online help for details on how to use Manager to update the allowed IP addresses e You are using a test not active account to submit a transaction to the live PayPal servers Change the host address from the test server URL to the live server URL 2 Invalid tender type Your merchant bank account does not support the following credit card type that was submitted 3 Invalid transaction type Transaction type is not appropriate for this transaction For example you cannot credit an authorization only transaction 4 Invalid amount format Use the format Do not include currency symbols or commas 5 Invalid mer
119. ed with no further action on your part Payflow Pro Developer s Guide 33 Credit Card Transactions Submitting Credit Transactions Like Sale transactions approved Voice Authorization transactions can be voided before settlement occurs Required Voice Authorization Transaction Parameters When sending a Voice Authorization transaction request you are required to include the AUTHCODE provided by your merchant bank TABLE 4 4 Voice Authorization transaction required parameter Parameter Description AUTHCODE Required for Voice Authorizations only Returned only for approved Voice Authorization transactions AUTHCODE is the approval code obtained over the telephone from the processing network Limitations Six alphanumeric characters The following is an example Voice Authorization transaction request parameter string IRXTYPE F amp TENDER C amp PARTNER PayPal amp VENDOR SuperMerchant amp USER SuperMerchant amp P WD x1y2z3 amp AUTHCODE AB34RT56 amp ACCT 5555555555554444 amp EXPDATE 0308 amp AMT 123 00 Submitting Credit Transactions The Credit transaction TRXTYPE C refunds the specified amount to the cardholder Required Credit Transaction Parameters The required parameter data for a Credit transaction depends on the Allow non referenced credits security setting for your Payflow Pro account A non referenced credit is a Credit transaction that does not use the credit card
120. ema For details on XMLPay see XMLPay Developer s Guide in the Payflow Pro documentation on Developer Central Website Payments Pro Payflow Edition Developer s Guide 19 20 Simple Payflow Transaction Transaction Requests Connection Parameters The connection parameters are described below Pass them in the format and syntax required by the Payflow SDK and programming language that you are using See your integration documentation for details TABLE 3 1 Connection parameters Parameter HOSTADDRESS HOSTPORT PARMLIST TIMEOUT PROXYADDRESS PROXYPORT PROXYLOGON PROXYPASSWORD Description Required Payflow host name See Host Addresses on page 13 for details on host addresses Required Use port 443 Required List of parameters that specify the payment information for the transaction The quotation marks at the beginning and end are required The following is an example TRXTYPE S amp TENDER C amp PARTNER PayPal amp VENDOR SuperMerchant amp USER Sup erMerchant amp PWD SuperUserPassword amp ACCT 5555555555554444 amp EXPDATE 0308 amp AMT 123 00 The content of the PARMLIST varies by the type of transaction being processed For example a Void transaction requires a different set of parameters than a Sale Required Time out period for the transaction The minimum recommended time out value is 30 seconds The client begins tracking from th
121. enland Grenada Guadeloupe Guam Guatemala Guinea Guinea Bissau Guyana Haiti Heard and McDonald Islands Code 148 152 156 162 166 170 174 178 184 188 384 191 192 196 203 208 262 212 304 308 312 316 320 324 624 328 334 Country Name Estonia Ethiopia Falkland Islands Malvinas Faroe Islands Fiji Finland France France Metropolitan French Guiana French Polynesia French Southern Territories Gabon Gambia Georgia Germany Ghana Gibraltar Greece Jordan Kazakhstan Kenya Kiribati Korea Democratic People s Republic of formerly North Korea Korea Republic of formerly South Korea Kuwait Kyrgyzstan Lao People s Democratic Republic formerly Laos Latvia Code 233 231 238 234 242 246 250 249 254 258 260 266 270 268 276 288 292 300 400 398 404 296 408 410 414 417 418 428 Payflow Pro Developer s Guide ISO Country Codes TABLE 1 1 50 country codes Country Name Code Country Name Code Honduras 340 Lebanon 422 Hong Kong 344 Lesotho 426 Hungary 348 Liberia 430 Iceland 352 Libyan Arab Jamahiriya formerly Libya 434 India 356 Liechtenstein 438 Indonesia 360 Lithuania 440 Iran Islamic Republic of 364 Luxembourg 442 Iraq 368 Macau 446 Ireland 372 Macedonia the Former Yugoslav 807 Republic of Israel 376 Madagascar 450 Italy 380 Malawi 454 Jamaica 388 Malaysia 458 Japan 392 Maldives 462 Mali 46
122. ents during authorization Level 3 data is passed to the American Express Phoenix processor only during settlement Avoiding Downgrade If a transaction uses the purchasing card BIN range see Accepted BIN Ranges on page 100 and contains a line item but does not include all mandatory Level 3 parameters then the transaction succeeds but is processed as Level 2 or Level 1 during settlement depending on which data was passed For downgraded transactions with the VERBOSITY parameter set to MEDIUM or HIGH a message like the following is returned in the ADDLMSGS field Features not processed PCARD L3 missing or invalid InvoiceNumber RequestorName Features not processed PCARD L3 line item 3 missing Description For details on VERBOSITY see Appendix D VERBOSITY Viewing Processor Specific Transaction Results Submitting Successful Level 3 Transactions If a transaction uses the purchasing card BIN range contains all mandatory Level 3 fields and has at least one line item with all mandatory line item fields the Payflow payments gateway flags it as Level 3 Edit Check PayPal performs an edit check on the transaction s amount fields to ensure that all line item and tax amounts balance If the edit check fails the transaction fails with Result 4 Invalid Amount To pass the edit check the following relationship must be true Transaction Amount Total Tax Amount Total Freight Amount Total Handling
123. er cases the transaction may be approved despite a mismatch Character length and limitations 1 alpha character Y N X or no response 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 For Account Verification transactions RESULT 0 with RESPMSG Verified means a zero dollar authorization has been successfully performed Character length and limitations variable alphanumeric characters Website Payments Pro Payflow Edition Developer s Guide 55 Responses to Transaction Requests Contents of a Response to a Credit Card Transaction Request TABLE 6 8 Transaction response values Field AUTHCOD I AVSADDR AVSZIP IAVS PROCAVS PROCCVV2 CO RRELATIONID EXID Description Returned for Sale Authorization and Voice Authorization credit card transactions AUTHCODE is the approval code obtained over the telephone from the processing network AUTHCODE is required when submitting a Force F transaction Character length and limitations 6 alphanumeric characters Address Verification Service address response returned if you are using Address Verification Service Address Verification Service address responses are for advice only This process does not affect the outcome of the authorization Character length and limitations 1 alpha char
124. erform a new reference transaction based on a Sale For details see Submitting Authorization Delayed Capture Transactions on page 29 Payflow Pro Developer s Guide 29 peat Credit Card Transactions Submitting Authorization Delayed Capture Transactions I MPORTANT Only one Delayed Capture transaction is allowed per Authorization transaction Required Authorization Transaction Parameters To perform an Authorization transaction you are required to pass the following parameters e ACCT e AMT e EXPDATE Typical Authorization Transaction Parameter String A typical parameter string passed in an Authorization transaction is the same as a Sale transaction string The only difference is that the TRXTYPE value is A in an Authorization IRXTYPE A amp TENDER C amp USER SuperUser amp PWD SuperUserPassword amp VENDOR SuperUser amp PA RINER PayPal amp ACCT 5105105105105100 amp EXPDATE 1209 amp CVV2 123 amp AMT 99 00 amp FIRSTNAME John amp LASTNAME Smith amp STREET 123 Main St amp CITY San Jose amp STATE CA amp ZIP 12345 amp COMMENT 1 Reservat ion amp INVNUM 12 34567890 amp PONUM C12345 amp CVV 2 567 amp VERBOSITY MEDIU Required Delayed Capture Transaction Parameters To perform a Delayed Capture transaction you are required to pass the following parameter ORIGID TABLE 4 2 Delayed Capture required parameter Parameter Description O
125. ers 00 amp VATAXPERC ENT 10 amp TAXEXEMPT Y amp DIS 33 amp SHIPFROMZIP 44444 amp S iine 6789012 amp L COST1 1 00 amp L RATE1 1 00 amp L DISCOUNT1 1 00 amp L AMT1 1 00 amp L TAXTYPE1 TT3 To qualify for Level 3 purchasing card transaction processing the authorization response for the transaction must have the commercial card indicator set and one or more line items should be present in the Delayed Capture or Sale request Level 2 transaction parameters marked as mandatory are required for Level 3 transactions Level 3 transactions that do not include the mandatory Level 2 values are rejected IMPORTANT The values required for Level 3 status vary by bank so contact your bank for details Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing TSYS Acquiring Solutions Level 2 Visa Parameters for Level 3 Line Item Transactions TABLE C 31 TSYS Acquiring Solutions Level 2 Visa transaction data for line item transactions Mandatory Length Name Optional Payflow Parameter Data Type Purchase M PONUM 25 AN Identifier Value of TransID is sent if no value is provided Tax Amount M TAXAMT NUM 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 Lcl Tax LOCALTAXAMT 12 NUM Lcl Tax Incl Flag TAXEXEM
126. ers produce an error e Expiration Date must be a valid date in the future use the mmyy format e To view the credit card processor that you have selected for testing see Account Info gt Processor Info in PayPal Manager Credit Card Numbers Used for Testing Use the following credit card numbers for testing Any other card number produces a general failure TABLE 5 1 Test credit card numbers American Express 3782822463 10005 American Express 371449635398431 American Express Corporate 37873449367 1000 Diners Club 30569309025904 Diners Club 38520000023237 Discover 6011111111111117 Discover 6011000990139424 JCB 3530111333300000 JCB 3566002020360505 MasterCard 5555555555554444 Payflow Pro Developer s Guide 49 Credit Card Testing Result Values in Responses TABLE 5 1 Test credit card numbers MasterCard 5105105 105105100 Visa 4111111111111111 Visa 4012888888881881 Visa 4222222222222 Even though this number has different character count than the other test numbers it is the correct and functional number Result Values in Responses This section describes the result value responses that you receive Testing Result Values in Responses You can use the amount of the transaction to generate a particular result value The table below lists the general guidelines for specifying amounts to submit in requests TABLE 5 2 Results generated by the amount submitted Amount Result
127. ervice APIs If the RECURRING parameter was set to Y for the original transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s Fraud Protection Services To avoid charging you to filter recurring transactions that you know are reliable the fraud filters do not screen recurring transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Virtual Terminal The filters screen the transaction in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results Location Transaction Advice Addendum Parameters ERCHANTNAME ERCHANTSTREET ERCHANTCI 5 Name of merchant Merchant s street address number and street name Merchant s city Merchant s state Required Type No No No No Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric String Alpha numeric Yor N Alpha numeric Length 30 30 30 10 30 Payflow Pro Developer s Guide 85 OA Processors Requiring Additional Transaction Parameters TSYS Acquiring Solutions TABLE A 10 Additional TSYS Acquiring Solutions parameters to meet CAPN requirements Continued Parameter Description Required Type Length
128. ervice described herein PayPal Inc reserves the right to make changes to any information herein without further notice Preface Chapter Contents 9 Nec 9 Intended 9 Related Documentation 9 How to Contact Customer Support 9 Revision e x dox dex Em ROSEO Be eG X Ox e 10 1 Introduction Cx wee ee es Sm a ee ee em About Payflow 13 Payflow Pro 13 Host Addresses 2 4 a we REOR e Re e Re E e m a RU E 13 How Payflow Pro 13 Supported Processing 14 Supported Payment 15 Payflow Pro Recurring Billing 15 About Security 2225 55 a eee ee a Bog XR e 3 15 Chapter 2 Downloading Installing and Activating 17 Supported Platforms a scs 222 ll ss rss 17 Preparing the Payflow Client Application 17 Activating Your Payflow Pro Account oaoa 18 Chapter 3 Simple Payflow Transaction 19 Transaction Requests 19 Request 2 19 Da
129. 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 ADDLAMTTYPEn A 3 digit code indicating the type of the No Alpha 3 corresponding charge detail where n is a value numeric from 1 5 Airline Passenger Data Parameters AIR DEPARTUREDATE Departure date in the format YYYYMMDD No Alpha 8 numeric AIR PASSENGERNAME of the passenger in the following format No Alpha 60 with fields separated by a space numeric surname firstname middleinitial title AIR ORIGIN Airport code of the originating airport No Alpha 5 For a list of airport codes see http www world numeric airport codes com alphabetical airport code a html NOTE Present day airport codes are three characters in length The five character length is designed to allow for future expansion AIR DESTINATION Destination airport code for the first segment of No Alpha 5 the trip this is not necessarily the final numeric destination For example if a passenger flies from STL to MIA with a layover at JFK the destination airport is JFK For a list of airport codes see http www world airport codes com alphabetical airport code a html NOTE Present day airport codes are three characters in length The five character length is designed to allow for future expansion Payflow Pro Developer s Guide 71 EE Processors Requ
130. g There is no need to retransmit the credit card or billing address information it is stored at PayPal If the capture succeeds the amount of the Capture is transferred to the merchant s account during the daily settlement process If the capture does not succeed the hold on the cardholder s open to buy is still in effect Example Delayed Capture Transaction TRXTYPE D amp TENDER C amp PWD x1y2z3 amp PARTNER PayPal amp VEN amp USER SuperMerchant amp ORIGID VXYZ00887892 Example Delayed Capture Response DOR SuperMerchant RESULT 0 amp PNREF VXYZ00895642 amp AUTHCODE 25TEST amp AVSADDR Y amp AVSZIP N Delayed Capture Transaction Capturing Transactions for Lower Amounts You can perform a Delayed Capture transaction for an amount lower than the original Authorization amount useful for example when you make a partial shipment Delayed Capture Transaction Capturing Transactions for Higher Amounts You can perform a Delayed Capture transaction for an amount higher than the original Authorization amount The cardholder s open to buy could be reduced by the sum of the original Authorization only amount and the final Delayed Capture amount Delayed Capture Transaction Error Handling and Retransmittal If an error occurs while processing a Delayed Capture transaction it is safe to retry the capture with values that allow the Payflow server to successfully process it Conversely if a
131. g Billing Service APIs numeric If the RECURRING parameter was set to Y for the Yor N original transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s Fraud Protection Services To avoid charging you to filter recurring transactions that you know are reliable the fraud filters do not screen recurring transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Virtual Terminal page The filters screen the transaction in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results a Formerly Vital Processing Services 78 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters a Elavon Formerly Nova Elavon Formerly Nova Elavon Additional Credit Card Parameters In addition to the parameters in Table 4 1 Credit card transaction request parameters Elavon accepts the following parameter TABLE A 7 Elavon additional parameters Parameter Description Required Type Length RECURRING Identifies the transaction as recurring This value does No Alpha 1 not activate PayPal s Recurring Billing Service API numeric If the RECURRING parameter was set to Y for the original YorN transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s
132. g transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Manual Transactions page The filters screen the transaction in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results Required Type No Yes No No Alpha Numeric Alpha numeric Alpha numeric Alpha numeric Alpha Alpha numeric Alpha numeric YorN Length 20 3 9 22 82 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters A TSYS Acquiring Solutions TABLE A 9 Additional Paymentech parameters legacy Continued Parameter Description Required Type Length RECURRINGTYPE Paymentech Tampa only Type of transaction No Alpha 1 occurrence The values are F First occurrence S Subsequent occurrence default TSYS Acquiring Solutions TSYS Acquiring Solutions Additional Credit Card Parameters CAPN In addition to the parameters in Table 4 1 Credit card transaction request parameters TSYS Acquiring Solutions accepts the following parameters to meet CAPN requirements TABLE A 10 Additional TSYS Acquiring Solutions parameters to meet CAPN requirements Parameter Description Required Type Length Retail Transaction Advice Addendum Parameters for SWIPE transactions DESCn Description of this line item n is a line item No Alpha 19 numbe
133. gnized TABLE C 1 Transaction levels 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 Payflow Pro Developer s Guide 99 Submitting Purchasing Card Level 2 and Level 3 Transactions About American Express Purchasing Card Transactions Phoenix Processor TABLE C 1 Transaction levels Level Description Level 2 Additional data regarding sales tax customer code purchase order number invoice number are captured at the point of sale In most cases this information is combined with the merchant s tax ID number state and postal code data and is then passed through during settlement For some processors and banks however a Level 2 authorization may include some of this data Level 3 Significant additional information such as line items product codes item descriptions unit price unit quantities and ship to postal data are added to the Level 2 data to provide optimal reporting to buyers and sellers Settlement transactions typically carry Level 3 data Level 2 and Level 3 data is generally considered non financial data Lack of adequate data may cause a transaction to be downgraded PayPal generally requires up to Level 2 information in an Authorization transaction followed by additional Level 3 data in the associated Delayed Capture transaction A Sale tra
134. haracters of the CVV2 value determine the CVV2MATCH result as shown here TABLE 5 7 Testing CVV2MATCH CVV2 Value CVV2MATCH Value 000 Y 001 300 Y 301 600 N 601 or higher X 54 Payflow Pro Developer s Guide Responses to Transaction Requests When a transaction finishes the Payflow server returns a response string made up of name value pairs This is an example response string RESULT O0 amp PNREF EFHPOD426A53 amp RESPMSG APPROVED amp AUTHCODE 25TEST amp AVSADDR Y amp AVSZIP N amp CVV2MATCH Y Contents of a Response to a Credit Card Transaction Request The table below describes values that can be returned in response strings TABLE 6 8 Transaction response values Field Description PNREF Payflow Transaction ID a unique number that identifies the transaction Character length and limitations 12 alphanumeric characters PPREF Unique transaction ID of the payment Character length and limitations 17 character string RESULT The outcome of the attempted transaction RESULT 0 means the transaction was approved NOTE For Account Verification transactions RESULT 0 with RESPMSG Verified means a zero dollar authorization has been successfully performed Any other value for RESULT indicates a decline or error Character length and limitations variable length numeric CVV2MATCH Result of the card security code CVV2 check The issuing bank may decline the transaction if there is a mismatch In oth
135. harging you to filter recurring transactions that you know are reliable the fraud filters do not screen recurring transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Virtual Terminal The filters screen the transaction in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results Location Transaction Advice Addendum Parameters ERCHAN NAME ERCHAN STREET CITY ERCHAN STATE ERCHAN COUNTRYCO ERCHANTZIP Name of merchant Merchant s street address number and street name Merchant s city Merchant s state Merchant s numeric country code Example USA 840 Merchant s 5 to 9 digit ZIP postal code No excluding spaces dashes and non numeric characters Example 951121737 Transaction Advice Detail Parameters Type Length Alpha 9 numeric String 10 Alpha 1 numeric YorN Alpha 30 numeric Alpha 3 numeric Alpha 9 numeric 70 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters American Express TABLE A 1 American Express CAPN parameters Continued Parameter Description Required Type Length ADDLAMTn Detail of a charge where n is a value from 1 5 No Numeric 12 Use for additional breakdown of the amount Must include a decimal and be
136. hat the card is in the buyer s possession Limitations 3 or 4 digits FIRSTNAME Optional Account holder s first name Limitations 30 alphanumeric characters LASTNAME Optional but recommended Account holder s last name Limitations 30 alphanumeric characters STREET Optional The cardholder s street address number and street name I The STREET address is verified by the address verification service Limitations 30 alphanumeric characters ZIP Optional Account holder s 5 to 9 digit zip postal code Limitations Nine characters maximum Do not use spaces dashes or non numeric characters Payflow Pro Developer s Guide 27 ead Credit Card Transactions Submitting Sale Transactions TABLE 4 1 Credit card transaction request 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 To enable you to use the data the SWIPE parameter must include a length tag specifying the number of characters in the track data For this reason in addition to passing the track data the POS application must count the characters i
137. ions Level 3 MasterCard line item detail record Name Mandatory Optional Payflow Parameter Length Data Type NOTE For these values n is a sequence counter that should begin with 1 and increase in sequence Each line item should also contain quantity L_OTY lt n gt and unit price L_COST lt n gt fields Item Descriptor M L DESCn Product Code L_UPCn Quantity M L_OTYn Unit of Measure Code M UOMn Tax Rate Applied L_TAXRATEn Tax Type Applied L_TAXTYPEn Tax Amount L_TAXAMTn Discount Amount L_DISCOUNTn 35 AN 12 AN 12 NUM 12 AN 4 NUM 4 AN 12 NUM 12 NUM Example TSYS Acquiring Solutions Level 3 MasterCard Transaction Parameter String TRXTYE 0005 amp JOHNSON amp ZIP 945888 amp Al NALTAXAMT E S amp TENDER C amp EXPDA E 0406 amp AI T 1 00 amp STREET 5199 LTTAXAMT 1 00 amp CUSTVATRI 1 00 amp COMMCODE 22222 amp VATAXAMT 1 COUNT 1 00 amp FREIGHTAI HIPTOCOUNTRY 840 amp OR item 1 description amp L UPC1 CBA987654321 amp L QTY1 1 amp L TAXAMT1 1 00 amp L TAX 1 00 amp DUTYAMT 1 00 amp S EGNUM 11111 amp LOCALTAXAI PARTNER Partner amp USER User amp PWD Password amp ACCT 552500000000 T 1 00 amp NATIO HIPTOZIP 333 DERDATE 020725 amp L COMMCODE1 123456789ABC amp L DESC1 UOM1 12345 TSYS Acquiring Solutions Level 3 Visa Paramet
138. ipped 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 only one Delayed Capture transaction is allowed per Authorization This is the Sale transaction request TRXTYPE S amp TENDER C amp PWD x1y2z3 amp PARTNER PayPal amp VENDOR SuperMerchant amp USER S uperMerchant amp ORIGID VXYZ01234567 amp AMT 34 00 This is the response RESULT 0 amp PNREF VXYZ01234569 amp AUTHCODE 25TEST amp AVSADDR Y amp AVSZIP N Submitting Card Present SWIPE Transactions Payflow Pro supports card present transactions face to face purchases NOTE SWIPE card present transactions are not supported by the PayPal processor Follow these guidelines to take advantage of the lower card present transaction rate Contact your merchant account provider to ensure that they support card present transactions Contact PayPal Customer Service to request having your account set up properly for accepting and passing swipe data Payflow Pro Developer s Guide Credit Card Transactions Submitting Card Present SWIPE Transactions e If you plan to process card present as well as card not present transactions set up two separate Payflow Pro accounts Request that one account be set up for card present transactions and use it solely for that purpose Use the other for card not present tran
139. iring Additional Transaction Parameters American Express TABLE A 1 American Express CAPN parameters Continued Parameter AIR NUMBEROFCITIES AIR ROUTINGCITYn AIR CARRIERn AIR FAREBASIS NUMBEROFPASSENGE AIR ISETICKET AIR RESERVATIONCODE Description Required Number of unique cities in this trip including the No cities of origin and destination where a maximum value of 10 is allowed For example AIR NUMBEROFCITIES is 3 for the following trip DEN to LAX LAX to SFO SFO to DEN If not provided this value is equal to the number of AIR ROUTINGCITYn parameters Airport codes of each city in this flight including No cities of origin and destination where n is a value from 1 to 10 For a list of airport codes see http www world airport codes com alphabetical airport code a html NOTE Present day airport codes are three characters in length The five character length is designed to allow for future expansion Two character airline code for each unique airline No in this flight where n is a value from 1 to 10 If the same carrier is used for multiple segments of the trip it is passed only once For example the two AIR CARRIERn values for the following trip are UA and AA UA flight from IAD to DEN UA flight from DEN to LAX UA flight from LAX to SFO AA flight from SFO to DFW For information about airlines
140. lication Unless you are building your own API and using HTTPS to post to the servers you will need to obtain the Payflow SDK Follow these steps 1 Download the Payflow SDK From the SDKs and Downloads page linked to the Library tab on PayPal Developer Central download the Payflow SDK appropriate for your platform 2 Extract the files to a local directory 3 Configure your firewall If you have a stateful firewall enable outbound traffic for SSL port 443 The firewall keeps state on the connection and automatically permits the inbound response from PayPal If you do not have a stateful firewall enable inbound and outbound traffic for SSL port 443 Outbound traffic permits the initial request by Payflow Pro while inbound permits the response from PayPal 4 Read the Readme txt file The Readme txt file includes integration information and samples that illustrate how to use the Payflow client application in your development environment Website Payments Pro Payflow Edition Developer s Guide 17 Downloading Installing and Activating Activating Your Payflow Pro Account Activating Your Payflow Pro Account When you are ready to activate your Payflow Pro 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
141. lojoules Bushel 35 2391 dm3 Bushel 36 36874 dm3 Candela Carrying capacity in metric tonnes Cental GB 45 359237 kg Center metric 100 kg syn Hectokilogram Centigram Centilitre Centimetre Cord 3 63 m3 Coulomb per kilogram Coulomb Cubic centimetre Cubic decimetre Cubic foot Cubic inch Cubic metre per hour Cubic metre per second Cubic metre Cubic millimetre Cubic yard Curie Day Decade ten years Decare Decilitre MLD BFT BHP BTU BUA BUI CDL CCT CNT DTN CGM CLT CMT WCD CKG COU CMQ DMQ FTQ INQ MQH MQS MTQ MMQ YDQ CUR DAY DEC DAA DLT Decimetre Decitonne Degree Celsius Degree Fahrenheit Degree Kelvin Kelvin Displacement tonnage Dozen Dozen packs Dozen pairs Dozen pieces Dozen rolls Drachm GB 3 887935 g Dram GB 1 771745 g Dram US 3 887935 g Dry Barrel 115 627 dm3 Dry gallon 4 404884 dm3 Dry pint 0 55061 dm3 Dry quart 1 101221 dm3 Farad Fluid ounce 28 413 cm3 Fluid ounce 29 5735 cm3 Foot 0 3048 m Gallon 4 546092 dm3 Gigabecquerel Gigawatt hour 1 million kW h Gill 0 142065 dm3 Gill 11 8294 cm3 Grain GB US 64 798910 mg Gram of fissile isotopes Gram Great gross 12 gross DMT DTN CEL FAH DPT DZN DZP DZR DCP DRL DRM DRI DRA BLD GLD QTD FAR OZI OZA FOT GLI GBQ GWH GII GIA GRN GFI GRM GGR Payflow Pro Developer s Guide TABLE G 3 Units of measure Codes
142. loper s Guide Responses to Transaction Requests RESULT Values and RESPMSG Text TABLE 6 9 Payflow Transaction RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 104 Timeout waiting for processor response Try your transaction again 105 Credit error Make sure you have not already credited this transaction or that this transaction ID is for a creditable transaction For example you cannot credit an authorization 106 Host not available 107 Duplicate suppression time out 108 Void error See RESPMSG Make sure the transaction ID entered has not already been voided If not then look at the Transaction Detail screen for this transaction to see if it has settled The Batch field is set to a number greater than zero if the transaction has been settled If the transaction has already settled your only recourse is a reversal credit a payment or submit a payment for a credit 109 Time out waiting for host response 110 Referenced auth against order Error 111 Capture error Either an attempt to capture a transaction that is not an authorization transaction type or an attempt to capture an authorization transaction that has already been captured 112 Failed AVS check Address and ZIP code do not match An authorization may still exist on the cardholder s account 113 Merchant sale total will exceed the sales cap with current transaction ACH transactions only 114 Card Security Code CSC Mismatch An authorizati
143. lready captured 11 Failed to settle transactions fail settlement usually because of problems with the merchant s processor or because the card type is not set up with the merchant s processor 12 Unsettled transaction because of incorrect account information 14 For various reasons the batch containing this transaction failed settlement 15 Settlement incomplete due to a charge back 16 Merchant ACH settlement failed need to manually collect it 106 Unknown Status Transaction Transactions not settled 206 Transactions on hold pending customer intervention DATE TO SETTLE Date format 19 Value available only before settlement has started YYYY MM DD HH MM SS BATCHID Integer 10 Value available only after settlement has assigned a Batch ID SETTLE DATE Date format 19 Value available only after settlement has completed YYYY MM DD HH MM SS Payflow Pro Developer s Guide 141 D VERBOSITY Viewing Processor Specific Transaction Results Supported Verbosity Settings TABLE D 2 Processor responses Continued Field Name Type Length Description AMEXID Numeric 15 American Express transactions meeting CAPN requirements NOTE Used only by merchants who authorize transactions through the payflow gateway but settle through a third party solution AMEXPOSDATA Alphanumeric 12 American Express transactions meeting CAPN requirements NoTE Used only by merchants who autho
144. merican Express Brighton FDMS North American Processing Platform Express Discover Master Card Visa American Express Phoenix X X NEC NE NE FDMS Nashville X X X X X X X X Payflow Pro Developer s Guide Credit Card Transactions a Card Security Code Validation TABLE 4 13 Processing platforms supporting card security code American Processing Platform Express Discover Master Card Visa FDMS South X X X X Global Payments Central X X X X Global Payments East X X X X Merchant e Solutions X X X X Elavon formerly Nova X X X X Paymentech Salem New X X X X Hampshire Paymentech Tampa X X X X TSYS Acquiring Solutions X X X X formerly Vital Processing Services Payflow Pro Developer s Guide 47 Credit Card Transactions Card Security Code Validation 48 Payflow Pro Developer s Guide Credit Card Testing To test your application direct all transactions to the host address for testing For details see Host Addresses on page 13 Transactions directed to this URL are processed through PayPal s simulated payment network enabling you to test the configuration and operation of your application or storefront no money changes hands You must activate your account and configure your application for live transactions before accepting real orders Testing Guidelines The following are testing guidelines e While testing use only the credit card numbers listed in this chapter Other numb
145. mple TSYS Acquiring Solutions Level 2 Visa Transaction Parameter String RXTYPE S amp ACCT 4111111111111111 amp AMT 20 02 amp CITY Mountain View amp COMMENT1 L2 Testing amp EXPDATE 1209 amp INVNUM 661254585 amp NAME CardHolder Name amp PARTNER PayPal amp PWD pwd amp STATE CA amp STREET 123 Main St amp TAXAMT 1 01 amp TAXEXEMPT N amp TENDER C amp USER user amp ZIP 94043 TSYS Acquiring Solutions Level 3 MasterCard Parameters To qualify for Level 3 purchasing card transaction processing the authorization response for the transaction must have the commercial card indicator set and one or more line items should be present in the Delayed Capture or Sale request Level 2 transaction parameters marked as mandatory are required for Level 3 transactions Level 3 transactions that do not include the mandatory Level 2 values are rejected IMPORTANT The values required for Level 3 status vary by bank so contact your bank for details 132 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions TSYS Acquiring Solutions Purchasing Card Transaction Processing TSYS Acquiring Solutions Level 2 MasterCard Parameters Required for Level 3 Line Item Transactions TABLE C 28 TSYS Acquiring Solutions Level 2 MasterCard transaction data for line item transactions Mandatory Length Name Optional Payflow Parameter Data Type Purchase Identifier M
146. n the track data and pass that number Length tags are described in Using Special Characters in Values on page 20 NOTE SWIPE card present transactions are not supported by the PayPal processor Limitations Alphanumeric characters 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 When To Use a Sale Transaction A Sale transaction is best suited to businesses that provide immediate fulfillment for their products or services If your business does not provide immediate fulfillment then credit card association rules recommend that you use an Authorization and a Delayed Capture transaction For details see Submitting Authorization Delayed Capture Transactions on page 29 If you need to recharge a credit card and you are not storing the credit card information in your local database you can perform a new reference transaction based on a Sale transaction Additional Parameters For Sale Transactions To perform a Sale transaction you are required to pass the following parameters e ACCT e AMT e EXPDATE Note The pinless debit tender type requires essentially the same parameters as a credit card transaction In addition to the values required by all transactions you must pass values for the
147. ng character lengths e Visa 25 e MasterCard 22 e AMEX 20 e DISC 22 Some card associations truncate the value to 19 characters If you have questions consult the card association ERCHSVC Defaults to CITY where the merchant outlet is No Alpha 13 located for retail and to PHONENUM for non retail numeric For example 800 111 1111 Use uppercase characters The first three positions must be numeric Payflow Pro Developer s Guide 77 Processors Requiring Additional Transaction Parameters Merchant e Solutions Merchant e Solutions Merchant e Solutions Additional Credit Card Parameters In addition to the parameters in Table 4 1 Credit card transaction request parameters Merchant e Solutions accepts the following parameters TABLE A 6 TSYS Acquiring Solutions additional parameters Parameter Description Required Type Length INVNUM Merchant invoice number The merchant invoice number No Alpha 9 is used for authorizations and settlements and numeric 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 SWIPE Allows Track 1 and Track 2 data to be passed to enablea Alpha 80 card present transaction numeric RECURRING Identifies the transaction as recurring This value does No Alpha 1 not activate PayPal s Recurrin
148. nish Peseta 724 0 Austrian Schilling 40 2 Swedish Krona 752 2 Belgian Franc 56 0 Swiss Franc 756 2 Canadian Dollar 124 2 Thailand Baht 764 2 Chilean Peso 152 2 Pound Sterling 826 2 Czech Koruna 203 2 Russian Ruble 810 2 Danish Krone 208 2 U S Dollar 840 2 Dominican Peso 214 2 Bolivar 862 2 Markka 246 2 New Taiwan Dollar 901 2 French Franc 250 2 Euro 978 2 Deutsche Mark 280 2 Polish New Zloty 985 2 Drachma 300 0 Brazilian Real 986 2 Hong Kong Dollar 344 2 Indian Rupee 356 2 Irish Punt 372 2 Shekel 376 2 Italian Lira 380 0 Yen 392 0 Won 410 0 Luxembourg Franc 442 0 Mexican Duevo Peso 484 2 Netherlands Guilder 528 2 New Zealand Dollar 554 2 Norwegian Frone 578 2 Philippine Peso 608 2 166 Payflow Pro Developer s Guide XMLPay About XMLPay XMLPay specifies an XML syntax for payment requests and associated responses in payment processing network Instead of using name value pairs the Payflow SDK allows the use of XML documents based on XMLPay 2 0 schema The typical user of XMLPay is an internet merchant or merchant aggregator who wants to dispatch credit card corporate purchase card Automated Clearinghouse ACH or other payment requests to a financial processing network Using the data type definitions specified by XMLPay such a user creates a client payment request and dispatches it in the same fashion as using name value pairs to an associated XML Pay compliant server component Responses are also formatted in XML
149. nsaction should include all Level 3 data since it is authorized and later settled Accepted BIN Ranges Visa MasterCard and American Express publish specific Bank Identification Number BIN ranges for purchasing cards Sometimes the determination of whether a card is a purchasing card is left to the processor for example TSYS Acquiring Solutions In other cases the Payflow payments gateway makes the determination based on the BIN range for example FDMS South and American Express BIN ranges accepted for American Express Level 2 and Level 3 transactions are listed on page 102 About American Express Purchasing Card Transactions Phoenix Processor The information in this section applies to transactions processed by the American Express Phoenix Processor not necessarily to all American Express cards Level 2 and Level 3 purchasing card rules may differ for American Express card transactions processed by other processors such as Paymentech or First Data Nashville 1 Formerly Vital Processing Services 100 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions About American Express Purchasing Card Transactions Phoenix Processor Supported Transaction Types You can submit Level 3 parameters with Delayed Capture Sale Credit or Force transactions Level 3 data in Authorization transactions is ignored The Payflow payments gateway decides whether a transaction meets Level 3 requirem
150. o Alpha 13 numeric INVNUM Merchant invoice number The merchant invoice Alpha 9 number is used for authorizations and settlements numeric 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 ORDERDATE Order date No Numeric 7 For example July 28 2003 is 072803 Format mmddyy with no slashes or dashes 88 Payflow Pro Developer s Guide Processors Requiring Additional Transaction Parameters A TSYS Acquiring Solutions TABLE A 10 Additional TSYS Acquiring Solutions parameters to meet CAPN requirements Continued Parameter ORDERDAT ETIME SWIPE Description 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 RESULT 7 SIG FIELD ERR RESPMSG Invalid ORDERTIME A truncated version of the ORDERTIME value up to 7 characters overwrites any value provided by ORDERDATE If no value is provided a NULL value is stored Allows Track 1 and Track 2 data to be passed to enable a card present transaction Required Type Length No 19 No Alpha 80 numeric TSYS Acquiring Solutions
151. o get the discount rate TABLE C 22 Paymentech Salem New Hampshire Level 2 legacy parameters Format Paymentech Mandatory min max Data Items Optional Payflow Parameter type Customer Ref No M PONUM 1 17 char Sales Tax M TAXAMT NUM Must include a decimal and be exact to the cent 42 00 not 42 and exclude comma separators 1234 56 not 1 234 56 To qualify for Level 2 discounts this value must not be all zeros or blank spaces 126 Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions Paymentech Salem New Hampshire Purchasing Card Transaction Processing Example Paymentech Salem New Hampshire Level 2 Visa and MasterCard Transaction Parameter String TRXTYPE S amp TENDER C amp PARTNER Partner amp PWD Password amp USER User amp ACCT 54 8018000000 0024 amp EXPDATE 1203 amp AMT 1 00 amp COMMENT 1 0508 amp NAME Robert amp STREET 1600 amp ZIP 94065 amp CVV2 42 6 amp PONUM ABCDEF GHIJ amp TAXAMT 1 00 TRXTYPE S amp TENDER C amp PARTNER Partner amp PWD Password amp USER User amp ACCT 427533001234 5626 amp EXPDATE 1203 amp AMT 1 00 amp COMMENT1 20508 amp STREET 1600 amp ZIP 94065 amp CVV2 426 amp PON UM ABCDEFGHIJ amp TAXAMT 1 00 Example American Express Level 2 Transaction Parameter String TRXTYPE S amp TENDER C amp PARTNER Partner amp PWD Password amp USER User amp ACCT 378734493671 000 amp EXPDATE 1203 amp AMT 1 00 amp COMMENT1 0508 amp NAME Robert amp STREET 1600 amp Z
152. ocessors Requiring Additional Transaction Parameters TSYS Acquiring Solutions TABLE A 10 Additional TSYS Acquiring Solutions parameters to meet CAPN requirements Continued Parameter Description Required Type Length AIR CARRIERn Two character airline code for each unique airline No Alpha 5 in this flight where n is a value from 1 to 10 numeric If the same carrier is used for multiple segments of the trip it is passed only once For example the two AIR CARRIER7 values for the following trip are UA and AA UA flight from IAD to DEN UA flight from DEN to LAX UA flight from LAX to SFO AA flight from SFO to DFW For information about airlines codes see http en wikipedia org wiki Airline_codes All AIR FAREBASIS List discounts associated with the travel No Alpha 24 numeric AIR Number of passengers on this trip No Numeric NUMBEROF PASSENGER S AIR ISETICKET If this is an electronic ticket The values are No Alpha 1 Y yes numeric N no AIR Code assigned to the travel reservation before the No Alpha 15 RESERVATIONCODE ticket was purchased numeric Other FIRSTNAME Account holder s first and last name Note Even No Alpha 13 though the parameter name indicates only the first numeric name this single parameter holds all of the person s name information both first and last name at a minimum LASTNAME Account holder s last name N
153. oid Transactions The Void transaction TRXTYPE V prevents a transaction from being settled As part of its internal process PayPal makes reasonable effort to process authorization reversals for void transactions for debit and credit cards if the processor supports it for a given card type Because the honoring of authorization reversals is ultimately decided by the bank or issuer there is no accurate way to determine if an individual bank or issuer has honored an authorization reversal request For more information on authorization reversals see http en wikipedia org wiki Authorization hold When To Use a Void Transaction Follow these guidelines e You can void Delayed Capture Sale Credit Authorization and Voice Authorization transactions You cannot void a Void transaction e 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 you must submit a Credit transaction Payflow Pro Developer s Guide Required Void Transaction Parameters Credit Card Transactions Submitting Void Transactions To submit a Void transaction you must pass the following parameter ORIGID TABLE 4 7 Void required parameter Parameter ORIG Description ID Required by some transaction types ID of the original transaction that is being referenced This ID is returned by the PNREF parameter and appears as the Transaction ID in PayPal
154. on RESULT Values and RESPMSG Text RESULT RESPMSG and Explanation 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 Instead of receiving a PARes response to a Validate Authentication transaction an error response was received 1017 Buyer Authentication Service 3 D Secure error response is invalid An error response is received and the response is not well formed for a Validate Authentication transaction 1021 Buyer Authentication Service Invalid card type 1022 Buyer Authentication Service Invalid or missing currency code 1023 Buyer Authentication Service merchant status for 3D secure is invalid 1041 Buyer Authentication Service Validate Authentication failed missing or invalid PARES 1042 Buyer Authentication Service Validate Authentication failed PARES format is invalid 1043 Buyer Authentication Service Validate Authentication failed Cannot find successful Verify Enrollment 1044 Buyer Authentication Service Validate Authentication failed Signature validation failed for PARES 1045 Buyer Authentication Service Validate Authentication failed Mismatched or invalid amount in PARES 1046 Buyer Authentication Service Validate Authentication failed Mismatched or invalid acquirer in PARES 1047 Buyer Authentica
155. on may still exist on the cardholder s account 115 System busy try again later 116 VPS Internal error Failed to lock terminal number 117 Failed merchant rule check One or more of the following three failures occurred An attempt was made to submit a transaction that failed to meet the security settings specified on the PayPal Manager Security Settings page If the transaction exceeded the Maximum Amount security setting then no values are returned for AVS or CSC AVS validation failed The AVS return value should appear in the RESPMSG CSC validation failed The CSC return value should appear in the RESPMSG 118 Invalid keywords found in string fields 120 Attempt to reference a failed transaction 121 Not enabled for feature Website Payments Pro Payflow Edition Developer s Guide 61 62 Responses to Transaction Requests RESULT Values and RESPMSG Text TABLE 6 9 Payflow Transaction RESULT Values and RESPMSG Text RESULT 122 125 126 127 128 132 133 150 151 200 201 600 601 1000 1001 1002 1003 1004 1011 1012 RESPMSG and Explanation Merchant sale total will exceed the credit cap with current transaction ACH transactions only Fraud Protection Services Filter Declined by filters Fraud Protection Services Filter Flagged for review by filters I MPORTANT RESULT value 126 indicates that a transaction triggered a fraud filter This is not an error but a notice that the transaction is in
156. onal For Inquiry transactions when using CUSTREF to specify the transaction ENDTIME specifies the end of the time period during which the transaction specified by the CUSTREF occurred See STARTTIME ENDTIME must be less than 30 days after STARTTIME An inquiry cannot be performed across a date range greater than 30 days If you set ENDTIME and not STARTTIME then STARTTIME is defaulted to 30 days before ENDTIME If neither STARTTIME nor ENDTIME is specified then the system searches the last 30 days Limitations 14 numeric characters in the format yyyymmddhhmmss ENDTIME Optional For Inquiry transactions when using CUSTREF to specify the transaction ENDTIME specifies the end of the time period during which the transaction specified by the CUSTREF occurred See STARTTIME Limitations 14 numeric characters I MPORTANT If there are multiple transactions with a particular CUSTREF value then the Inquiry transaction returns only the last transaction with the specified CUSTREF So to ensure that you can always access the correct transaction you must use a unique CUSTREF when submitting any transaction including retries Inquiry Transaction Parameter String Using the CUSTREF This is an example Inquiry transaction parameter string using the CUSTREF Payflow Pro Developer
157. ons as extended data TABLE C 17 Merchant e Solutions Level 3 Visa extended data Merchant e Solutions Name Summary Commodity Code Discount Amt Freight Amt Duty Amt Order Date Dest Postal ZIP Code Mandatory Optional M olo zio Length Payflow Parameter Data Type COMMCODE 4 AN Commodity code identifier for the business DISCOUNT 12 NUM FREIGHTAMT 12 NUM DUTYAMT 12 NUM ORDERDATE 6 NUM Format is mmddyy with no slashes or dashes For example July 28 2003 is 072803 SHIPTOZIP 10 AN The zip code of the address to which the goods are shipped Payflow Pro Developer s Guide Submitting Purchasing Card Level 2 and Level 3 Transactions Merchant e Solutions Purchasing Card Transaction Processing TABLE C 17 Merchant e Solutions Level 3 Visa extended data Continued Merchant e Mandatory Length Solutions Name Optional Payflow Parameter Data Type Ship from Postal ZIP M SHIPFROMZIP 10 AN Code The postal code called zip code in the USA from which shipping occurs Dest Country Code SHIPTOCOUNTRY 4 AN VAT Registration M VATREGNUM 20 AN Number Can be part of the registration data or passed with each transaction Unique VAT Inv Ref M INVNUM 9 AN Can be part of the registration data or passed with each transaction Cust VAT Registr M CUSTVATREGNUM 13 AN VAT Tax Amt VATTAXAMT 12 NUM Freight Ship VAT Tax Rate VATTAXPERCENT 4 NUM F
158. ormation street address and ZIP postal code Address verification service compares the submitted billing street address and zip code with the values on file at the cardholder s bank The response includes values for AVSADDR and AVSZIP Y N or X for the match status of the customer s street address and zip code Y match N no match X cardholder s bank does not support address verification service The address verification service result is for advice only Banks do not decline transactions based on the address verification service result the merchant makes the decision to approve or decline a transaction Address verification service is supported by most US banks and some international banks Note Address verification service checks only for a street number match not a street name match so 123 Main Street returns the same response as 123 Elm Street The international address verification service LAVS response indicates whether address verification service response is international Y USA N or cannot be determined X Processing Platforms Supporting Address Verification Service TABLE 4 12 Processing platforms supporting Address Verification Service American Processing Platform Express Discover Master Card Visa American Express Phoenix X 44 Payflow Pro Developer s Guide Credit Card Transactions Example Address Verification Service Request Parameter List TABLE 4 12 Processing platform
159. ou perform these two steps either as a single transaction or as two transactions depending on your business model For an Authorization the server sends the transaction information to a credit card processor who routes the transaction through the financial networks to the cardholder s issuing bank The issuing bank checks whether the card is valid evaluates whether sufficient credit exists checks values such as address verification service and card security codes discussed below and returns a response Approved Declined Referral or other response values You receive the response a few seconds after you submit the transaction to the server If an Authorization is approved the bank temporarily reserves the credit for the amount of the transaction to prepare to capture fulfill the transaction The hold on funds typically lasts for about a week Payflow Pro Developer s Guide 23 24 Credit Card Transactions About Credit Card Processing Note You cannot remove a hold on funds through the processing networks you must contact the card issuing bank to lift a hold early Capturing a transaction actually transfers the funds to your bank At least once a day PayPal gathers all transactions that are flagged to be settled and sends them in a batch file to the processor The processor then charges the issuing bank and transfers the funds to your bank It typically takes a few days before the money is actually available in your account depen
160. pears on the back of most credit cards On American Express the number appears above and to the right of the embossed card number Card security code is known by other names such as CV V2 depending on the type of card If card security code data is submitted the issuer can notify you whether the number matches the number assigned to the card Card security code is described on page Card Security Code Validation on page 46 It may also be possible to implement additional safeguards yourself or to use a fraud service You might want to discuss risk management with your Internet Merchant Account provider e Store information in your local database or use PayPal Manager reports to manage the data You may want to store shipping information in your system or you may prefer to send the information to PayPal with the transaction and report on it later Note PayPal recommends that you do not store credit card numbers If you must store numbers encrypt and store them behind properly configured firewalls You should also consider whether and how to use the merchant defined fields COMMENTI and COMMENT to help tie reports to your orders customers or to report on other information about the transaction e Ifor how you want to integrate with other systems such as order fulfillment customer service and so on You may wish to connect these systems directly to Payflow Pro for capturing funds issuing refunds credits and so on Alternatively yo
161. pplication to process credit card transactions over the Payflow payments gateway It includes information and special requirements for all supported processors To process Express Checkout transactions over the Payflow gateway see the following Payflow guide Express Checkout for Payflow Pro Intended Audience This guide assumes that its readers e Are experienced web or application developers e Have a background in payments services Related Documentation For additional Payflow information e See the Payflow documentation set on PayPal Developer Central Go to https www paypal com developer and click the Documentation link on the Library tab e For more examples and very current information see the Payflow developer forums For additional help see the Help Center at the following URL https www paypal com us cgi bin helpweb cmd help How to Contact Customer Support For problems with transaction processing or your connection to the server contact Customer Support by opening a ticket on the under Contact Support tab at http www paypal com mts Payflow Pro Developer s Guide 8 Revision History Revision History Revision history for Payflow Pro Developer s Guide TABLE 1 1 Revision history Date October 2009 June 2009 April 2009 November 2008 June 2008 March 2008 February 2008 Description Added COMPANYNAME to reporting parameters e Added new appendix on additional pro
162. ption Freeform description Required Yes Yes Type Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric Length 17 16 40 40 40 40 Example American Express Phoenix Level 2 Transaction Parameter String TRXTYPI View amp Dl ardholder Name amp PARTNER PayPa Main S ESCl 2desclS amp DI t amp TENDER C amp USER user amp ZIP 123451234 American Express Phoenix Level 3 Parameters E S amp ACCT 372449635311003 amp AMT 20 06 amp CITY Mountain ESC2 desc2 amp DESC3 desc3 amp DESCA FRT10 00 amp EXPDATE 1209 amp NAI l amp PONUM 12345 amp PWD pwd amp SHIPTOZIP 94045 amp STATE CA amp STRI EET 123 The American Express Phoenix platform supports Level 3 transaction data PayPal provides the Merchant Registration data values Supplier Name Supplier City Supplier State Supplier Payflow Pro Developer s Guide 105 106 Submitting Purchasing Card Level 2 and Level 3 Transactions American Express Phoenix Purchasing Card Transaction Processing Postal code Merchant No and Federal Tax ID The merchant provides the values listed in Table C 4 TABLE C 4 American Express Phoenix Level 3 Parameters AMEX Name per American Express Specification Supplier Reference Number Authorization Code Requester Name Cardmember Reference No Ship to ZIP Invoice Date Mandatory
163. pts each transaction request using the latest Secure Sockets Layer SSL encryption and establishes a secure link with the Payflow server over the internet The Payflow server a multi threaded processing environment receives the request and transmits it over a secure private network to the appropriate financial processing network for real time payment authorization The response approved declined and so on is received from the financial network and is returned in the same session to the Payflow client The Payflow client completes each transaction session by transparently sending a transaction receipt to the server before disconnecting the session The entire process is a real time synchronous transaction Once connected the transaction is immediately processed and the answer returned in about three seconds Processing transactions through the Payflow service does not affect or define the time periods of authorizations nor does it influence the approval or denial of a transaction by the issuer When integrating with Payflow Pro you need only be concerned with passing all the required data for transaction authorization For transactions that you want to be settled close batch the operation is handled by PayPal Supported Processing Platforms Payflow Pro supports the following processing platforms PayPal American Express Phoenix American Express Brighton First Data Merchant Services FDMS Nashville First Dat
164. purchasing card transactions with FDMS South TABLE C 8 FDMS South Level 2 and Level 3 purchasing card parameters Pa rameter CITY SHIPTOCOUNTRY CUSTCODE DISCOUNT DUTYAMT FRI RSTNAME EIGHTAMT INVNUM LASTNAME ORDERDATE Description Cardholder s city Destination Country Code Visa and MasterCard are different Refer to Country Code tables See Appendix F ISO Country Codes Customer code customer reference ID Discount amount on total sale 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 See FDMS South Currency Codes and Decimal Positions on page 166 Cardholder s first name Freight amount If the currency uses a decimal then the value must include a decimal and the exact amount to the cent 42 00 not 42 Do not include comma separators 1234 56 not 1 234 56 See FDMS South Currency Codes and Decimal Positions on page 166 Merchant invoice number This reference number PNREF generated by PayPal is used for authorizations and settlements The acquirer decides if this information will appear on the merchant s bank reconciliation statement Cardholder s last name Order date Format is mmddyy with no slashes or dashes For example July 28 2003 is 072803
165. quired Type Length Specifies an order time and date No Format is either YYYY MM DD or YYYY MM DD HH MI SS where HH is in 24 hour time If the value does not conform to one of the formats or if the date is not valid for example 2004 17 35 then the transaction is rejected with RESULT 7 SIG FIELD ERR RESPMSG Invalid ORDERTIME A truncated version of the ORDERTIME value up to 7 characters overwrites any value provided by ORDERDATE If no value is provided a NULL value is stored Identifies the transaction as recurring This value No does not activate PayPal s Recurring Billing Service APIs If the RECURRING parameter was set to Y for the original transaction then the setting is ignored when forming Credit Void and Force transactions If you subscribe to PayPal s Fraud Protection Services To avoid charging you to filter recurring transactions that you know are reliable the fraud filters do not screen recurring transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Manual Transactions page The filters screen the transaction in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results Allows Track 1 and Track 2 data to be passed to No enable a card present transaction 19 Alpha 1 numeric YorN Alpha 80 numeric Payflow Pro Developer s
166. r MEDIUM Setting the Default Verbosity Level for All Transactions Contact Customer Service to set your account s VERBOSITY setting to LOW or MEDIUM for all transaction requests For details see How to Contact Customer Support on page 9 144 Payflow Pro Developer s Guide Additional Reporting Parameters This appendix lists parameters whose values can appear in PayPal Manager reports For example the Shipping and Billing report displays these values Some of the following parameters may also have other purposes The STREET and ZIP parameters for instance are also used for Address Verification Service Note For regular credit card transactions reporting parameters are normally not passed to the processor See Appendix A Processors Requiring Additional Transaction Parameters to learn which fields are sent to your processor TABLE E 1 Additional reporting parameters Parameter CITY COMMENT1 COMMENT2 BILLTOCOUNTRY COMPANYNAME CUSTCODE DUTYAMT EMAIL FIRSTNAME FREIGHTAMT LASTNAME Description Cardholder s billing city User defined value for reporting and auditing purposes PayPal parameter only User defined value for reporting and auditing purposes PayPal parameter only Cardholder s billing country code Cardholder s company Customer code Duty amount Cardholder s email address Cardholder s first name Freight amount Cardholder s las
167. r a lower amount In the case of a split shipment you can perform a Delayed Capture transaction for the initial shipment and a reference transaction for the final payment These transaction types plus the details of performing a Delayed Capture for an amount higher than the original are described in Delayed Capture Transaction Capturing Transactions for Higher Amounts on page 32 According to card association rules most physical goods merchants should use a two step process since settlement should occur when the goods are fulfilled or shipped A two step process is also useful if you want to evaluate 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 e Whether or how to use risk management tools such as address verification service and card security code For address verification service if the data is submitted with the initial transaction the issuer checks the street address and or the zip postal code against the Payflow Pro Developer s Guide Credit Card Transactions About Credit Card Processing billing address on file for the consumer Address verification service is described on page Using Address Verification Service on page 44 Card security code refers to a 3 or 4 digit number that ap
168. r from 1 to 6 numeric L AMTn Amount of this line item n is a line item number No Numeric 12 from 1 to 6 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 L_OTYn Quantity of this line item n is a line item number No Numeric 3 from 1 to 6 Internet Transaction Data Parameters EMAIL Account holder s email address No Alpha 60 numeric PHONENUM Account holder s telephone number No String 20 PHONETYPE Telephone company provided ANI information No Alpha 2 identifier digits indicating the telephone call type numeric Examples cellular 61 63 payphone 27 Payflow Pro Developer s Guide 83 Processors Requiring Additional Transaction Parameters TSYS Acquiring Solutions TABLE A 10 Additional TSYS Acquiring Solutions parameters to meet CAPN 84 requirements Continued Parameter Description Required Type Length CUSTHOSTNAME Name of the server that the account holder is No Alpha 60 connected to numeric Example PHX QW AOL COM and special characters CUSTBROWSER Account holder s HTTP browser type No Alpha 60 Example numeric MOZILLA 4 0 COMPATIBLE MSIE 5 0 W INDOWS 95 special characters CUSTIP Account holder s IP address No Alpha 15 numeric and special characters SHIPTOCOUNTRY Numeric country code of ship to country No Alpha 3 Exampl
169. r the transaction was approved This is an example response to a credit card Sale transaction request RESULT 0 amp PNREF VXYZ01234567 amp RESPMSG APPROVED amp AVSADDR Y amp AVSZIP N amp IAVS Y amp CVV2 MATCH Y Formatting Transactions For details on how to format a transaction based on the above information see the examples and the supporting documentation provided with your SDK 22 Website Payments Pro Payflow Edition Developer s Guide Credit Card Transactions This chapter describes how to plan for implementing credit card processing presents the core set of parameters used by all credit card processors explains how to submit a transaction for each transaction type supported and describes other credit card features such as card security Credit Card Features Payflow Pro supports the following transaction types for credit card processing e Sale e Authorization including Account Verification e Voice Authorization e Delayed Capture e Credit e Void e Inquiry Payflow Pro also supports the following credit card features e Recharging to the same credit card also called reference transactions e Securing credit card transactions by means of the Address Verification Service and card security code validation About Credit Card Processing Credit card processing occurs in two steps a real time Authorization and a capture settlement of the funds that were authorized As discussed below y
170. reight Ship Payflow Pro Developer s Guide 121 Submitting Purchasing Card Level 2 and Level 3 Transactions Merchant e Solutions Purchasing Card Transaction Processing Merchant e Solutions Level 3 Visa Line item Detail Records TABLE C 18 Merchant e Solutions Level 3 Visa line item detail record Mandatory Length Data Merchant e Solutions Name Optional Payflow Parameter Type NOTE For these values n is a sequence counter that should begin with 1 and increase in sequence Each line item should also contain quantity L_OTY lt n gt and unit price L_COST lt n gt fields Item Commodity Code O L COMMCODEn 12 AN Item Descriptor M DESCn 35 AN Product Code M L UPCn 12 AN Quantity M L_QTYn 12 NUM Unit of Measure Code M L_UOMn 12 AN Unit Cost M COSTn 12 NUM VAT Tax Amount L_TAXAMTn 12 NUM VAT Tax Rate L_TAXRATEn 4 NUM Discount Per Line Item M L_DISCOUNTn 12 NUM Line item Total L_AMTn 12 NUM Example Merchant e Solutions Level 3 Visa Transaction Parameter String TRXTYPE S amp TENDER C amp PARTNER Partner amp USER User amp PWD Password amp ACCT 411111111111 1111 amp EXPDATE 0406 amp AMT 1 00 amp STREET 5199 JOHNSON amp TAXAMT 106 amp ZIP 94588 amp ALTTAXAMT 1 00 amp CUSTVATREGNUM 11111 amp LOCALTAXAMT 1 01 amp NATIONALTAXAMT 1 02 amp COMMCODE 22222 amp VATAXAMT 1 03 amp VATAXPERCENT 55 amp TAXE XEMPT N amp DISCOUNT 50 amp FREIGHTAMT 1 00 amp DUTYAMT 1 00 amp SHIPTOZIP 33333 amp
171. rization TRXTYPE A transaction places a hold on the cardholder s open to buy limit lowering the cardholder s limit by the amount of the transaction It does not transfer funds A Delayed Capture TRXTYPE D transaction is performed after an Authorization to capture the original Authorization amount The Delayed Capture is scheduled for settlement during the next settlement period Because Visa and MasterCard regulations prohibit capturing credit card transaction funds until a product or service has shipped to the buyer most processing networks implement an Authorization transaction followed by a Delayed Capture transaction When To Use Authorization Delayed Capture Transactions If your business does not provide immediate fulfillment of products or services you should use this two stage transaction solution also known as Delayed Capture processing because it enables you to capture credit card transaction funds when your are ready to collect them Note If you signed up for the PayPal processor with Fraud Protection Services you must 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 28 If you need to recharge a credit card and you are not storing the credit card information in your local database you can p
172. rize transactions through the payflow gateway but settle through a third party solution 142 Payflow Pro Developer s Guide VERBOSITY Viewing Processor Specific Transaction Results Supported Verbosity Settings TABLE 0 2 Processor responses Continued Field Name Type Length Description VISACARDLEVEL Alphanumeric 2 Card product level indicator returned by VISA The values are A Visa Traditional B Visa Traditional Rewards C Visa Signature D Visa Infinite E Reserved F Reserved G Visa Business Card H Visa Check Card I Visa Commerce J Reserved K Visa Corporate Card L Reserved M MasterCard EuroCard and Diners N Reserved O Reserved P Reserved Q Private Label R Proprietary Card S Visa Purchasing Card T Reserved Interlink U Visa TravelMoney W Z Reserved 0 9 Reserved Visa Signature Business G2 Visa Business Check Card J1 Visa General Prepaid J2 Visa Prepaid Gift Card J3 Visa Prepaid Healthcare J4 Visa Prepaid Commercial Visa GSA Corporate T amp E Q1 Private Label Prepaid S1 Visa Purchasing with Fleet S2 Visa GSA Purchasing 53 Visa GSA Purchasing with Fleet Reserved DI Discover AX American Express Because length is 2 single character values are followed by a space Payflow Pro Developer s Guide 143 D VERBOSITY Viewing Processor Specific Transaction Results Changing th
173. s 139 Changing the Verbosity Setting 144 Setting the Verbosity Level on a Per Transaction 144 Setting the Default Verbosity Level for All Transactions 144 Appendix E Additional Reporting Parameters 145 Appendix F ISO Country Codes 147 Appendix Codes Used by FDMS South Only 153 MasterCard Country Codes 153 Visa Country Codes 157 Units 161 FDMS South Currency Codes and Decimal Positions 166 Appendix 167 About 167 Payflow Pro XMLPay Developer s Guide 167 Appendix Additional Processor Information 169 Moneris Solutions lll ll lS 169 171 Payflow Pro Developer s Guide Preface This guide describes Payflow Pro a high performance TCP IP based Internet payment solution and how to use it to process credit card Payflow Pro is pre integrated with leading e commerce solutions and is also available as a downloadable software development kit SDK Scope This guide explains how to integrate Payflow Pro into your website or a
174. s 30 Typical Authorization Transaction Parameter 0 30 Required Delayed Capture Transaction Parameters 30 Delayed Capture Transaction Capturing Transactions for Lower Amounts 32 Delayed Capture Transaction Capturing Transactions for Higher Amounts 32 Delayed Capture Transaction Error Handling and Retransmittal 32 Submitting Account Verifications With TRKTYPEZA 32 When To Use Account Verification 33 Example Account 33 Submitting Voice Authorization Transactions 33 When to Use a Voice Authorization 33 Required Voice Authorization Transaction Parameters 34 Submitting Credit Transactions 34 Required Credit Transaction Parameters 34 Credit Transaction Parameter 5 5 36 Submitting Void 5 36 When Use a Void 36 Required Void Transaction Parameters 37 Example Void Transaction Parameter String 37 Submitting Inquiry 5 38 When Use an Inquiry Transaction
175. s that you know are reliable the fraud filters do not screen recurring transactions To screen a prospective recurring customer submit the transaction data using PayPal Manager s Virtual Terminal page The filters screen the transaction in the normal manner If the transaction triggers a filter then you can follow the normal process to review the filter results Payflow Pro Developer s Guide Performing TeleCheck Electronic Check Transactions This chapter describes Telecheck electronic check transaction processing and testing Note TeleCheck transactions are not supported on the PayPal processor Paypal offers electronic check acceptance through TeleCheck Before processing electronic check transactions merchants must obtain an account through TeleCheck www telecheck com For information on e Performing credit card transactions skip this chapter and see Credit Card Transactions on page 23 e Performing ACH transactions contact your PayPal Sales Representative at paymentsales PayPal com TeleCheck Parameters Parameters used for processing electronic checks through TeleCheck are described in Table B 1 Required and optional parameters are noted Note Appendix E Additional Reporting Parameters provides a list of parameters that you can pass for reporting purposes Required Parameters As a summary of Table B 1 the following parameters are required for every electronic check transaction
176. s Guide 39 Credit Card Transactions Recharging to the Same Credit Card Reference Transactions TRXTYPE 1 amp TENDER C amp PARTNER PayPal amp VENDOR SuperMerchant amp USER SuperMerchant amp P WD x1ly2z3 amp CUSTREF Inv00012345 Recharging to the Same Credit Card Reference Transactions If you need to recharge a credit card and you are not storing the credit card information in your local database you can perform a reference transaction A reference transaction takes the existing credit card information that is on file and reuses it Note The PNREF returned in the original transaction is valid for use in reference transactions for a period of 12 months A PNREF returned by Account Verification also can be used in a reference transaction When To Use a Reference Transaction Say that Joe Smith purchases a holiday gift from your web site store and requests that it be sent by UPS ground service That evening Joe becomes concerned that the item might not arrive in time for the holiday So he calls you to upgrade shipping to second day air You obtain his approval for charging an extra 10 for the upgrade In this situation you can create a reference transaction based on the original Authorization and charge an additional 10 to Joe s credit card without having to ask him again for his credit card information IMPORTANT As a security measure reference transactions are disallowed by default Only yo
177. s supporting Address Verification Service Processing Platform American Express Brighton FDMS Nashville FDMS North FDMS South Global Payments Central Global Payments East Merchant e Solutions Elavon formerly Nova Paymentech Salem New Hampshire Paymentech Tampa TSYS Acquiring Solutions formerly Vital Processing Services American Express Discover Master Card Visa X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X See your processor s information in Processors Requiring Additional Transaction Parameters on page 65 for information on their handling of address verification service Example Address Verification Service Request Parameter List This example request include the address verification service request parameters STREET and ZI E TRXTYPE A amp TEND ER C amp PWD x1y2z3 amp PARTN ER PayPal amp VI ENDOR SuperMerchant amp USER Supe rMerchant amp amp ACCT 5555555555554444 amp EXPDATE 0308 amp AMT 123 00 amp STREET 5199 Maple amp ZIP 98765 Example Address Verification Service Response In this example the address value matches the value in the bank s records but the zip code does not The AVSZIP response is N RI ESULT 0 amp PNRI EF VXWA12345678 amp RK IPZN amp IAVS X Payflow Pro Developer s Guide ESPMSG APPROVI ED amp AUTHCOD E 123456
178. sactions Using the wrong account may result in downgrades e A Sale is the preferred method to use for card present transactions Consult with your acquiring bank for recommendations on other methods Supported Processing Platforms PayPal is certified to submit card present transactions for the following processing platforms e American Express Phoenix e First Data Merchant Services FDMS Nashville e First Data Merchant Services FDMS North e First Data Merchant Services FDMS South e Global Payments Central e Global Payments East e Merchant e Solutions e Elavon Formerly Nova e Paymentech Salem New Hampshire e Paymentech Tampa e TSYS Acquiring Solutions Card present Transaction Syntax Use the SWIPE parameter to pass the Track 1 or Track 2 data the card s magnetic stripe information Include either Track 1 or Track 2 data not both up to 80 alphanumeric characters If Track 1 is physically damaged the POS application can send Track 2 data instead The track data includes the disallowed equal sign character To enable you to use the data the SWIPE parameter must include a length tag specifying the number of characters in the track data For this reason in addition to passing the track data the POS application must count the characters in the track data and pass that number Length tags are described in Using Special Characters in Values on page 20 The length tag in the following example is 40
179. se from credit card network for preauth Common 000402 AVS Time out Preauthorization approved AVS timed out AVS only 000403 PB Approved Private billing approved PB only 000410 Positive Record Previous positive history Common 000420 Test card Approved Test Card Common 000421 OTB AVS Approval Preauthorization approved AVS match AVS only 000503 ANI Bill approved 900 TELCO billing approved ANI bill only TABLE B 7 General Failure HOSTCODE values Code Response Description Frequency 000100 General Failure General host based failure Rare 000101 Invalid Value Invalid for one or more fields in transaction Common 999999 Unknown Response TeleCheck received an unknown response Rare TABLE B 8 Inquiry Declined HOSTCODE values Code Response Description Frequency 000200 Preauth Declined Declined by credit card or Telco network LIDB Common 000201 PIN Mismatch Mismatch on PIN stored in TeleCheck database Not Used 96 Payflow Pro Developer s Guide Performing TeleCheck Electronic Check Transactions HOSTCODE Values TABLE B 8 Inquiry Declined HOSTCODE values Code Response Description Frequency 000210 Negative Card Record Temporary and permanent blocks Prior OTB decline sale Common decline or CS block Transaction falls below minimum scoring standards Most frequently used for risk scoring declines where a transaction falls below minimum standards 000215 Negative ANI Record ANI previously blocked by CS Common 000220 Chargeback Card Card with charge
180. sponse 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 mandatory are required for Level 3 transactions Level 3 transactions that do not include the mandatory Level 2 values are rejected IMPORTANT The values required for Level 3 status vary by bank so contact your bank for details Payflow Pro Developer s Guide 119 120 Submitting Purchasing Card Level 2 and Level 3 Transactions Merchant e Solutions Purchasing Card Transaction Processing Merchant e Solutions Level 2 Visa Parameters Required for Level 3 Transactions TABLE C 16 Merchant e Solutions Level 2 Visa parameters for Level 3 line item transactions Merchant e Solutions Mandatory Length Name Optional Payflow Parameter Data Type Purchase M PONUM 25 AN Identifier Value of TransID is sent if no value is provided Tax Amount M TAXAMT NUM 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 Lcl Tax O LOCALTAXAMT 12 NUM Lcl Tax Incl Flag TAXEXEMPT Y or N 1 AN National Tax Amt O NATIONALTAXAMT 12 NUM Purch Ord Cust M INVNUM 9 AN Ref ID Value of TransID is sent if no value is provided Merchant e Solutions Level 3 Visa Extended Data The parameters listed in Table C 17 apply to Level 3 Visa transacti
181. ss 67 American Express CAPN 68 83 102 124 AMT 101 AMT parameter 27 107 APIs documentation 17 downloading 17 application testing 49 AUTHCODE parameter 34 106 BALAMT 57 BALAMT parameter 57 Bank Identification Numbers See 100 BIN 101 CAPN 68 83 102 124 card acceptance and processing network CAPN 102 124 certification 169 CHKNUM parameter 92 CITY parameter 82 112 close batch see settlement operation COMMCARD parameter 109 COMMCODE parameter 120 135 COMMENT parameter 27 COMMENT parameter 27 credit card verification 23 32 credit transaction type 34 CUSTCODE parameter 112 116 CUSTREF parameter 39 CUSTVATREGNUM parameter 121 136 CVV2 parameterPayflow parameters CVV2 27 D DESC parameter 74 107 DESCI parameter 74 105 DESC2 parameter 74 105 DESC3 parameter 74 105 DESC4 parameter 74 105 developer forums 9 DISCOUNT parameter 110 112 120 128 129 135 DL parameter 92 DOB parameter 92 documentation API 17 downgraded transactions 101 downloading APIs 17 duplicate transactions 26 DUTYAMT parameter 109 110 112 118 120 129 133 135 E Elavon Formerly Nova 79 electronic check transaction required parameters 91 ENDTIME parameter 39 EXPDATE parameter 27 F FDMS CardNet 77 FDMS North 77 110 FDMS South 77 112 firewalls configuring 17 FIRSTNAME parameter 27 73 74 88 112 FREIGHTAMT 101 FREIGHTAMT parameter 107 109 110 112 118 120 128 129 133 135
182. t name Required No No Type Alpha Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric Alpha numeric Max Length 128 128 30 30 10 64 15 10 15 Payflow Pro Developer s Guide 145 Additional Reporting Parameters TABLE E 1 Additional reporting parameters Max Parameter Description Required Type Length NAME Cardholder s name No Alpha 15 numeric PONUM Purchase order number No Alpha 15 numeric SHIPTOCITY Shipping city No Alpha 30 numeric SHIPTOFIRSTNAME First name in the shipping address No Alpha 30 numeric SHIPTOLASTNAME Last name in the shipping address No Alpha 30 numeric SHIPTOSTATE Shipping state No Alpha 10 US 2 letter state code outside US numeric use full name SHIPTOSTREET Shipping street address No Alpha 30 numeric SHIPTOZIP Shipping postal code called zip No Alpha 9 code in the USA numeric STATE Cardholder s billing state code No Alpha 2 numeric STREET Cardholder s billing street address No Alpha 30 used for Address Verification numeric Service and reporting TAXAMT Tax amount No Currency 10 ZIP Account holder s 5 to 9 digit postal No Numeric 9 code called zip in the USA Do not use spaces dashes or non numeric characters The postal code is verified by Address Verification Ser
183. ta Modes for 0 19 Connection Parameters 20 User Parameters 222522522 edes 21 Sale Transaction 21 Typical Sale 22 Formatting 22 Payflow Pro Developer s Guide Contents Chapter 4 Credit Card Transactions 23 Credit Card 23 About Credit Card Processing a n 23 Obtaining an Internet Merchant 24 Planning Your Payflow Pro Integration 24 Complying With the E commerce Indicator 25 Handling Credit Card Type 25 Parameters Used in Credit Card 26 Submitting Sale 5 28 When Use a Sale Transaction 28 Additional Parameters For Sale 28 Typical Sale Transaction Parameter String 29 Submitting Authorization Delayed Capture Transactions 29 When To Use Authorization Delayed Capture Transactions 29 Required Authorization Transaction Parameter
184. te of birth No Alpha 8 Format mmddyyyy For example July 28 1965 is numeric represented as 07281965 Account holder s e mail address Yes Alpha 40 numeric Check invoice number No Alpha 9 numeric Magnetic Ink Check Reader This is the entire line of Yes Alpha 35 numbers at the bottom of all checks It includes the transit numeric number account number and check number Account holder s name as it appears on the check Yes Alpha 30 numeric Payflow Pro Developer s Guide Performing TeleCheck Electronic Check Transactions Testing TeleCheck Transactions TABLE B 1 TeleCheck Parameters Continued Parameter Description Required Type Length PARTNER The authorized PayPal Reseller that registered you for the Yes Alpha 64 Payflow service provided you with a Partner ID If you numeric registered yourself use PayPal This parameter is case sensitive PHONENUM Account holder s telephone number No Numeric 20 PWD Case sensitive 6 to 32 character password that you Yes Alpha 32 created while registering for the account numeric SS Account holder s social security number No Alpha 35 If CHKTYPE P a value for either DL or SS must be numeric passed as an identifier If CHKTYPE C the Federal Tax ID must be passed as the SS value STATE Account holder s state Yes Alpha 2 STREET Account holder s street address Yes Alpha 30 numeric ENDER Tender type method of payment Us
185. ted value for STREET The testing server returns a value for AVSZIP based on the submitted ZIP value as shown in the table If STREET starts with 667 or higher or begins with a non numeric character then the simulator returns AVSADDR X AVSZIP X TABLE 5 5 Testing AVSADDR Submitted Value for STREET 334 666 49354 Main 667 or higher or begins with a non numeric 79232 Maple character Example STREET Value 000 333 24285 Elm AVSADDR Result Y N X TABLE 5 6 Testing AVSZIP Submitted Value for ZIP Example ZIP Value AVSZIP Result 00000 50000 00382 50001 99999 94303 N Any value if street address is 667 or higher or STREET 79232 Maple ZIP 20304 X begins with a non numeric character 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 on page 46 Some processors will decline RI ESULT value 12 a transaction if the card security code does not match without returning a CVV2MATCH value Test the results and check with your processor to determine whether they support card security code checking Payflow Pro Developer s Guide 53 Credit Card Testing Testing Address Verification Service For the testing server the first three c
186. ters 68 American Express Additional Credit Card Parameters Legacy 73 First Data Merchant Services FDMS 76 FDMS Nashville Additional Credit Card Parameters 2 76 First Data Merchant Services FDMS South 77 FDMS South Additional Credit Card 77 First Data Merchant Services FDMS 77 FDMS North Additional Credit Card Parameters 77 Merchant e Solutions 78 Merchant e Solutions Additional Credit Card Parameters 78 Elavon Formerly 79 Elavon Additional Credit Card Parameters 79 79 Paymentech Salem New Hampshire Additional Credit Card Parameters CAPN 79 Paymentech Additional Credit Card Parameters 82 TSYS Acquiring Solutions 2 22h 83 TSYS Acquiring Solutions Additional Credit Card Parameters CAPN 83 TSYS Acquiring Solutions Additional Credit Card Parameters Legacy 89 Appendix B Performing TeleCheck Electronic Check Transactions 91 TeleCheck 91 Required Parameters 91 Testing TeleChe
187. the AMOU Z T 1050 Only applies to Paymentech Use the AMOUNT 1099 Only applies to Global Payments East Use the AMOU Central 2 1100 Only applies to Global Payments East and Set timeout value to 1 Use the AMOUNT 1103 Use the AMOUNT 1104 Attempt to credit an authorization Attempt to void a captured authorization Capture an Authorization transaction twice or attempt to capture a transaction that is not an Authorization transaction You cannot generate this RESULT value by submitting an amount of 1112 but must submit a value for Address Verification Servicethat will fail In production this error occurs only if your account is configured by PayPal customer service to use the AVS Deny feature Applies to ACH transactions only Use the AMOUNT 1114 Only applies to TSYS Acquiring Solutions Merchant e Solutions and Global Payments East and Central processors Payflow Pro Developer s Guide TABLE 5 4 Obtaining RESULT value Credit Card Testing A Testing Address Verification Service RESULT Definition How to test using Payflow Pro 1000 Generic Host Processor Use the AMOUNT 2000 Does not apply to Elavon formerly Nova Error American Express or Global Payments East processors Testing Address Verification Service The Payflow testing server simulates Address Verification Service by returning a value for AVSADDR based on the first three characters of the submit
188. the original transaction then the setting is ignored when forming the Credit transaction TABLE 4 6 Fields copied from original to Credit transaction ACCT AMT CITY COMMENT1 Payflow Pro Developer s Guide 35 36 Credit Card Transactions Submitting Void Transactions TABLE 4 6 Fields copied from original to Credit transaction COMMI CUSTIP MIDD NT2 ENAME SHIPTOCITY SHIPTOLASTNAM STATI ZIP Gl SHIPTOCOUNTRY EMAIL LASTNAME SHIPTOSTREET STREET BILLTOCOUNTRY CUSTCODE EXPDATE FIRSTNAME INVNUM PONUM SHIPTOFIRSTNAME SHIPTOMIDDLENAME SHIPTOSTATE SHIPTOZIP SWIPE PHONENUM Credit Transaction Parameter Strings This is an example Credit transaction string non referenced credits not allowed TRXTYP E C amp TI END ER C amp PARTN WD xly2z3 amp ORIGID VPNE125 ER PayPal amp V 64395 END OR SuperMerchant amp USl ER SuperMerchant amp P This is an example Credit transaction string non referenced credits allowed TRXTYP WD x1y2z3 amp ACCT 5555555555554444 amp EXP END E C amp TI ER C amp PARTN ER PayPal amp VENDOR SuperMerchant amp US DATI E 0308 amp AMT 123 00 ER SuperMerchant amp P Submitting V
189. this line item if not provided DESC3 if present is used 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 Quantity of this line item Required Type Alpha numeric Alpha numeric Numeric Alpha numeric Numeric Numeric Alpha numeric Numeric Numeric Alpha numeric Numeric Numeric Length 40 40 Payflow Pro Developer s Guide 103 Submitting Purchasing Card Level 2 and Level 3 Transactions American Express Phoenix Purchasing Card Transaction Processing TABLE C 2 American Express Phoenix CAPN Level 2 parameters Continued Parameter L_DESC4 L_AMT4 L_oTy4 Description Description of this line item if not provided DESC4 if present is used 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 Quantity of this line item Location Transaction Advice Addendum Parameters ERCHANTNAME ERCHANTSTREET ERCHANTCITY ERCHANTSTATE ERCHANTCOUNTRY CODE MERCHANTZIP Name of merchant Merchant s street address number and street name Merchant s city Merchant s state Merchant s numeric country code Example USA 840 Merchant s 5 to 9 digit zip postal code excluding spaces dashes an
190. tion Service Validate Authentication failed Mismatched or invalid Merchant ID in PARES 1048 Buyer Authentication Service Validate Authentication failed Mismatched or invalid card number in PARES 1049 Buyer Authentication Service Validate Authentication failed Mismatched or invalid currency code in PARES 1050 Buyer Authentication Service Validate Authentication failed Mismatched or invalid XID in PARES 1051 Buyer Authentication Service Validate Authentication failed Mismatched or invalid order date in PARES Website Payments Pro Payflow Edition Developer s Guide 63 64 Responses to Transaction Requests RESULT Values and RESPMSG Text TABLE 6 9 Payflow Transaction 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 RESULT Values for Communications Errors A RESULT value less than zero indicates that a communication error occurred In this case no transaction is attempted A value of 1 or 2 usually indicates a configuration error caused by an incorrect URL or by configuration issues with your firewall A value of 1 or 2 can also be possible if the PayPal servers are unavailable or an incorrect server socket pair has been specified A value of 1 can also result when there are internet connectivity errors Contact customer support reg
191. to point to the live Payflow servers For details on Payflow server URLs see Host Addresses on page 13 18 Website Payments Pro Payflow Edition Developer s Guide Simple Payflow Transaction All Payflow transactions include a common set of required parameters Additional parameters are required depending on the transaction type You can also provide many optional parameters depending on the results you want returned For example you can set the VERBOSITY parameter to return PayPal processor specific details rather than normalized information if you are looking for this kind of information VERBOSITY is described in detail in Appendix D VERBOSITY Viewing Processor Specific Transaction Results Transaction Requests Request Contents A transaction request includes e Connection parameters e User parameters e Parameters specific to the type of the transaction such as a sale or an authorization Data Modes for Sending You can send parameter data in the transaction request to the Payflow server in either of two modes e Name value pair e XMLPay The examples in this guide are presented in name value pair format Name value pair syntax guidelines are described in PARMLIST Syntax Guidelines on page 20 XMLPay is an XML syntax for payment requests and associated responses in a payment processing network Instead of using name value pairs you can send XML documents to the Payflow server based on the XML Pay 2 0 sch
192. u may prefer to perform these steps manually using PayPal Manager Either way PayPal recommends that you monitor transaction activity using PayPal Manager e You may want to discuss with your Internet Merchant Acquirer practices that help you to obtain the most advantageous rates Complying With the E commerce Indicator ECI Some processors support a software flag called E commerce Indicator ECI that indicates that the associated transaction is an internet transaction Payflow Pro complies with ECI basic requirements for all supported processors If you use the Buyer Authentication Service then the ECI values reflects the Authentication status See Payflow Pro Fraud Protection Service User s Guide on Developer Central Handling Credit Card Type Information The Payflow SDK does not check the credit card types that you are accepting If a customer uses a card type that you are not signed up to accept the Payflow SDK responds with RESULT value 23 Invalid account number or the processor returns a message that the customer is not signed up for the card type For details on RESULT values and response messages see RESULT Values and RESPMSG Text on page 56 Optionally you can provide your Payflow Pro Developer s Guide 25 Credit Card Transactions Parameters Used in Credit Card Transactions customer with a list of the card types that you accept example in a drop down list or menu for To accept additional credit card
193. ur account administrator can enable reference transactions for your account If you attempt to perform a reference transaction in an account for which reference transactions are disallowed RESULT value 117 is returned See PayPal Manager online help for instructions on setting reference transactions and other security features Sale and Authorization transactions can make use of a reference transaction as a source of transaction data PayPal looks up the reference transaction and copies its transaction data into the new Sale or Authorization transaction With the exception of dollar amount data which triggers a filter if out of range reference transactions are not screened by Fraud Protection Services filters I MPORTANT When PayPal looks up the reference transaction neither the transaction being referenced nor any other transaction in the database is changed in any way That is a reference transaction is a read only operation only the new transaction is populated with data and acted upon No linkage is maintained between the reference transaction and the new transaction You can also initiate reference transactions from PayPal Manager See PayPal Manager online help for details 40 Payflow Pro Developer s Guide Credit Card Transactions aa Recharging to the Same Credit Card Reference Transactions Transaction Types that Can Be Used as the Original Transaction You can reference the following transaction types to supply data for a new S
194. user amp ZIP 94043 Merchant e Solutions Level 3 MasterCard Parameters 4111111111111111 amp AMT 20 02 amp CITY Mountain View amp COMMENT1 L2 EXPDATE 1209 amp INVNUM 661254585 amp NAI ER PayPal amp PWD pwd amp STATI EXE To qualify for Level 3 the authorization response for the transaction must have the commercial card indicator set and one or more line items should be present in the Delayed Capture or Sale request Level 2 transaction parameters marked as mandatory are required for Level 3 transactions Level 3 transactions that do not include the mandatory Level 2 values are rejected IMPORTANT The values required for Level 3 status vary by bank so contact your bank for Payflow Pro Developer s Guide details 117 118 Submitting Purchasing Card Level 2 and Level 3 Transactions Merchant e Solutions Purchasing Card Transaction Processing Merchant e Solutions Level 2 MasterCard Parameters Required for Level 3 Transactions TABLE C 13 Merchant e Solutions Level 2 MasterCard parameters for Level 3 line item transactions Merchant e Solutions Mandatory Name Optional Purchase Identifier M Tax Amt M Lcl Tax Lcl Tax Incl Flag National Tax Amt Purch Ord Cust M Ref ID Length Payflow Parameter Data Type PONUM 25 AN Value of TransID is sent if no value is provided TAXAMT NUM The value must include a decimal and the exact amount to the cent 42 00 not 42 Do not include
195. uthorization reversals Added PayPal processor responses Updated RESULT value 0 to include information about PayPal processor success with warning message Removed note that PayPal processor does not support non referenced credits It supports them now Updated test and live host URLs Added BILLTOCOUNTRY to Paymentech additional parameters Combined Telecheck transactions content into one appendix 10 Payflow Pro Developer s Guide Revision History TABLE 1 1 Revision history Date Description November 2007 Explains how merchant can determine what SDK version they are using Provides guidelines to merchant to determine if merchant is following American Express CAPN requirements Explains more about VERBOSITY parameter Combines appendixes on performing Telecheck transactions with Telecheck responses Adds BIN ranges Explains how to eliminate TRANSSTATE 106 results Updates Index to include an alphabetical listing of all Payflow parameters cited in the guide Adds new transaction type N Includes other minor edits for technical accuracy Payflow Pro Developer s Guide 11 mS Revision History 12 Payflow Pro Developer s Guide Introduction About Payflow Pro Payflow Pro is a high performance TCP IP based internet payment solution that resides on your computer system You can download it in the following forms from the SDKs and Downloads page on PayPal Developer Central e NET library e Jav
196. value must include a decimal and the exact amount to the cent 42 00 not 42 Do not include comma separators 1234 56 not 1 234 56 NOTE American Express Phoenix Level 3 processing requires that this parameter have a maximum field length of 8 for Level 3 processing Total Tax M TAXAMT Invoice TaxAmt 1 6 NUM 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 Charge DESC Invoice Description 1 40 AN Description Defaults to NO Total Freight Amt O FRE IGHTAMT Invoice FreightAmt 1 15 AN Total Handling HANDLINGAMT Invoice HandlingAmt 1 15 AN Amt Quantity Invoiced M L Item Quantity 1 10 NUM Unit of Measure M L UOMn Item UnitOfMeasurement 2 2 AN Unit Price M L COSTnh Item UnitPrice 1 15 NUM Item Description M DESCn Item Description 1 80 AN Supplier Catalog M L CATALOGNUMn Item CatalogNumber 1 20 AN No Cost Center No M COSTCENTERNUMn Item CostCenterNumber 1 30 AN Supplier Stock L_PRODCODEn Item SKU 1 30 AN Keeping Unit Number Universal Product L_UPCn Item UPC 1 30 AN Code Item Tax Amount O L_TAXAMTn Item TaxAmt 1 6 NUM Payflow Pro Developer s Guide 107 Submitting Purchasing Card Level 2 and Level 3 Transactions First Data Merchant Services FDMS Nashville Purchasing Card Transaction Processing TABLE C 4 American Express Phoenix Level 3 Parameters Continued
197. vice 146 Payflow Pro Developer s Guide ISO Country Codes The following International Standards Organization ISO country codes are used when filling the order fields BILLTOCOUNTRY SHIPTOCOUNTRY and CORPCOUNTRY TABLE F 1 1 50 country codes Country Name Afghanistan Albania Algeria American Samoa Andorra Angola Anguilla Antarctica Antigua and Barbuda Argentina Armenia Aruba Australia Austria Azerbaijan Bahamas Bahrain Burundi Cambodia Cameroon Canada Cape Verde Cayman Islands Central African Republic Code 12 16 20 24 660 10 28 32 51 533 36 40 31 44 48 108 116 120 124 132 136 140 Country Name Bangladesh Barbados Belarus Belgium Belize Benin Bermuda Bhutan Bolivia Bosnia Herzegovina Botswana Bouvet Island Brazil British Indian Ocean Territory Brunei Darussalam Bulgaria Burkina Faso Dominican Republic East Timor Ecuador Egypt El Salvador Equatorial Guinea Eritrea Code 50 52 112 56 84 204 60 64 68 70 72 74 76 86 96 100 854 214 626 218 818 222 226 232 Payflow Pro Developer s Guide 147 ISO Country Codes 148 TABLE 1 1 50 country codes Country Name Chad Chile China Christmas Island Cocos Keeling Islands Colombia Comoros Congo Cook Islands Costa Rica Cote D ivoire Ivory Coast Croatia local name Hrvatska Cuba Cyprus Czech Republic Denmark Djibouti Dominica Gre
198. xpress Phoenix Level 3 105 Example American Express Phoenix Level Transaction Parameter String 108 First Data Merchant Services FDMS Nashville Purchasing Card Transaction Processing 108 First Data Merchant Services FDMS North Purchasing Card Transaction Processing 110 FDMS North Purchasing Card Line Item Parameters 111 First Data Merchant Services South FDMS Purchasing Card Transaction Processing 112 FDMS South Line Irem 113 Example FDMS South Purchasing Card Level 2 3 Parameter String 114 Example FDMS South Line Item Parameter String 114 Global Payments Central Purchasing Card Transaction 0 115 Global Payments Central Level 2 115 Example Global Payments Central Level 2 Visa or MasterCard Transaction Parameter rp 115 Global Payments East Purchasing Card Transaction Processing 115 Global Payments East Level 2 Parameters 116 Example Global Payments East Level 2 Visa or MasterCard Transaction Parameter 0 116 Merchant e Solutions Purchasing Card Transaction Processing 116 Merchant e Solutions Level 2 116 Merchant e Solutions Level 3 MasterCard Parameters

PayPal Payflow Pro - 2009 Developer's Guide

Contents

Download Pdf Manuals

Related Search

Related Contents