2007

Name-Value Pair API Developer Guide and Reference April 2007 43
NVP API Method and Field Reference
Express Checkout
DoExpressCheckoutPayment Request
Request to obtain payment with PayPal Express Checkout.
IMPORTANT: PayPal requires that a merchant using Express Checkout display to the
customer the same amount that the merchant sends to PayPal in the AMT
parameter with the DoExpressCheckoutPayment request API.
SHIPTOSTREET2 Second street address.
Character length and limitations: 100 single-byte characters
SHIPTOCITY Name of city.
Character length and limitations: 40 single-byte characters
SHIPTOSTATE State or province
Character length and limitations: 40 single-byte characters
SHIPTOCOUNTRYCODE Country code.
Character limit: Two single-byte characters.
For the list of country codes, see
Appendix F, “Country Codes.”
SHIPTOZIP U.S. Zip code or other country-specific postal code.
Character length and limitations: 20 single-byte characters
ADDRESSSTATUS Status of street address on file with PayPal
CUSTOM A free-form field for your own use, as set by you in the Custom element of
SetExpressCheckout request.
Character length and limitations: 256 single-byte alphanumeric characters
INVNUM Your own invoice or tracking number, as set by you in the element of the same name in
SetExpressCheckout request .
Character length and limitations: 127 single-byte alphanumeric characters
PHONENUM Payer’s contact telephone number.
N OTE: PayPal returns a contact telephone number only if your Merchant account
profile settings require that the buyer enter one.
Character length and limitations: Field mask is XXX-XXX-XXXX (for US numbers) or
+XXX XXXXXXXX (for international numbers)
REDIRECTREQUIRED If the value equals “True,” you must redirect the user after the DoExpressCheckout
call. The value here indicates that you should inform your user on the Review Order
page that he will be redirected to PayPal to complete the transaction.
T
ABLE A.6 GetExpressCheckoutDetails Response Fields (Continued)
Field Description