2007
Table Of Contents
- Name-Value Pair API Reference for Germany
- Preface
- Overview
- Accepting PayPal in Express Checkout
- Basic Checkout with PayPal
- Support giropay and electronic funds transfer
- Controlling the Shipping Address Using SetExpressCheckout
- Changing the Language on the PayPal Login Page Using SetExpressCheckout
- Changing the Logo on the PayPal Pages Using SetExpressCheckout
- Form-Filling Your Payment Review Page Using GetExpressCheckoutDetails
- Making a Sale Using DoExpressCheckoutPayment
- Changing the URL for IPN Using DoExpressCheckoutPayment
- Including Line Item Details Using DoExpressCheckoutPayment
- Including Subtotals Using DoExpressCheckoutPayment
- Updating Order Details Using DoExpressCheckoutPayment
- Updating the Shipping Address Using DoExpressCheckoutPayment
- Back-Office Administration
- NVP API Method and Field Reference
- Error Message Reference
- NVP API Web Samples
- The Java SDK
- The ASP.NET SDK
- Country Codes
- Index
Name-Value Pair API Developer Guide and Reference April 2007 49
NVP API Method and Field Reference
Express Checkout
PAYMENTSTATUS Status of the payment:
Completed: The payment has been completed, and the funds have been added
successfully to your account balance.
Pending: The payment is pending. See the PendingReason element for more
information.
PENDINGREASON The reason the payment is pending:
z none: No pending reason
z address: The payment is pending because your customer did not include a confirmed
shipping address and your Payment Receiving Preferences is set such that you want to
manually accept or deny each of these payments. To change your preference, go to the
Preferences section of your Profile.
z echeck: The payment is pending because it was made by an eCheck that has not yet
cleared.
z intl: The payment is pending because you hold a non-U.S. account and do not have a
withdrawal mechanism. You must manually accept or deny this payment from your
Account Overview.
z multi-currency: You do not have a balance in the currency sent, and you do not
have your Payment Receiving Preferences set to automatically convert and
accept this payment. You must manually accept or deny this payment.
z verify: The payment is pending because you are not yet verified. You must verify
your account before you can accept this payment.
z other: The payment is pending for a reason other than those listed above. For more
information, contact PayPal customer service.
REASONCODE The reason for a reversal if TransactionType is reversal:
z none: No reason code
z chargeback: A reversal has occurred on this transaction due to a chargeback by your
customer.
z guarantee: A reversal has occurred on this transaction due to your customer
triggering a money-back guarantee.
z buyer-complaint: A reversal has occurred on this transaction due to a complaint
about the transaction from your customer.
z refund: A reversal has occurred on this transaction because you have given the
customer a refund.
z other: A reversal has occurred on this transaction due to a reason not listed above.
REDIRECTREQUIRED If the value equals "True" you have to redirect the user to PayPal. PayPal will direct the
user according to the selected payment methods (e.g. to giropay).
When redirecting the user to Paypal you need to append the Token-value to the following
redirect URL https://www.paypal.com/webscr?cmd=_complete-express-
checkout&token=TOKEN. TOKEN needs to equal the Token-value that you received in the
SetExpressCheckoutResponse.
T
ABLE A.9 DoExpressCheckout Payment Response Fields (Continued)
Field Description