PayPal Name-Value Pair API - 2009 Guia do Utilizador

Name-Value Pair API Developer GuideLast updated: 08 April 2009

Revision History10 08 April 2009 Name-Value Pair API Developer GuideSeptember 2007 z Update eBay auctions for Express Checkout sectionz Added fields f

Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile API100 08 April 2009 Name-Value Pair API Developer GuideTRI

Name-Value Pair API Developer Guide 08 April 2009 101Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile APIAct

Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile API102 08 April 2009 Name-Value Pair API Developer GuideSHI

Name-Value Pair API Developer Guide 08 April 2009 103Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile APICre

Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile API104 08 April 2009 Name-Value Pair API Developer GuidePAY

Name-Value Pair API Developer Guide 08 April 2009 105Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile APIPay

Recurring Payments and Reference Transactions API OperationsGetRecurringPaymentsProfileDetails API106 08 April 2009 Name-Value Pair API Developer Guid

Name-Value Pair API Developer Guide 08 April 2009 107Recurring Payments and Reference Transactions API OperationsGetRecurringPaymentsProfileDetails AP

Recurring Payments and Reference Transactions API OperationsGetRecurringPaymentsProfileDetails API108 08 April 2009 Name-Value Pair API Developer Guid

Name-Value Pair API Developer Guide 08 April 2009 109Recurring Payments and Reference Transactions API OperationsGetRecurringPaymentsProfileDetails AP

Name-Value Pair API Developer Guide 08 April 2009 111PayPal NVP API OverviewThis overview describes the PayPal Name-Value Pair (NVP) API at a high lev

Recurring Payments and Reference Transactions API OperationsGetRecurringPaymentsProfileDetails API110 08 April 2009 Name-Value Pair API Developer Guid

Name-Value Pair API Developer Guide 08 April 2009 111Recurring Payments and Reference Transactions API OperationsGetRecurringPaymentsProfileDetails AP

Recurring Payments and Reference Transactions API OperationsGetRecurringPaymentsProfileDetails API112 08 April 2009 Name-Value Pair API Developer Guid

Name-Value Pair API Developer Guide 08 April 2009 113Recurring Payments and Reference Transactions API OperationsManageRecurringPaymentsProfileStatus

Recurring Payments and Reference Transactions API OperationsBillOutstandingAmount API114 08 April 2009 Name-Value Pair API Developer GuideManageRecurr

Name-Value Pair API Developer Guide 08 April 2009 115Recurring Payments and Reference Transactions API OperationsUpdateRecurringPaymentsProfile APIBil

Recurring Payments and Reference Transactions API OperationsUpdateRecurringPaymentsProfile API116 08 April 2009 Name-Value Pair API Developer GuideUpd

Name-Value Pair API Developer Guide 08 April 2009 117Recurring Payments and Reference Transactions API OperationsUpdateRecurringPaymentsProfile APIUpd

Recurring Payments and Reference Transactions API OperationsUpdateRecurringPaymentsProfile API118 08 April 2009 Name-Value Pair API Developer GuideTAX

Name-Value Pair API Developer Guide 08 April 2009 119Recurring Payments and Reference Transactions API OperationsUpdateRecurringPaymentsProfile APIShi

PayPal NVP API OverviewBasic Steps12 08 April 2009 Name-Value Pair API Developer GuideIntegrate Using an SDKYou can integrate with the NVP API using a

Recurring Payments and Reference Transactions API OperationsUpdateRecurringPaymentsProfile API120 08 April 2009 Name-Value Pair API Developer GuideTOT

Name-Value Pair API Developer Guide 08 April 2009 121Recurring Payments and Reference Transactions API OperationsUpdateRecurringPaymentsProfile APITRI

Recurring Payments and Reference Transactions API OperationsUpdateRecurringPaymentsProfile API122 08 April 2009 Name-Value Pair API Developer GuideCre

Name-Value Pair API Developer Guide 08 April 2009 123Recurring Payments and Reference Transactions API OperationsSetCustomerBillingAgreement APIAddres

Recurring Payments and Reference Transactions API OperationsSetCustomerBillingAgreement API124 08 April 2009 Name-Value Pair API Developer Guidez “Set

Name-Value Pair API Developer Guide 08 April 2009 125Recurring Payments and Reference Transactions API OperationsSetCustomerBillingAgreement APISetCus

Recurring Payments and Reference Transactions API OperationsSetCustomerBillingAgreement API126 08 April 2009 Name-Value Pair API Developer GuideHDRBAC

Name-Value Pair API Developer Guide 08 April 2009 127Recurring Payments and Reference Transactions API OperationsGetBillingAgreementCustomerDetails AP

