PayPal Authorization & Capture - 2006 User's Guide

Last Updated: June 2006For Professional Use OnlyCurrently only available in English.A usage Professional UniquementDisponible en Anglais uniquement po

List of Figures10 June 2006 Authorization & Capture Integration Guide

Authorization & Capture Integration Guide June 2006 11PrefaceThis DocumentThis release of the PayPal Authorization & Capture Integration Guide

PrefaceNotational Conventions12 June 2006 Authorization & Capture Integration GuideChapter 7, “Testing PayPal Authorization & Capture,” provid

Authorization & Capture Integration Guide June 2006 13PrefaceDocumentation ProblemsDocumentation ProblemsIf you discover any errors in or have any

PrefaceRevision History14 June 2006 Authorization & Capture Integration Guide

Authorization & Capture Integration Guide June 2006 151OverviewPayPal Authorization & Capture is a settlement solution that provides merchants

OverviewHonor Period and Authorization Period16 June 2006 Authorization & Capture Integration Guide2. You cannot reauthorize an order authorizatio

Authorization & Capture Integration Guide June 2006 17OverviewHonor Period and Authorization PeriodFIGURE 1.1 High-Level Diagram of Authorization

OverviewSupported PayPal Payment Products18 June 2006 Authorization & Capture Integration Guide1. Authorization & Capture can be used with dif

Authorization & Capture Integration Guide June 2006 19OverviewSupported PayPal Payment ProductsPayPal Products Not SupportedAuthorization & Ca

© 2006 PayPal Inc. All rights reserved. PayPal and the PayPal logo are registered trademarks of PayPal, Inc. Designated trademarks and brands are the

OverviewSupported PayPal Payment Products20 June 2006 Authorization & Capture Integration Guide

Authorization & Capture Integration Guide June 2006 212Basic Authorization & Capture on the PayPal WebsiteOnce your buyer has authorized payme

Basic Authorization & Capture on the PayPal WebsiteCapturing Funds22 June 2006 Authorization & Capture Integration GuideFIGURE 2.2 Capturing F

Authorization & Capture Integration Guide June 2006 23Basic Authorization & Capture on the PayPal WebsiteVoiding an AuthorizationAdditional Ca

Basic Authorization & Capture on the PayPal WebsiteReauthorizing Payment24 June 2006 Authorization & Capture Integration GuideFIGURE 2.3 Voidi

Authorization & Capture Integration Guide June 2006 25Basic Authorization & Capture on the PayPal WebsiteReauthorizing Payment2. Enter the rea

Basic Authorization & Capture on the PayPal WebsiteReauthorizing Payment26 June 2006 Authorization & Capture Integration Guide

Web Services API Reference June 2006 273Authorization & Capture APIThe Authorization & Capture API consists of individual requests and respons

Authorization & Capture APIDoCapture28 June 2006 Web Services API ReferenceDoCaptureDoCaptureRequest is your request to completely or partially se

Web Services API Reference June 2006 29Authorization & Capture APIDoCaptureDoCaptureRequestRequest to capture funds from a PayPal member’s account

Authorization & Capture Integration Guide June 2006 3ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . .

Authorization & Capture APIDoCapture30 June 2006 Web Services API ReferenceDoCaptureResponseResponse to DoCaptureRequest.FieldsTABLE 3.5 DoCapture

Web Services API Reference June 2006 31Authorization & Capture APIDoCaptureTaxAmount Tax charged on the transactionebl:BasicAmountTypexs:stringTra

Authorization & Capture APIDoCapture32 June 2006 Web Services API ReferencePendingReason NOTE:PendingReason is returned in the response only if Pa

Web Services API Reference June 2006 33Authorization & Capture APIDoAuthorizationDoAuthorizationDoAuthorizationRequest is your request to authoriz

Authorization & Capture APIDoAuthorization34 June 2006 Web Services API ReferenceDoAuthorizationRequestRequest to authorize all or part of a custo

Web Services API Reference June 2006 35Authorization & Capture APIDoVoidDoVoidDoVoidRequest voids an order or an authorization.IMPORTANT:The Autho

Authorization & Capture APIDoVoid36 June 2006 Web Services API ReferenceDoVoidRequestRequest to void a prior authorization.FieldsDoVoidResponseRes

Web Services API Reference June 2006 37Authorization & Capture APIDoReauthorizationDoReauthorizationTo use DoReauthorization you must have previou

Authorization & Capture APIDoReauthorization38 June 2006 Web Services API ReferenceDoReauthorizationRequestRequest to use Authorization & Capt

Authorization & Capture Integration Guide June 2006 394Basic Authorization & Capture ScenariosThis chapter includes examples of some common sc

Contents4 June 2006 Authorization & Capture Integration GuideDoCaptureResponse . . . . . . . . . . . . . . . . . . . . . .

