PayPal Express Checkout - 2013 Guide de l'utilisateur

Express Checkout for PayflowLast updated: June 2013

Express Checkout Processing FlowHow Express Checkout Works110 Express Checkout for PayflowFIGURE 1.1 Express Checkout flowThe figure shows a typical

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

Express Checkout Processing FlowExpress Checkout Sale Transaction Example112 Express Checkout for PayflowExpress Checkout ACTION ValuesTo identify ea

Express Checkout for Payflow 13Express Checkout Processing FlowExpress Checkout Sale Transaction Example1 RETURNURL CANCELURLThis is an example Set

Express Checkout Processing FlowExpress Checkout Sale Transaction Example114 Express Checkout for Payflowbelow. Remember to replace <TOKEN> wit

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

Express Checkout Processing FlowOther Express Checkout Concepts116 Express Checkout for PayflowTRXTYPE=S &VENDOR=vendor &USER=user &PW

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

Express Checkout Processing FlowOther Express Checkout Concepts118 Express Checkout for Payflow

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

Express Checkout for PayflowDocument Number: 200042.en_US-201306© 2013 PayPal, Inc. All rights reserved. PayPal is a registered trademark of PayPal, I

Billing Agreements and Reference TransactionsAbout Billing Agreements220 Express Checkout for PayflowAbout Billing AgreementsA billing agreement allo

Express Checkout for Payflow 21Billing Agreements and Reference TransactionsObtaining the BAID With Express Checkout Purchase2 When the buyer is mak

Billing Agreements and Reference TransactionsObtaining the BAID With Express Checkout Purchase222 Express Checkout for PayflowFIGURE 2.1 Obtaining th

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

Billing Agreements and Reference TransactionsObtaining the BAID With Express Checkout Purchase224 Express Checkout for PayflowExample of Obtaining th

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

Billing Agreements and Reference TransactionsObtaining the BAID Without Express Checkout Purchase226 Express Checkout for PayflowFIGURE 2.3 Obtaining

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

Billing Agreements and Reference TransactionsObtaining the BAID Without Express Checkout Purchase228 Express Checkout for PayflowExample of Obtaining

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

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

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

Express Checkout for Payflow 31Billing Agreements and Reference TransactionsUsing Reference Transactions2Reference Transaction Request Passing the PN

Billing Agreements and Reference TransactionsUsing Reference Transactions232 Express Checkout for Payflow

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

Express Checkout Transaction TypesSale334 Express Checkout for PayflowAfter the Express Checkout flow, you can manage the capture of payment using th

Express Checkout for Payflow 35Express Checkout Transaction TypesOrder3transaction instead of an Authorization. Orders provide greater flexibility wi

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

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

Express Checkout Transaction TypesDelayed Capture338 Express Checkout for PayflowComplete CaptureTo set up a capture of the total amount in the origi

Express Checkout for Payflow 39Express Checkout Transaction TypesVoid3VoidA Void transaction voids any of the following transaction types:  Order A

Contents4 Express Checkout for PayflowUpdating a Billing Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . .

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

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

Transaction ResponsesAddress Verification Service Responses From PayPal442 Express Checkout for PayflowAddress Verification Service Responses From Pa

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

Transaction ResponsesPNREF Value444 Express Checkout for PayflowPayPal Card Security Code ResultsThe table below shows the detailed results returned

Express Checkout for Payflow 45Transaction ResponsesRESULT Values and RESPMSG Text4RESULT Values and RESPMSG TextThe RESULT parameter and value is th

Transaction ResponsesRESULT Values and RESPMSG Text446 Express Checkout for Payflow2 Invalid tender type. Your merchant bank account does not support

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

Transaction ResponsesRESULT Values and RESPMSG Text448 Express Checkout for Payflow108 Void error. See RESPMSG. Make sure the transaction ID entered

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

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

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

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

Express Checkout TestingTesting Your Integration Using the PayPal Simulator552 Express Checkout for PayflowNOTE: You must be logged into the Sandbox

A Express Checkout for Payflow 53Express Checkout Parameter ReferenceThis reference describes all parameters that can be used with the Express Checkou

Express Checkout Parameter ReferenceUser Parameter DescriptionsA54 Express Checkout for PayflowUser Parameter DescriptionsAll Payflow transaction req

Express Checkout for Payflow 55Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAExpress Checkout Parameter DescriptionsSet

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA56 Express Checkout for PayflowCANCELURL (Required) URL to which the buye