Recurring Payments and Reference Transactions API OperationsGetBillingAgreementCustomerDetails API128 08 April 2009 Name-Value Pair API Developer Guid

Name-Value Pair API Developer Guide 08 April 2009 129Recurring Payments and Reference Transactions API OperationsGetBillingAgreementCustomerDetails AP

Name-Value Pair API Developer Guide 08 April 2009 13PayPal NVP API OverviewTaking Your Application Live3. Post the NVP request to the PayPal Sandbox a

Recurring Payments and Reference Transactions API OperationsBAUpdate API130 08 April 2009 Name-Value Pair API Developer GuideBAUpdate APIUpdate or del

Name-Value Pair API Developer Guide 08 April 2009 131Recurring Payments and Reference Transactions API OperationsBAUpdate APIBAUpdate RequestUpdate Bi

Recurring Payments and Reference Transactions API OperationsBAUpdate API132 08 April 2009 Name-Value Pair API Developer GuideUpdate Billing Agreement

Name-Value Pair API Developer Guide 08 April 2009 133Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction APIShip To Add

Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction API134 08 April 2009 Name-Value Pair API Developer Guidez “DoRefere

Name-Value Pair API Developer Guide 08 April 2009 135Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction APIDoReference

Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction API136 08 April 2009 Name-Value Pair API Developer GuideShip To Add

