PayPal Express Checkout - 2009 User's Guide

Express Checkout for Payflow ProLast updated: October 2009

Express Checkout Processing FlowHow Express Checkout Works110 Express Checkout for Payflow ProFIGURE 1.1 Express Checkout flowThe figure shows a typi

Express Checkout for Payflow Pro 11Express Checkout Processing FlowExpress Checkout Flow11. On your website, your buyer checks out either by clicking

Express Checkout Processing FlowExpress Checkout Sale Transaction Example112 Express Checkout for Payflow ProExpress Checkout ACTION ValuesTo identif

Express Checkout for Payflow Pro 13Express Checkout Processing FlowExpress Checkout Sale Transaction Example1z RETURNURLz CANCELURLThis is an example

Express Checkout Processing FlowExpress Checkout Sale Transaction Example114 Express Checkout for Payflow Probelow. Remember to replace <TOKEN>

Express Checkout for Payflow Pro 15Express Checkout Processing FlowExpress Checkout Sale Transaction Example1RESULT=0 &RESPMSG=Approved &AVSA

Express Checkout Processing FlowOther Express Checkout Concepts116 Express Checkout for Payflow ProTRXTYPE=S &VENDOR=vendor &USER=user &P

Express Checkout for Payflow Pro 17Express Checkout Processing FlowOther Express Checkout Concepts12. From the Profile tab, click Website Payments Pr

Express Checkout Processing FlowOther Express Checkout Concepts118 Express Checkout for Payflow Pro

Express Checkout for Payflow Pro 192Billing Agreements and Reference TransactionsThis chapter describes how you can automatically bill a buyer’s PayP

Express Checkout for Payflow ProDocument Number: 200042.en_US-200910© 2009 PayPal, Inc. All rights reserved. PayPal is a registered trademark of PayPa

Billing Agreements and Reference TransactionsAbout Billing Agreements220 Express Checkout for Payflow ProAbout Billing AgreementsA billing agreement

Express Checkout for Payflow Pro 21Billing Agreements and Reference TransactionsObtaining the BAID With Express Checkout Purchase2z When the buyer is

Billing Agreements and Reference TransactionsObtaining the BAID With Express Checkout Purchase222 Express Checkout for Payflow ProFIGURE 2.1 Obtainin

Express Checkout for Payflow Pro 23Billing Agreements and Reference TransactionsObtaining the BAID With Express Checkout Purchase2PayPal account. The

Billing Agreements and Reference TransactionsObtaining the BAID With Express Checkout Purchase224 Express Checkout for Payflow ProExample of Obtainin

Express Checkout for Payflow Pro 25Billing Agreements and Reference TransactionsObtaining the BAID Without Express Checkout Purchase2Get Express Chec

Billing Agreements and Reference TransactionsObtaining the BAID Without Express Checkout Purchase226 Express Checkout for Payflow ProFIGURE 2.3 Obtai

Express Checkout for Payflow Pro 27Billing Agreements and Reference TransactionsObtaining the BAID Without Express Checkout Purchase23. Redirect the

Billing Agreements and Reference TransactionsObtaining the BAID Without Express Checkout Purchase228 Express Checkout for Payflow ProExample of Obtai

Express Checkout for Payflow Pro 29Billing Agreements and Reference TransactionsUpdating a Billing Agreement2RESULT=0&PNREF=E24P0A03B013&RESP

Express Checkout for Payflow Pro 3ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Billing Agreements and Reference TransactionsUsing Reference Transactions230 Express Checkout for Payflow ProResponse RESULT=0&RESPMSG=Approved&a

Express Checkout for Payflow Pro 31Billing Agreements and Reference TransactionsUsing Reference Transactions2Reference Transaction Request Passing th

Billing Agreements and Reference TransactionsUsing Reference Transactions232 Express Checkout for Payflow Pro

Express Checkout for Payflow Pro 333Express Checkout Transaction TypesThe Payflow gateway supports transaction types (TRXTYPE) for obtaining payment

Express Checkout Transaction TypesSale334 Express Checkout for Payflow ProAfter the Express Checkout flow, you can manage the capture of payment usin

Express Checkout for Payflow Pro 35Express Checkout Transaction TypesOrder3transaction instead of an Authorization. Orders provide greater flexibilit

Express Checkout Transaction TypesDo Reauthorization336 Express Checkout for Payflow Pro– Set Express Checkout request: TRXTYPE=O, ACTION=S– Get Expr

Express Checkout for Payflow Pro 37Express Checkout Transaction TypesDo Authorization3TRXTYPE=A &TENDER=P &PARTNER=partner &USER=user &am

Express Checkout Transaction TypesDelayed Capture338 Express Checkout for Payflow ProComplete CaptureTo set up a capture of the total amount in the o