Basic Authorization & Capture ScenariosOne Authorization, Multiple Captures, and a Refund40 June 2006 Authorization & Capture Integration Guid

Authorization & Capture Integration Guide June 2006 41Basic Authorization & Capture ScenariosLower Capture AmountYour Transaction Details show

Basic Authorization & Capture ScenariosCapture Up to 115%42 June 2006 Authorization & Capture Integration GuideFIGURE 4.12Transaction Details:

Authorization & Capture Integration Guide June 2006 43Basic Authorization & Capture ScenariosAuthorization ExpiresFIGURE 4.13Transaction Detai

Basic Authorization & Capture ScenariosVoid44 June 2006 Authorization & Capture Integration GuideFIGURE 4.14Transaction Details: Expired Autho

Authorization & Capture Integration Guide June 2006 45Basic Authorization & Capture ScenariosReattempted CaptureFIGURE 4.15History: Voided Tra

Basic Authorization & Capture ScenariosReattempted Capture46 June 2006 Authorization & Capture Integration GuideFIGURE 4.16A Capture Error6. T

Authorization & Capture Integration Guide June 2006 475Order Authorizations ScenariosThe following are common scenarios you will encounter when im

Order Authorizations ScenariosConcurrent Authorizations48 June 2006 Authorization & Capture Integration GuideConcurrent AuthorizationsTABLE 5.15 C

Authorization & Capture Integration Guide June 2006 49Order Authorizations ScenariosTotal Capture Hits Relative Tolerance With Open Authorizations

Authorization & Capture Integration Guide June 2006 5ContentsVoiding Basic Authorizations . . . . . . . . . . . . . . . . . . .

Order Authorizations ScenariosVoid Authorizations50 June 2006 Authorization & Capture Integration GuideVoid AuthorizationsTABLE 5.17 Void Authoriz

Authorization & Capture Integration Guide June 2006 51Order Authorizations ScenariosPartial CapturePartial CaptureTABLE 5.18 Partial Capture Scena

Order Authorizations ScenariosComplete Capture52 June 2006 Authorization & Capture Integration GuideNOTE:The default for the DoCapture API is a Co

Authorization & Capture Integration Guide June 2006 536Best PracticesCapturing Funds on Basic AuthorizationsPayPal recommends that you capture fun

Best PracticesVoiding Basic Authorizations54 June 2006 Authorization & Capture Integration Guide

Authorization & Capture Integration Guide June 2006 557Testing PayPal Authorization & CaptureYou can test your web- or API-based implementatio

Testing PayPal Authorization & CaptureFeatures Not Supported in the PayPal Sandbox56 June 2006 Authorization & Capture Integration Guide

Authorization & Capture Integration Guide June 2006 57APayPal Authorization & Capture StatusesAn authorization can only have one status at a t

PayPal Authorization & Capture Statuses58 June 2006 Authorization & Capture Integration Guide

Authorization & Capture Integration Guide June 2006 59BPayPal Authorization & Capture API Error Codes, Short Messages, and Long MessagesAuthor

Contents6 June 2006 Authorization & Capture Integration Guide

PayPal Authorization & Capture API Error Codes, Short Messages, and Long MessagesAuthorization & Capture API Errors60 June 2006 Authorization

Authorization & Capture Integration Guide June 2006 61PayPal Authorization & Capture API Error Codes, Short Messages, and LongMessages10613 Cu

PayPal Authorization & Capture API Error Codes, Short Messages, and Long MessagesAuthorization & Capture API Errors62 June 2006 Authorization

Authorization & Capture Integration Guide June 2006 63PayPal Authorization & Capture API Error Codes, Short Messages, and LongMessages11094 Th

PayPal Authorization & Capture API Error Codes, Short Messages, and Long MessagesAuthorization & Capture API Errors64 June 2006 Authorization

Authorization & Capture Integration Guide June 2006 65CIPN and PayPal Authorization & CaptureFor details on how to set up and verify IPN, refe

IPN and PayPal Authorization & Capture66 June 2006 Authorization & Capture Integration GuideNOTE:“Open Auth” refers to an authorization that h

June 2006 67GlossaryAVSAddress Verification System. A U.S. banking industry standard for confirming the postal address or telephone number associated

Glossary68 June 2006voidIn the context of payment processing with Authorization & Capture, to cancel a prior reauthorization of a settlement amoun

Authorization & Capture Integration Guide June 2006 7List of TablesTable P.1 Revision History . . . . . . . . . . . . . . . . .

List of Tables8 June 2006 Authorization & Capture Integration Guide

Authorization & Capture Integration Guide June 2006 9List of FiguresFigure 1.1 High-Level Diagram of Authorization & Capture . . . . . .