Express Checkout for Payflow 57Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAPAYMENTTYPE (Optional) Is one of the follo

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA58 Express Checkout for PayflowTAXAMT (Required if L_TAXAMTn is specified

Express Checkout for Payflow 59Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAMAXAMT (Optional) The expected maximum tot

Contents6 Express Checkout for Payflow

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA60 Express Checkout for PayflowLOCALECODE (Optional) Locale of pages disp

Express Checkout for Payflow 61Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsASet Express Checkout Response Parameter De

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA62 Express Checkout for PayflowGet Express Checkout Details Request Param

Express Checkout for Payflow 63Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAPAYERSTATUS Status of buyer. Values are: 

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA64 Express Checkout for PayflowSHIPTONAME Ship-to name. If you include a

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

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA66 Express Checkout for PayflowDo Express Checkout Payment Request Parame

Express Checkout for Payflow 67Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAAMT (Required) Amount.Limitations: Nine nu

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA68 Express Checkout for PayflowL_COSTn (Required if L_QTYn is supplied)

Express Checkout for Payflow 69Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsAHANDLINGAMT (Optional) Total handling cos

Express Checkout for Payflow 7PrefaceIntended AudienceThis guide assumes that its readers:  Are experienced web or application developers Have a ba

Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsA70 Express Checkout for PayflowDo Express Checkout Payment Response Param

Express Checkout for Payflow 71Express Checkout Parameter ReferenceExpress Checkout Parameter DescriptionsATAXAMT Sum of tax for all items in this or

Express Checkout Parameter ReferenceDo Authorization Parameter DescriptionsA72 Express Checkout for PayflowDo Authorization Parameter DescriptionsTAB

Express Checkout for Payflow 73Express Checkout Parameter ReferenceDo Reauthorization Parameter DescriptionsADo Reauthorization Parameter Description

Express Checkout Parameter ReferenceCredit Parameter DescriptionsA74 Express Checkout for PayflowCredit Parameter DescriptionsORIGID (Required) Payfl

Express Checkout for Payflow 75Express Checkout Parameter ReferenceDelayed Capture Parameter DescriptionsADelayed Capture Parameter DescriptionsMEMO

Express Checkout Parameter ReferenceBilling Agreement Parameter DescriptionsA76 Express Checkout for PayflowBilling Agreement Parameter DescriptionsC

Express Checkout for Payflow 77Express Checkout Parameter ReferenceBilling Agreement Parameter DescriptionsACreate Customer Billing Agreement Respons

Express Checkout Parameter ReferenceBilling Agreement Parameter DescriptionsA78 Express Checkout for PayflowUpdate Customer Billing Agreement Respons

Express Checkout for Payflow 79Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsAReference Transaction Parameter Descr

Document History8 Express Checkout for PayflowAugust 2009 Revised and updated. Added reference transactions and RecurringPayments billing type. Revis

Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsA80 Express Checkout for PayflowPAYMENTTYPE (Optional) Is one of the

Express Checkout for Payflow 81Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsAL_COSTn (Optional) Line-item unit pr

Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsA82 Express Checkout for PayflowTAXAMT (Required if L_TAXAMTn is spec

Express Checkout for Payflow 83Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsAReference Transaction Response Parame

Express Checkout Parameter ReferenceReference Transaction Parameter DescriptionsA84 Express Checkout for Payflow

B Express Checkout for Payflow 85Currency CodesThe following currencies are supported for use in transactions.TABLE B.1 Currencies and Currency CodesC

Currency CodesB86 Express Checkout for PayflowTHB Thai BahtUSD U.S. Dollar TABLE B.1 Currencies and Currency CodesCode Currency

Express Checkout for Payflow 87 C Country CodesNOTE: This table lists country codes defined by ISO 3166-1.Table 1: Country CodesCountry CodeAFGHANISTA

Country Codes88 Express Checkout for PayflowCENTRAL AFRICAN REPUBLICCFCHAD TDCHILE CLCHINA CNCHRISTMAS ISLAND CXCOCOS (KEELING) ISLANDSCCCOLOMBIA COC

Express Checkout for Payflow 89GUINEA GNGUINEA-BISSAU GWGUYANA GYHAITI HTHEARD ISLAND AND MCDONALD ISLANDSHMHOLY SEE (VATICAN CITY STATE)VAHONDURAS HN

Express Checkout for Payflow 91Express Checkout Processing FlowThis chapter describes Express Checkout processing:  “What Is Express Checkout?” on p

Country Codes90 Express Checkout for PayflowMICRONESIA, FEDER-ATED STATES OFFMMOLDOVA, REPUBLIC OFMDMONACO MCMONGOLIA MNMONTSERRAT MSMOROCCO MAMOZAMB

Express Checkout for Payflow 91SAO TOME AND PRINC-IPESTSAUDI ARABIA SASENEGAL SNSERBIA AND MON-TENEGROCSSEYCHELLES SCSIERRA LEONE SLSINGAPORE SGSLOVAK

Country Codes92 Express Checkout for PayflowVIRGIN ISLANDS, U.S. VIWALLIS AND FUTUNA WFWESTERN SAHARA EHYEMEN YEZAMBIA ZMZIMBABWE ZWCountry Code

IndexAACTION parameter 12, 55, 62, 66, 76, 77, 79ADDROVERRIDE parameter 59ADJUSTMENTAMT parameter 63AMT parameter 12AMTparameter 55, 67, 72, 74,

Index94 Express Checkout for PayflowIINVNUM parameter 59, 64, 67, 80Israeli New Sheqel 85ITEMAMT parameter 81JJapanese Yen 85KKoruna 85Krona 85

Express Checkout for Payflow 95IndexHDRIMG 60HOSTADDRESS 53HOSTPORT 53, 54INVNUM 59, 64, 67, 80ITEMAMT 81L_BILLINGAGREEMENTDESCRIPTIONn 56L_BIL

Index96 Express Checkout for PayflowSHIPTONAME parameter 61, 64, 69, 82SHIPTOSTATE parameter 61, 64, 69, 79, 83SHIPTOSTREET2 parameter 61, 64, 69,