Name-Value Pair API Developer Guide 08 April 2009 137Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction APISHIPPINGAMT

Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction API138 08 April 2009 Name-Value Pair API Developer GuideINVNUM (Opt

Name-Value Pair API Developer Guide 08 April 2009 139Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction APIPayment Det

PayPal NVP API OverviewTechnical Details14 08 April 2009 Name-Value Pair API Developer Guidez The server address in the URL. (See “Posting Using HTTPS

Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction API140 08 April 2009 Name-Value Pair API Developer GuideL_ITEMWIDTH

Name-Value Pair API Developer Guide 08 April 2009 141Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction APIEbayItemPay

Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction API142 08 April 2009 Name-Value Pair API Developer GuideCVV2 Card V

Name-Value Pair API Developer Guide 08 April 2009 143Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction APIPayer Info

Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction API144 08 April 2009 Name-Value Pair API Developer GuideDoReference

Name-Value Pair API Developer Guide 08 April 2009 145Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction APIPAYMENTTYPE

Recurring Payments and Reference Transactions API OperationsDoReferenceTransaction API146 08 April 2009 Name-Value Pair API Developer GuidePENDINGREAS

Name-Value Pair API Developer Guide 08 April 2009 14710DoNonReferencedCredit APIIssue a credit to a card not referenced by the original transaction.z

DoNonReferencedCredit APIDoNonReferencedCredit Request148 08 April 2009 Name-Value Pair API Developer GuideDoNonReferencedCredit Request FieldsField D

Name-Value Pair API Developer Guide 08 April 2009 149DoNonReferencedCredit APIDoNonReferencedCredit RequestCredit Card Details FieldsPayer Info Type F

Name-Value Pair API Developer Guide 08 April 2009 15PayPal NVP API OverviewTechnical DetailsURL-Encoding MethodsRequest FormatEach NVP request consist

DoNonReferencedCredit APIDoNonReferencedCredit Response150 08 April 2009 Name-Value Pair API Developer GuideAddress FieldsDoNonReferencedCredit Respon

Name-Value Pair API Developer Guide 08 April 2009 15111ManagePendingTransactionStatus APIAccept or deny a pending transaction held by Fraud Management

ManagePendingTransactionStatus APIManagePendingTransactionStatus Response152 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 15312GetBalance APIObtain the available balance for a PayPal account.z “GetBalance Request” on page

GetBalance APIGetBalance Response154 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 15513AddressVerify APIConfirms whether a postal address and postal code match those of the specified

AddressVerify APIAddressVerify Request156 08 April 2009 Name-Value Pair API Developer GuideAddressVerify RequestAddressVerify Request FieldsAddressVer

Name-Value Pair API Developer Guide 08 April 2009 157AddressVerify APIAddressVerify ResponseZIPMATCH None: The request value of the Street element was

AddressVerify APIAddressVerify Response158 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 159AAPI Error CodesThe PayPal API can return multiple errors for any operation.z “General API Errors

PayPal NVP API OverviewTechnical Details16 08 April 2009 Name-Value Pair API Developer GuideIn practice, you need to concatenate all parameters and va

API Error CodesGeneral API Errors160 08 April 2009 Name-Value Pair API Developer GuideGeneral API ErrorsGeneral API ErrorsError Code Short Message Lon

Name-Value Pair API Developer Guide 08 April 2009 161API Error CodesValidation ErrorsValidation ErrorsValidation ErrorsError Code Short Message Long M

API Error CodesValidation Errors162 08 April 2009 Name-Value Pair API Developer Guide81122 Missing Parameter TaxAmt : Required parameter missing81123

Name-Value Pair API Developer Guide 08 April 2009 163API Error CodesValidation Errors81203 Invalid Parameter NotifyURL : Invalid parameter81205 Invali

API Error CodesValidation Errors164 08 April 2009 Name-Value Pair API Developer Guide81244 Invalid Parameter StartDate : Invalid parameter81245 Invali

Name-Value Pair API Developer Guide 08 April 2009 165API Error CodesDirect Payment API ErrorsDirect Payment API ErrorsDirectPayment API ErrorsError Co

API Error CodesDirect Payment API Errors166 08 April 2009 Name-Value Pair API Developer Guide10502 Invalid Data This transaction cannot be processed.

Name-Value Pair API Developer Guide 08 April 2009 167API Error CodesDirect Payment API Errors10525 Invalid Data This transaction cannot be processed.

API Error CodesDirect Payment API Errors168 08 April 2009 Name-Value Pair API Developer Guide10544 Gateway Decline This transaction cannot be processe

Name-Value Pair API Developer Guide 08 April 2009 169API Error CodesDirect Payment API Errors10556 Filter Decline This transaction cannot be processed

Name-Value Pair API Developer Guide 08 April 2009 17PayPal NVP API OverviewTechnical DetailsResponse FormatA response from the PayPal servers is a URL

API Error CodesDirect Payment API Errors170 08 April 2009 Name-Value Pair API Developer Guide10703 Invalid Data There’s an error with this transaction

Name-Value Pair API Developer Guide 08 April 2009 171API Error CodesDirect Payment API Errors10711 Invalid Data There’s an error with this transaction

API Error CodesDirect Payment API Errors172 08 April 2009 Name-Value Pair API Developer Guide10720 Invalid Data There’s an error with this transaction

Name-Value Pair API Developer Guide 08 April 2009 173API Error CodesDirect Payment API Errors10728 Invalid Data There’s an error with this transaction

API Error CodesDirect Payment API Errors174 08 April 2009 Name-Value Pair API Developer Guide10736 Invalid Data There’s an error with this transaction

Name-Value Pair API Developer Guide 08 April 2009 175API Error CodesDirect Payment API Errors10756 Gateway Decline The transaction cannot be processed

API Error CodesDirect Payment API Errors176 08 April 2009 Name-Value Pair API Developer Guide15001 Gateway Decline This transaction cannot be processe

Name-Value Pair API Developer Guide 08 April 2009 177API Error CodesSetExpressCheckout API ErrorsSetExpressCheckout API ErrorsSetExpressCheckout API E

API Error CodesSetExpressCheckout API Errors178 08 April 2009 Name-Value Pair API Developer Guide10404 Transaction refused because of an invalid argum

Name-Value Pair API Developer Guide 08 April 2009 179API Error CodesSetExpressCheckout API Errors10412 Duplicate invoice Payment has already been mad

PayPal NVP API OverviewPosting Using HTTPS18 08 April 2009 Name-Value Pair API Developer GuidePosting Using HTTPSYour web application posts the URL-en

API Error CodesSetExpressCheckout API Errors180 08 April 2009 Name-Value Pair API Developer Guide10427 Transaction refused because of an invalid argum

Name-Value Pair API Developer Guide 08 April 2009 181API Error CodesSetExpressCheckout API Errors10438 Transaction refused because of an invalid argum

API Error CodesSetExpressCheckout API Errors182 08 April 2009 Name-Value Pair API Developer Guide10468 Transaction refused because of an invalid argum

Name-Value Pair API Developer Guide 08 April 2009 183API Error CodesSetExpressCheckout API Errors10537 Risk Control Country Filter Failure The transac

API Error CodesSetExpressCheckout API Errors184 08 April 2009 Name-Value Pair API Developer Guide11803 Invalid Data You cannot pass both the new and

Name-Value Pair API Developer Guide 08 April 2009 185API Error CodesSetExpressCheckout API ErrorsInvalid callback timeout The callback timeout is is z

API Error CodesSetExpressCheckout API Errors186 08 April 2009 Name-Value Pair API Developer Guide11828 Maximum amount of order not specifiedMaximum am

Name-Value Pair API Developer Guide 08 April 2009 187API Error CodesGetExpressCheckoutDetails API ErrorsGetExpressCheckoutDetails API ErrorsGetExpress

API Error CodesGetExpressCheckoutDetails API Errors188 08 April 2009 Name-Value Pair API Developer Guide10411 This Express Checkout session has expire

Name-Value Pair API Developer Guide 08 April 2009 189API Error CodesDoExpressCheckoutPayment API ErrorsDoExpressCheckoutPayment API Errors ErrorsError

Name-Value Pair API Developer Guide 08 April 2009 192Authorization and Capture API Operation ReferenceThis chapter describes the PayPal API operations

API Error CodesDoExpressCheckoutPayment API Errors190 08 April 2009 Name-Value Pair API Developer Guide10413 Transaction refused because of an invalid

Name-Value Pair API Developer Guide 08 April 2009 191API Error CodesDoExpressCheckoutPayment API Errors10422 Customer must choose new funding sources.

API Error CodesDoExpressCheckoutPayment API Errors192 08 April 2009 Name-Value Pair API Developer Guide10435 Transaction refused because of an invalid

Name-Value Pair API Developer Guide 08 April 2009 193API Error CodesDoExpressCheckoutPayment API Errors10538 Risk Control Max Amount Failure The trans

API Error CodesDoExpressCheckoutPayment API Errors194 08 April 2009 Name-Value Pair API Developer GuideInvalid shipping options Invalid shipping optio

Name-Value Pair API Developer Guide 08 April 2009 195API Error CodesAuthorization and Capture API ErrorsAuthorization and Capture API ErrorsAuthorizat

API Error CodesAuthorization and Capture API Errors196 08 April 2009 Name-Value Pair API Developer Guide10604 Authorization must include both buyer an

Name-Value Pair API Developer Guide 08 April 2009 197API Error CodesAuthorization and Capture API Errors10615 Cannot reauth reauth. You can reauthoriz

API Error CodesAuthorization and Capture API Errors198 08 April 2009 Name-Value Pair API Developer Guide10625 Transaction refused because of an invali

Name-Value Pair API Developer Guide 08 April 2009 199API Error CodesGetTransactionDetails API ErrorsGetTransactionDetails API ErrorsGetTransactionDeta

Name-Value Pair API Developer GuideDocument Number: 100018.en_US-20090408© 2009 PayPal, Inc. All rights reserved. PayPal is a registered trademark of

Authorization and Capture API Operation ReferenceDoCapture API20 08 April 2009 Name-Value Pair API Developer GuideDoCapture RequestDoCapture Request F

API Error CodesTransactionSearch API Errors200 08 April 2009 Name-Value Pair API Developer Guide10004 Transaction refused because of an invalid argume

Name-Value Pair API Developer Guide 08 April 2009 201API Error CodesRefundTransaction API ErrorsRefundTransaction API ErrorsRefundTransaction API Erro

API Error CodesRefundTransaction API Errors202 08 April 2009 Name-Value Pair API Developer Guide10004 Transaction refused because of an invalid argume

Name-Value Pair API Developer Guide 08 April 2009 203API Error CodesRefundTransaction API Errors10009 Transaction refused This transaction has alread

API Error CodesMass Pay API Errors204 08 April 2009 Name-Value Pair API Developer GuideMass Pay API ErrorsMassPay API ErrorsError Code Short Message L

Name-Value Pair API Developer Guide 08 April 2009 205API Error CodesMass Pay API Errors10004 Transaction refused because of an invalid argument. See a

API Error CodesRecurring Payments Errors206 08 April 2009 Name-Value Pair API Developer GuideRecurring Payments ErrorsThe following table lists errors

Name-Value Pair API Developer Guide 08 April 2009 207API Error CodesRecurring Payments ErrorsRecurring Payments ErrorsError Code Short Message Long Me

API Error CodesRecurring Payments Errors208 08 April 2009 Name-Value Pair API Developer Guide10513 Invalid Data This transaction cannot be processed.

Name-Value Pair API Developer Guide 08 April 2009 209API Error CodesRecurring Payments Errors10744 Invalid Data This transaction cannot be processed.

Name-Value Pair API Developer Guide 08 April 2009 21Authorization and Capture API Operation ReferenceDoCapture APIDoCapture Responsez DoCapture Respon

API Error CodesRecurring Payments Errors210 08 April 2009 Name-Value Pair API Developer Guide11508 Invalid trial total billing cycles Trial total bill

Name-Value Pair API Developer Guide 08 April 2009 211API Error CodesRecurring Payments Errors11544 Invalid period status The trial period status must

API Error CodesRecurring Payments Errors212 08 April 2009 Name-Value Pair API Developer Guide11567 The time of the update is too close to the billing

Name-Value Pair API Developer Guide 08 April 2009 213API Error CodesSetCustomerBillingAgreement ErrorsSetCustomerBillingAgreement ErrorsSetCustomerBil

API Error CodesSetCustomerBillingAgreement Errors214 08 April 2009 Name-Value Pair API Developer Guide10440 Transaction refused because of an invalid

Name-Value Pair API Developer Guide 08 April 2009 215API Error CodesGetBillingAgreementCustomerDetails ErrorsGetBillingAgreementCustomerDetails Errors

API Error CodesCreateBillingAgreement Errors216 08 April 2009 Name-Value Pair API Developer Guide10411 This Express Checkout session has expired.This

Name-Value Pair API Developer Guide 08 April 2009 217API Error CodesUpdateBillingAgreement ErrorsUpdateBillingAgreement ErrorsUpdateBillingAgreement E

API Error CodesDoReferenceTransaction Errors218 08 April 2009 Name-Value Pair API Developer Guide10002 Authentication/Authorization Failed10004 Transa

Name-Value Pair API Developer Guide 08 April 2009 219API Error CodesDoReferenceTransaction Errors10216 Transaction refused because a confirmed address

Authorization and Capture API Operation ReferenceDoCapture API22 08 April 2009 Name-Value Pair API Developer GuideDo Capture Response FieldsPayerInfo

API Error CodesDoReferenceTransaction Errors220 08 April 2009 Name-Value Pair API Developer Guide10420 Transaction refused because of an invalid argum

Name-Value Pair API Developer Guide 08 April 2009 221API Error CodesDoReferenceTransaction Errors10434 Transaction refused because of an invalid argum

API Error CodesDoReferenceTransaction Errors222 08 April 2009 Name-Value Pair API Developer Guide10622 Order is voided. Order is voided.10623 Maximum

Name-Value Pair API Developer Guide 08 April 2009 223API Error CodesDoReferenceTransaction Errors11451 Billing Agreement Id or transaction Id is not v

API Error CodesAddressVerify API Errors224 08 April 2009 Name-Value Pair API Developer GuideAddressVerify API ErrorsAddressVerify API ErrorsManagePend

Name-Value Pair API Developer Guide 08 April 2009 225BCountry CodesCountry CodesCountry CodeAFGHANISTAN AFÅLAND ISLANDS AXALBANIA ALALGERIA DZAMERICAN

Country Codes226 08 April 2009 Name-Value Pair API Developer GuideBHUTAN BTBOLIVIA BOBOSNIA AND HERZEGOVINA BABOTSWANA BWBOUVET ISLAND BVBRAZIL BRBRIT

Name-Value Pair API Developer Guide 08 April 2009 227Country CodesCROATIA HRCUBA CUCYPRUS CYCZECH REPUBLIC CZDENMARK DKDJIBOUTI DJDOMINICA DMDOMINICAN

Country Codes228 08 April 2009 Name-Value Pair API Developer GuideGREECE GRGREENLAND GLGRENADA GDGUADELOUPE GPGUAM GUGUATEMALA GTGUERNSEY GGGUINEA GNG

Name-Value Pair API Developer Guide 08 April 2009 229Country CodesKAZAKHSTAN KZKENYA KEKIRIBATI KIKOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF KPKOREA,

Name-Value Pair API Developer Guide 08 April 2009 23Authorization and Capture API Operation ReferenceDoAuthorization APIPayer Name FieldsDoAuthorizati

Country Codes230 08 April 2009 Name-Value Pair API Developer GuideMEXICO MXMICRONESIA, FEDERATED STATES OF FMMOLDOVA, REPUBLIC OF MDMONACO MCMONGOLIA

Name-Value Pair API Developer Guide 08 April 2009 231Country CodesPARAGUAY PYPERU PEPHILIPPINES PHPITCAIRN PNPOLAND PLPORTUGAL PTPUERTO RICO PRQATAR Q

Country Codes232 08 April 2009 Name-Value Pair API Developer GuideSOMALIA SOSOUTH AFRICA ZASOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS GSSPAIN ESSRI

Name-Value Pair API Developer Guide 08 April 2009 233Country CodesUNITED KINGDOM GBUNITED STATES USUNITED STATES MINOR OUTLYING ISLANDS UMURUGUAY UYUZ

Country Codes234 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 235CState and Province CodesState and Province CodesCanadian Province or U.S. State AbbreviationAlbe

State and Province Codes236 08 April 2009 Name-Value Pair API Developer GuideGeorgia GAGuam GUHawaii HIIdaho ID Illinois ILIndiana INIowa IAKansas KSK

Name-Value Pair API Developer Guide 08 April 2009 237State and Province CodesOklahoma OKOregon ORPalau PWPennsylvania PAPuerto Rico PRRhode Island RIS

State and Province Codes238 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 239DCurrency CodesCurrencies and Currency Codes Supported by PayPal Currency Currency Code Australia

Authorization and Capture API Operation ReferenceDoReauthorization API24 08 April 2009 Name-Value Pair API Developer GuideDoAuthorization RequestDoAut

Currency Codes240 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 241EAVS and CVV2 Response Codesz “AVS Response Codes” on page 241z “CVV2 Response Codes” on page 243

AVS and CVV2 Response CodesAVS Response Codes242 08 April 2009 Name-Value Pair API Developer GuideAVS Response Codes for Visa, MasterCard, Discover, a

Name-Value Pair API Developer Guide 08 April 2009 243AVS and CVV2 Response CodesCVV2 Response CodesCVV2 Response Codesz CVV2 Response Codes for Visa,

Name-Value Pair API Developer Guide 08 April 2009 25Authorization and Capture API Operation ReferenceDoVoid APIDoReauthorization RequestDoReauthorizat

Authorization and Capture API Operation ReferenceDoVoid API26 08 April 2009 Name-Value Pair API Developer GuideDoVoid RequestDoVoid Request FieldsDoVo

Name-Value Pair API Developer Guide 08 April 2009 273DoDirectPayment APIProcess a credit card payment.z DoDirectPayment Requestz DoDirectPayment Respo

DoDirectPayment APIDoDirectPayment Request28 08 April 2009 Name-Value Pair API Developer GuideDoDirectPayment Request FieldsCredit Card Details Fields

Name-Value Pair API Developer Guide 08 April 2009 29DoDirectPayment APIDoDirectPayment RequestEXPDATE Credit card expiration date.This field is requir

Name-Value Pair API Developer Guide 08 April 2009 3ContentsPreface 9This Document . . . . . . . . . . . . . . . . . . . . . . .

DoDirectPayment APIDoDirectPayment Request30 08 April 2009 Name-Value Pair API Developer GuidePayerInfo Type FieldsPayer Name FieldsAddress FieldsFiel

Name-Value Pair API Developer Guide 08 April 2009 31DoDirectPayment APIDoDirectPayment RequestSTATE (Required) State or province.Character length and

DoDirectPayment APIDoDirectPayment Request32 08 April 2009 Name-Value Pair API Developer GuidePayment Details Type FieldsField DescriptionAMT (Require

Name-Value Pair API Developer Guide 08 April 2009 33DoDirectPayment APIDoDirectPayment RequestHANDLINGAMT (Optional) Total handling costs for this ord

DoDirectPayment APIDoDirectPayment Request34 08 April 2009 Name-Value Pair API Developer GuidePayment Details Item Type FieldsField DescriptionL_NAMEn

Name-Value Pair API Developer Guide 08 April 2009 35DoDirectPayment APIDoDirectPayment RequestL_ITEMWIDTHVALUEn, L_ITEMWIDTHUNITn(Optional) Item width

DoDirectPayment APIDoDirectPayment Response36 08 April 2009 Name-Value Pair API Developer GuideEbayItemPaymentDetailsItemType FieldsShip To Address Fi

Name-Value Pair API Developer Guide 08 April 2009 37DoDirectPayment APIDoDirectPayment ResponseDoDirectPayment Response FieldsField DescriptionTRANSAC

DoDirectPayment APIDoDirectPayment Response38 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 394Express Checkout API OperationsThis chapter describes the PayPal API operations related to Expres

Contents4 08 April 2009 Name-Value Pair API Developer GuideDoReauthorization Request . . . . . . . . . . . . . . . . . . . . . .

Express Checkout API OperationsCallback API40 08 April 2009 Name-Value Pair API Developer GuideCallback RequestCallback Request FieldsField Descriptio

Name-Value Pair API Developer Guide 08 April 2009 41Express Checkout API OperationsCallback APIL_ITEMHEIGHTVALUEn, L_ITEMHEIGHTUNITn The height of the

Express Checkout API OperationsCallback API42 08 April 2009 Name-Value Pair API Developer GuideCallback ResponseCallback Response FieldsField Descript

Name-Value Pair API Developer Guide 08 April 2009 43Express Checkout API OperationsSetExpressCheckout APISetExpressCheckout APIInitiates an Express Ch

Express Checkout API OperationsSetExpressCheckout API44 08 April 2009 Name-Value Pair API Developer GuideSetExpressCheckout Request FieldsField Descri

Name-Value Pair API Developer Guide 08 April 2009 45Express Checkout API OperationsSetExpressCheckout APIALLOWNOTE (Optional) The value 1 indicates th

Express Checkout API OperationsSetExpressCheckout API46 08 April 2009 Name-Value Pair API Developer GuideHDRBACKCOLOR (Optional) Sets the background c

Name-Value Pair API Developer Guide 08 April 2009 47Express Checkout API OperationsSetExpressCheckout APIGIROPAYCANCELURL (Optional) The URL on the me

Express Checkout API OperationsSetExpressCheckout API48 08 April 2009 Name-Value Pair API Developer GuideAddress FieldsPayment Details Type FieldsFiel

Name-Value Pair API Developer Guide 08 April 2009 49Express Checkout API OperationsSetExpressCheckout APISHIPPINGAMT (Optional) Total shipping costs f

Name-Value Pair API Developer Guide 08 April 2009 5ContentsChapter 8 TransactionSearch API . . . . . . . . . . . . . . . . . . .91

Express Checkout API OperationsSetExpressCheckout API50 08 April 2009 Name-Value Pair API Developer GuideINVNUM (Optional) Your own invoice or trackin

Name-Value Pair API Developer Guide 08 April 2009 51Express Checkout API OperationsSetExpressCheckout APIPayment Details Item Type FieldsField Descrip

Express Checkout API OperationsSetExpressCheckout API52 08 April 2009 Name-Value Pair API Developer GuideL_ITEMWIDTHVALUEn, L_ITEMWIDTHUNITn(Optional)

Name-Value Pair API Developer Guide 08 April 2009 53Express Checkout API OperationsSetExpressCheckout APIEbayItemPaymentDetailsItemType FieldsShipping

Express Checkout API OperationsGetExpressCheckoutDetails API54 08 April 2009 Name-Value Pair API Developer GuideBilling Agreement Details FieldsSetExp

Name-Value Pair API Developer Guide 08 April 2009 55Express Checkout API OperationsGetExpressCheckoutDetails APIGetExpressCheckoutDetails RequestGetEx

Express Checkout API OperationsGetExpressCheckoutDetails API56 08 April 2009 Name-Value Pair API Developer GuideGetExpressCheckoutDetails Response Fie

Name-Value Pair API Developer Guide 08 April 2009 57Express Checkout API OperationsGetExpressCheckoutDetails APICOUNTRYCODE Payer’s country of residen

Express Checkout API OperationsGetExpressCheckoutDetails API58 08 April 2009 Name-Value Pair API Developer GuidePayer Name FieldsAddress Type FieldsFi

Name-Value Pair API Developer Guide 08 April 2009 59Express Checkout API OperationsGetExpressCheckoutDetails APIPayment Details Type FieldsField Descr

Contents6 08 April 2009 Name-Value Pair API Developer GuideChapter 11 ManagePendingTransactionStatus API . . . . . . . . . . 151ManagePendi

Express Checkout API OperationsGetExpressCheckoutDetails API60 08 April 2009 Name-Value Pair API Developer GuideHANDLINGAMT (Optional) Total handling

Name-Value Pair API Developer Guide 08 April 2009 61Express Checkout API OperationsGetExpressCheckoutDetails APIPayment Details Item Type FieldsField

Express Checkout API OperationsGetExpressCheckoutDetails API62 08 April 2009 Name-Value Pair API Developer GuideL_ITEMWIDTHVALUEn, L_ITEMWIDTHUNITn(Op

Name-Value Pair API Developer Guide 08 April 2009 63Express Checkout API OperationsDoExpressCheckoutPayment APIUser Selected Options Type FieldsEbayIt

Express Checkout API OperationsDoExpressCheckoutPayment API64 08 April 2009 Name-Value Pair API Developer GuideDoExpressCheckoutPayment Requestz DoExp

Name-Value Pair API Developer Guide 08 April 2009 65Express Checkout API OperationsDoExpressCheckoutPayment APIDoExpressCheckoutPayment Request Fields

Express Checkout API OperationsDoExpressCheckoutPayment API66 08 April 2009 Name-Value Pair API Developer GuideITEMAMT (Optional) Sum of cost of all i

Name-Value Pair API Developer Guide 08 April 2009 67Express Checkout API OperationsDoExpressCheckoutPayment APIDESC (Optional) Description of items th

Express Checkout API OperationsDoExpressCheckoutPayment API68 08 April 2009 Name-Value Pair API Developer GuidePayment Details Item Type FieldsField D

Name-Value Pair API Developer Guide 08 April 2009 69Express Checkout API OperationsDoExpressCheckoutPayment APIL_ITEMWIDTHVALUEn, L_ITEMWIDTHUNITn(Opt

Name-Value Pair API Developer Guide 08 April 2009 7ContentsChapter C State and Province Codes . . . . . . . . . . . . . . . . . 235Ch

Express Checkout API OperationsDoExpressCheckoutPayment API70 08 April 2009 Name-Value Pair API Developer GuideUser Selected Options Type FieldsEbayIt

Name-Value Pair API Developer Guide 08 April 2009 71Express Checkout API OperationsDoExpressCheckoutPayment APIDoExpressCheckoutPayment Responsez DoEx

Express Checkout API OperationsDoExpressCheckoutPayment API72 08 April 2009 Name-Value Pair API Developer GuideDoExpressCheckoutPayment Response Field

Name-Value Pair API Developer Guide 08 April 2009 73Express Checkout API OperationsDoExpressCheckoutPayment APITRANSACTIONTYPE The type of transaction

Express Checkout API OperationsDoExpressCheckoutPayment API74 08 April 2009 Name-Value Pair API Developer GuidePENDINGREASON The reason the payment is

Name-Value Pair API Developer Guide 08 April 2009 755GetTransactionDetails APIObtain information about a specific transaction.z “GetTransactionDetails

GetTransactionDetails APIGetTransactionDetails Response76 08 April 2009 Name-Value Pair API Developer GuideReceiver Information FieldsPayer Informatio

Name-Value Pair API Developer Guide 08 April 2009 77GetTransactionDetails APIGetTransactionDetails ResponseAddress FieldsPayment Information FieldsFie

GetTransactionDetails APIGetTransactionDetails Response78 08 April 2009 Name-Value Pair API Developer GuidePARENTTRANSACTIONID z Parent or related tra

Name-Value Pair API Developer Guide 08 April 2009 79GetTransactionDetails APIGetTransactionDetails ResponseTAXAMT Tax charged on the transaction.Chara

Contents8 08 April 2009 Name-Value Pair API Developer Guide

GetTransactionDetails APIGetTransactionDetails Response80 08 April 2009 Name-Value Pair API Developer GuidePENDINGREASON NOTE: PendingReason is return

Name-Value Pair API Developer Guide 08 April 2009 81GetTransactionDetails APIGetTransactionDetails ResponsePROTECTIONELIGIBILITYThe the kind of seller

GetTransactionDetails APIGetTransactionDetails Response82 08 April 2009 Name-Value Pair API Developer GuidePayment Item Information FieldsPayment Item

Name-Value Pair API Developer Guide 08 April 2009 83GetTransactionDetails APIGetTransactionDetails ResponseSubscription Terms FieldsMULTIITEM Counter

GetTransactionDetails APIGetTransactionDetails Response84 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 856MassPay APIMake a payment to one or more PayPal account holders.z “MassPay Request” on page 85z “

MassPay APIMassPay Request86 08 April 2009 Name-Value Pair API Developer GuideMassPay Request FieldsMassPay Item Type FieldsField DescriptionMETHOD (R

Name-Value Pair API Developer Guide 08 April 2009 87MassPay APIMassPay ResponseMassPay ResponseThe fields in the response are the standard response he

MassPay APIMassPay Response88 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 897RefundTransaction APIIssue a refund to the PayPal account holder associated with a transaction.z

Name-Value Pair API Developer Guide 08 April 2009 9PrefaceThis DocumentThe Name-Value Pair API Developer Guide describes the PayPal Name-Value Pair AP

RefundTransaction APIRefundTransaction Response90 08 April 2009 Name-Value Pair API Developer Guide

Name-Value Pair API Developer Guide 08 April 2009 918TransactionSearch APISearch transaction history for transactions that meet the specified criteria

TransactionSearch APITransactionSearch Request92 08 April 2009 Name-Value Pair API Developer GuideTransactionSearch Request FieldsField DescriptionMET

Name-Value Pair API Developer Guide 08 April 2009 93TransactionSearch APITransactionSearch RequestTRANSACTIONCLASS (Optional) Search by classification

TransactionSearch APITransactionSearch Response94 08 April 2009 Name-Value Pair API Developer GuidePayer Name FieldsTransactionSearch ResponseTransact

Name-Value Pair API Developer Guide 08 April 2009 959Recurring Payments and Reference Transactions API OperationsThis chapter describes the PayPal API

Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile API96 08 April 2009 Name-Value Pair API Developer Guidez Bi

Name-Value Pair API Developer Guide 08 April 2009 97Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile APICrea

Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile API98 08 April 2009 Name-Value Pair API Developer GuideAUTO

Name-Value Pair API Developer Guide 08 April 2009 99Recurring Payments and Reference Transactions API OperationsCreateRecurringPaymentsProfile APIBill