2009
Table Of Contents
- Name-Value Pair API Developer Guide
- Preface
- This Document
- Intended Audience
- Revision History
- PayPal NVP API Overview
- Authorization and Capture API Operation Reference
- DoDirectPayment API
- Express Checkout API Operations
- GetTransactionDetails API
- MassPay API
- RefundTransaction API
- TransactionSearch API
- Recurring Payments and Reference Transactions API Operations
- DoNonReferencedCredit API
- ManagePendingTransactionStatu s API
- GetBalance API
- AddressVerify API
- API Error Codes
- General API Errors
- Validation Errors
- Direct Payment API Errors
- SetExpressCheckout API Errors
- GetExpressCheckoutDetails API Errors
- DoExpressCheckoutPayment API Errors
- Authorization and Capture API Errors
- GetTransactionDetails API Errors
- TransactionSearch API Errors
- RefundTransaction API Errors
- Mass Pay API Errors
- Recurring Payments Errors
- SetCustomerBillingAgreement Errors
- GetBillingAgreementCustomerDetails Errors
- CreateBillingAgreement Errors
- UpdateBillingAgreement Errors
- DoReferenceTransaction Errors
- AddressVerify API Errors
- ManagePendingTransactionStatus API Errors
- Country Codes
- State and Province Codes
- Currency Codes
- AVS and CVV2 Response Codes
Express Checkout API Operations
GetExpressCheckoutDetails API
56 08 April 2009 Name-Value Pair API Developer Guide
GetExpressCheckoutDetails Response Fields
Payer Information Fields
Field Description
TOKEN The timestamped token value that was returned by SetExpressCheckout response
and passed on GetExpressCheckoutDetails request.
Character length and limitations: 20 single-byte characters
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.
NOTE: 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)
PAYPALADJUSTMENT A discount or gift certificate offered by PayPal to the buyer. This amount will be
represented by a negative amount. If the buyer has a negative PayPal account
balance, PayPal adds the negative balance to the transaction amount, which is
represented as a positive value.
NOTE The text entered by the buyer on the PayPal website if the ALLOWNOTE field was set
to 1 in SetExpressCheckout.
Character length and limitations: 255 single-byte characters
REDIRECTREQUIRED Flag to indicate whether you need to redirect the customer to back to PayPal after
completing the transaction.
NOTE: Use this field only if you are using giropay or bank transfer payment methods
in Germany.
Field Description
EMAIL Email address of payer.
Character length and limitations: 127 single-byte characters
PAYERID Unique PayPal customer account identification number.
Character length and limitations:13 single-byte alphanumeric characters.
PAYERSTATUS Status of payer. Valid values are:
z verified
z unverified
Character length and limitations: 10 single-byte alphabetic characters.