2006
Table Of Contents
- Authorization & Capture Integration Guide
- Preface
- Overview
- Basic Authorization & Capture on the PayPal Website
- Authorization & Capture API
- Order Authorizations Scenarios
- Best Practices
- Testing PayPal Authorization & Capture
- PayPal Authorization & Capture Statuses
- PayPal Authorization & Capture API Error Codes, Short Messages, and Long Messages
- IPN and PayPal Authorization & Capture
- Glossary
Contents
4 June 2006 Authorization & Capture Integration Guide
DoCaptureResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
DoAuthorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Diagram of DoAuthorization Types . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
DoAuthorizationRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
DoAuthorizationResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
DoVoid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Diagram of DoVoid Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DoVoidRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
DoVoidResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
DoReauthorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Diagram of DoReauthorization Types . . . . . . . . . . . . . . . . . . . . . . . . . . 37
DoReauthorizationRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
DoReauthorizationResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Chapter 4 Basic Authorization & Capture Scenarios . . . . . . . . . .39
Capture Within 3 Days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Capture From 4 - 29 Days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
One Authorization, Multiple Captures, and a Refund . . . . . . . . . . . . . . . . . . . . 40
Lower Capture Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Capture Up to 115% . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Authorization Expires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Void . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Reattempted Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Chapter 5 Order Authorizations Scenarios. . . . . . . . . . . . . . .47
Simple Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Complex Order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Concurrent Authorizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Total Capture Hits Relative Tolerance With Open Authorizations . . . . . . . . . . . . . . 49
Void Authorizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Partial Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Complete Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Chapter 6 Best Practices . . . . . . . . . . . . . . . . . . . . . . . .53
Capturing Funds on Basic Authorizations . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Buyer Approval for Basic Authorizations. . . . . . . . . . . . . . . . . . . . . . . . . . . 53