2009

Contents
4 Website Payments Pro Payflow Edition Developer’s Guide
Parameters Used in Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Submitting Sale Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
When To Use a Sale Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Additional Parameters For Sale Transactions . . . . . . . . . . . . . . . . . . . . . . 24
Typical Sale Transaction Parameter String . . . . . . . . . . . . . . . . . . . . . . . 24
Submitting Authorization/Delayed Capture Transactions . . . . . . . . . . . . . . . . . . 24
When To Use Authorization/Delayed Capture Transactions. . . . . . . . . . . . . . . 25
Required Authorization Transaction Parameters . . . . . . . . . . . . . . . . . . . . 25
Typical Authorization Transaction Parameter String . . . . . . . . . . . . . . . . . . . 25
Required Delayed Capture Transaction Parameters . . . . . . . . . . . . . . . . . . 25
Delayed Capture Transaction: Capturing Transactions for Lower Amounts. . . . . . . 27
Delayed Capture Transaction: Capturing Transactions for Higher Amounts . . . . . . 28
Delayed Capture Transaction: Error Handling and Retransmittal . . . . . . . . . . . . 28
Submitting Credit Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Required Credit Transaction Parameters . . . . . . . . . . . . . . . . . . . . . . . . 28
Credit Transaction Parameter Strings . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Submitting Void Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
When To Use a Void Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Required Void Transaction Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 31
Example Void Transaction Parameter String . . . . . . . . . . . . . . . . . . . . . . 31
Recharging to the Same Credit Card (Reference Transactions). . . . . . . . . . . . . . . 32
When To Use a Reference Transaction . . . . . . . . . . . . . . . . . . . . . . . . . 32
Transaction Types that Can Be Used as the Original Transaction . . . . . . . . . . . 32
Fields Copied From Reference Transactions . . . . . . . . . . . . . . . . . . . . . . 33
Example Reference Transaction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Using Address Verification Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Example Address Verification Service Request . . . . . . . . . . . . . . . . . . . . . 34
Example Address Verification Service Response . . . . . . . . . . . . . . . . . . . . 34
Card Security Code Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Example CVV2 Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Example CVV2 Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Chapter 5 Responses to Transaction Requests . . . . . . . . . . . .37
Contents of a Response to a Credit Card Transaction Request . . . . . . . . . . . . . . . 37
Address Verification Service Responses From PayPal . . . . . . . . . . . . . . . . . . . 39
Card Security Code Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Normalized Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
PayPal Card Security Code Results . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
PNREF Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41