Express Checkout for Payflow Pro 39Express Checkout Transaction TypesVoid3VoidA Void transaction voids any of the following transaction types: z Orde

Contents4 Express Checkout for Payflow ProUpdating a Billing Agreement . . . . . . . . . . . . . . . . . . . . . . . . . .

Express Checkout Transaction TypesCredit340 Express Checkout for Payflow ProTRXTYPE=C &TENDER=P PARTNER=partner VENDOR=vendor &USER=user &

Express Checkout for Payflow Pro 414Transaction Responses Transaction response parameters indicate the status of the transaction and return requested

Transaction ResponsesAddress Verification Service Responses From PayPal442 Express Checkout for Payflow ProAddress Verification Service Responses Fro

Express Checkout for Payflow Pro 43Transaction ResponsesCard Security Code Results4Card Security Code ResultsThe CVV2MATCH parameter returns Y, N, or

Transaction ResponsesPNREF Value444 Express Checkout for Payflow ProPayPal Card Security Code ResultsThe table below shows the detailed results retur

Express Checkout for Payflow Pro 45Transaction ResponsesRESULT Values and RESPMSG Text4RESULT Values and RESPMSG TextThe RESULT parameter and value i

Transaction ResponsesRESULT Values and RESPMSG Text446 Express Checkout for Payflow Pro2 Invalid tender type. Your merchant bank account does not sup

Express Checkout for Payflow Pro 47Transaction ResponsesRESULT Values and RESPMSG Text426 Invalid vendor account. Login information is incorrect. Ver

Transaction ResponsesRESULT Values and RESPMSG Text448 Express Checkout for Payflow Pro108 Void error. See RESPMSG. Make sure the transaction ID ente

Express Checkout for Payflow Pro 49Transaction ResponsesRESULT Values and RESPMSG Text4126 Fraud Protection Services Filter — Flagged for review by f

Express Checkout for Payflow Pro 5ContentsTesting Your Integration Using the PayPal Simulator . . . . . . . . . . . . . . . . . .

Transaction ResponsesRESULT Values and RESPMSG Text450 Express Checkout for Payflow Pro1016 Buyer Authentication Service — 3-D Secure error response

Express Checkout for Payflow Pro 515Express Checkout Testing You can set up the testing of your integration using two methods.z Testing Your Integrat

Express Checkout TestingTesting Your Integration Using the Sandbox552 Express Checkout for Payflow Pro– Password: (your password)Your account should

Express Checkout for Payflow Pro 53Express Checkout TestingTesting Your Integration Using the PayPal Simulator5You should also create a Buyer account

Express Checkout TestingTesting Your Integration Using the PayPal Simulator554 Express Checkout for Payflow Pro

A Express Checkout for Payflow Pro 55Express Checkout Parameter ReferenceThis reference describes all parameters that can be used with the Express Che

Express Checkout Parameter ReferenceUser Parameter DescriptionsA56 Express Checkout for Payflow ProUser Parameter DescriptionsAll Payflow transaction

Express Checkout for Payflow Pro 57Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAExpress Checkout Parameter Description

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA58 Express Checkout for Payflow ProCANCELURL (Required) URL to which the

Express Checkout for Payflow Pro 59Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAPAYMENTTYPE (Optional) Is one of the f

