Integration Guide

Table Of Contents
Website Payments Standard Integration Guide September 2008 9
Contents
Automatic Calculation of Shipping Charges (non-U.S. Merchants Only) . . . . . . . . . .304
Examples of Cost Methods and Shipping Calculations . . . . . . . . . . . . . . . . .305
Overriding Shipping Calculation on Individual Transactions. . . . . . . . . . . . . . .306
Blocking Certain Kinds of Payments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
Accessing Your Payment Receiving Preferences to Block Payments . . . . . . . . . .307
Blocking Payments From U.S. Payers Without a Confirmed Address. . . . . . . . . .308
Blocking Payments in Currencies That You Do Not Hold . . . . . . . . . . . . . . . .309
Blocking Payments from Payers With Non-U.S. PayPal Accounts . . . . . . . . . . .309
Blocking Payments Initiated Through the Pay Anyone Subtab . . . . . . . . . . . . .310
Blocking Payments by Credit Card Instead of Bank Account . . . . . . . . . . . . . .310
Blocking Payments Funded With eChecks . . . . . . . . . . . . . . . . . . . . . . .310
Adding Your Credit Card Statement Name. . . . . . . . . . . . . . . . . . . . . . . . . .310
Allowing Multiple Users to Access Your PayPal Account . . . . . . . . . . . . . . . . . .312
Adding a User Login to Your Account . . . . . . . . . . . . . . . . . . . . . . . . . .312
Changing the Privileges for a User Login . . . . . . . . . . . . . . . . . . . . . . . .313
Resetting the Password for a User Login . . . . . . . . . . . . . . . . . . . . . . . .314
Removing a User Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315
Handling Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315
Managing Currency Balances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316
Accepting or Denying Cross-Currency Payments . . . . . . . . . . . . . . . . . . . .317
Language Encoding Your Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317
About Language Encoding for Exchanging Data With PayPal . . . . . . . . . . . . .318
Changing Your Default Language Encoding. . . . . . . . . . . . . . . . . . . . . . .318
Chapter 8 Using Authorization & Capture . . . . . . . . . . . . . . 321
Basic Authorization Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .321
Honor Period and Authorization Period . . . . . . . . . . . . . . . . . . . . . . . . .321
Basic Authorization & Capture Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . .322
Capturing A Single Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
Batch Capturing Multiple Authorizations. . . . . . . . . . . . . . . . . . . . . . . . .323
Voiding an Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
Capture Within 3 Days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
Capture From 4 - 29 Days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
One Authorization, Multiple Captures, and a Refund . . . . . . . . . . . . . . . . . .326
Lower Capture Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
Capture Up to 115% . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
Authorization Expires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
Void . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
Reattempted Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331