PayPal APIs_ Up and Running_ A Developer's Guide - Michael Balderas [8]
PAYERID Unique PayPal customer account identification number as returned by the GetExpressCheckoutDetails response.Limitation: Up to 13 single-byte alphanumeric characters.
PAYMENTREQUEST_n_AMT The total cost of the transaction to the customer (required). If shipping and tax charges are known, include them in this value; if not, this value should be the current subtotal of the order. If the transaction includes one or more one-time purchases, this field must equal 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 charged immediately. Purchase-specific fields will be ignored.
Limitations: Must not exceed $10,000 USD in any currency. No currency symbol. Must have two decimal places, the decimal separator must be a period (.), and the optional thousands separator must be a comma (,).
PAYMENTREQUEST_n_PAYMENTACTION How you want to obtain your payment. When implementing parallel payments, this field is required and must be set to Order.
Sale indicates that this is a final sale for which you are requesting payment (this is the default).
Authorization indicates that this payment is a basic authorization subject to settlement with PayPal Authorization and Capture.
Order indicates that this payment is an order authorization subject to settlement with PayPal Authorization and Capture.
If the transaction does not include a one-time purchase, this field is ignored.
You cannot set this value to Sale in SetExpressCheckout request and then change this value to Authorization or Order on the final API DoExpressCheckoutPayment request. If the value is set to Authorization or Order in SetExpressCheckout, the value may be set to Sale or the same value (either Authorization or Order) in DoExpressCheckoutPayment.Limitation: Up to 13 single-byte alphabetic characters.
PAYMENTREQUEST_n_PAYMENTREQUESTID A unique identifier of the specific payment request, which is required for parallel payments. Limitation: Up to 127 single-byte character limit.
A full listing of the DoExpressCheckoutPayment request fields can be found in the online documentation located at http://www.x.com/community/ppx/documentation.
Table 2-7. DoExpressCheckoutPayment response fields
Field Description
TOKEN A time-stamped token, the value of which was returned by the SetExpressCheckout response and passed on to the GetExpressCheckoutDetails request.Limitation: Up to 20 single-byte characters.
PAYMENTTYPE Information about the payment.
SUCCESSPAGEREDIRECTREQUESTED Flag that indicates whether you need to redirect the customer to back to PayPal after completing the transaction.
PAYMENTINFO_n_TRANSACTIONID Unique transaction ID of the payment. If the PaymentAction of the request was Authorization or Order, this value is your AuthorizationID for use with the Authorization and Capture APIs.Limitation: Up to 19 single-byte characters.
PAYMENTINFO_n_TRANSACTIONTYPE The type of transaction. Valid values are cart and express-checkout. Limitation: Up to 15 single-byte characters.
PAYMENTINFO_n_PAYMENTTYPE Indicates whether the payment is instant or delayed. Valid values are none, echeck, and instant.Limitation: Up to 7 single-byte characters.
PAYMENTINFO_n_ORDERTIME The time/date stamp of the payment.
PAYMENTINFO_n_AMT The final amount charged, including any shipping and taxes from your Merchant Profile. Limitations: Does not exceed $10,000 USD in any currency. No currency symbol. Regardless of currency, the decimal separator is a period (.), and the optional thousands separator is a comma (,). Equivalent to nine characters maximum for USD.
PAYMENTINFO_n_FEEAMT PayPal fee amount charged for the transaction. Limitations: Does not exceed $10,000 USD in any currency. No currency symbol. Regardless of currency, the decimal separator