Contents6 Express Checkout for Payflow Pro

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA60 Express Checkout for Payflow ProTAXAMT (Required if L_TAXAMTn is speci

Express Checkout for Payflow Pro 61Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAMAXAMT (Optional) The expected maximum

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA62 Express Checkout for Payflow ProLOCALECODE (Optional) Locale of pages

Express Checkout for Payflow Pro 63Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsASet Express Checkout Response Paramete

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA64 Express Checkout for Payflow ProGet Express Checkout Details Request P

Express Checkout for Payflow Pro 65Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAPAYERSTATUS Status of buyer. Values ar

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA66 Express Checkout for Payflow ProSHIPTONAME Ship-to name. If you includ

Express Checkout for Payflow Pro 67Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsABILLTONAME Bill-to name.NOTE:The bill-

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA68 Express Checkout for Payflow ProDo Express Checkout Payment Request Pa

Express Checkout for Payflow Pro 69Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAAMT (Required) Amount.Limitations: Nin

Express Checkout for Payflow Pro 7PrefaceIntended AudienceThis guide assumes that its readers: z Are experienced web or application developersz Have

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA70 Express Checkout for Payflow ProL_COSTn (Required if L_QTYn is supplie

Express Checkout for Payflow Pro 71Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAHANDLINGAMT (Optional) Total handling

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA72 Express Checkout for Payflow ProDo Express Checkout Payment Response P

Express Checkout for Payflow Pro 73Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsATAXAMT Sum of tax for all items in thi

Express Checkout Parameter ReferenceDo Authorization Parameter DescriptionsA74 Express Checkout for Payflow ProDo Authorization Parameter Description

Express Checkout for Payflow Pro 75Express Checkout Parameter ReferenceDo Reauthorization Parameter DescriptionsADo Reauthorization Parameter Descrip

Express Checkout Parameter ReferenceCredit Parameter DescriptionsA76 Express Checkout for Payflow ProCredit Parameter DescriptionsORIGID (Required) P

Express Checkout for Payflow Pro 77Express Checkout Parameter ReferenceDelayed Capture Parameter DescriptionsADelayed Capture Parameter DescriptionsM

Express Checkout Parameter ReferenceBilling Agreement Parameter DescriptionsA78 Express Checkout for Payflow ProBilling Agreement Parameter Descripti

Express Checkout for Payflow Pro 79Express Checkout Parameter ReferenceBilling Agreement Parameter DescriptionsACreate Customer Billing Agreement Res

Document History8 Express Checkout for Payflow ProAugust 2009 Revised and updated. Added reference transactions and RecurringPayments billing type. R

Express Checkout Parameter ReferenceBilling Agreement Parameter DescriptionsA80 Express Checkout for Payflow ProUpdate Customer Billing Agreement Res

Express Checkout for Payflow Pro 81Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsAReference Transaction Parameter D

Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsA82 Express Checkout for Payflow ProPAYMENTTYPE (Optional) Is one of

Express Checkout for Payflow Pro 83Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsAL_COSTn (Optional) Line-item uni

Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsA84 Express Checkout for Payflow ProTAXAMT (Required if L_TAXAMTn is

Express Checkout for Payflow Pro 85Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsAReference Transaction Response Pa

Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsA86 Express Checkout for Payflow Pro

B Express Checkout for Payflow Pro 87Currency CodesThe following currencies are supported for use in transactions.TABLE B.1 Currencies and Currency Co

Currency CodesB88 Express Checkout for Payflow ProTHB Thai BahtUSD U.S. Dollar TABLE B.1 Currencies and Currency CodesCode Currency

89 C Country CodesNOTE:This table lists country codes defined by ISO 3166-1.Table 1: Country CodesCountry CodeAFGHANISTAN AFÅLAND ISLANDS AXALBANIA AL

Express Checkout for Payflow Pro 91Express Checkout Processing FlowThis chapter describes Express Checkout processing: z “What Is Express Checkout?”

Country Codes90CENTRAL AFRICAN REPUBLICCFCHAD TDCHILE CLCHINA CNCHRISTMAS ISLAND CXCOCOS (KEELING) ISLANDSCCCOLOMBIA COCOMOROS KMCONGO CGCONGO, THE DE

91GUINEA GNGUINEA-BISSAU GWGUYANA GYHAITI HTHEARD ISLAND AND MCDONALD ISLANDSHMHOLY SEE (VATICAN CITY STATE)VAHONDURAS HNHONG KONG HKHUNGARY HUICELAND

Country Codes92MICRONESIA, FEDER-ATED STATES OFFMMOLDOVA, REPUBLIC OFMDMONACO MCMONGOLIA MNMONTSERRAT MSMOROCCO MAMOZAMBIQUE MZMYANMAR MMNAMIBIA NANAU

93SAO TOME AND PRINC-IPESTSAUDI ARABIA SASENEGAL SNSERBIA AND MON-TENEGROCSSEYCHELLES SCSIERRA LEONE SLSINGAPORE SGSLOVAKIA SKSLOVENIA SISOLOMON ISLAN

Country Codes94VIRGIN ISLANDS, U.S. VIWALLIS AND FUTUNA WFWESTERN SAHARA EHYEMEN YEZAMBIA ZMZIMBABWE ZWCountry Code

IndexAACTION parameter 12, 57, 64, 68, 78, 79, 81ADDROVERRIDE parameter 61ADJUSTMENTAMT parameter 65AMT parameter 12AMTparameter 57, 69, 74, 76, 77, 8

Index96 Express Checkout for Payflow ProIINVNUM parameter 61, 66, 69, 82Israeli New Sheqel 87ITEMAMT parameter 83JJapanese Yen 87KKoruna 87Krona 87Kr

Express Checkout for Payflow Pro 97IndexHDRIMG 62HOSTADDRESS 55HOSTPORT 55, 56INVNUM 61, 66, 69, 82ITEMAMT 83L_BILLINGAGREEMENTDESCRIPTIONn 58L_BILLI

Index98 Express Checkout for Payflow ProSHIPTONAME parameter 63, 66, 71, 84SHIPTOSTATE parameter 63, 66, 71, 81, 85SHIPTOSTREET2 parameter 63, 66, 71