2009

Name-Value Pair API Developer Guide 08 April 2009 65
Express Checkout API Operations
DoExpressCheckoutPayment API
DoExpressCheckoutPayment Request Fields
Payment Details Type Fields
Field Description
METHOD (Required) Must be DoExpressCheckoutPayment.
TOKEN (Required) The timestamped token value that was returned by
SetExpressCheckout response and passed on GetExpressCheckoutDetails
request.
Character length and limitations: 20 single-byte characters
PAYMENTACTION (Required) How you want to obtain payment:
z Authorization indicates that this payment is a basic authorization subject to
settlement with PayPal Authorization & Capture.
z Order indicates that this payment is is an order authorization subject to
settlement with PayPal Authorization & Capture.
z Sale indicates that this is a final sale for which you are requesting payment.
NOTE: You cannot set this value to Sale on SetExpressCheckout request and
then change this value to Authorization on the final PayPal Express
Checkout API DoExpressCheckoutPayment request.
Character length and limit: Up to 13 single-byte alphabetic characters
PAYERID (Required) Unique PayPal customer account identification number as returned by
GetExpressCheckoutDetails response.Character length and limitations: 13
single-byte alphanumeric characters.
(Optional) Shipping options and insurance selected by the user.
RETURNFMFDETAILS (Optional) Flag to indicate whether you want the results returned by Fraud
Management Filters. By default, you do not receive this information.
z 0 - do not receive FMF details (default)
z 1 - receive FMF details
Field Description
AMT (Required) The total cost of the transaction to the customer. If shipping cost and tax
charges are known, include them in this value; if not, this value should be the current
sub-total of the order.
If the transaction includes one or more one-time purchases, this field must be equal to
the sum of the purchases.
Set this field to 0 if the transaction does not include a one-time purchase; for example,
when you set up a billing agreement for a recurring payment that is not immediately
charged.
Limitations: Must not exceed $10,000 USD in any currency. No currency symbol.
Must have two decimal places, decimal separator must be a period (.), and the
optional thousands separator must be a comma (,).
CURRENCYCODE (Optional) A three-character currency code. Default: USD.