• Choose a category
• All
• Classic-Fiction

CANCELURL URL to which the customer is returned if he does not approve the use of PayPal to pay you. PayPal recommends that the value be the original page on which the customer chose to pay with PayPal or establish a billing agreement.

Limitation: Up to 2,048 characters. Yes

PAYMENTREQUEST_n_AMT The total cost of the transaction to the customer. 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 (,).

Yes

PAYMENT_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.

Yes

A complete list of all fields allowed for the SetExpressCheckout request method can be found in the online documentation located at http://www.x.com/community/ppx/documentation.

Table 2-4. SetExpressCheckout response fields

Field Description

TOKEN A time-stamped token by which you identify to PayPal that you are processing this payment with Express Checkout. The token expires after three hours. If you set the token in the SetExpressCheckout request, the value of the token in the response is identical to the value in the request.

Limitation: Up to 20 single-byte characters.

A complete list of all fields allowed for the SetExpressCheckout response method can be found in the online documentation located at http://www.x.com/community/ppx/documentation.

GetExpressCheckoutDetails

GetExpressCheckoutDetails obtains information about an Express Checkout transaction. Only the request has required fields, as the response just echoes back the information and values enabled in SetExpressCheckout. Table 2-5 describes the required GetExpressCheckoutDetails fields.

Table 2-5. GetExpressCheckoutDetails request fields

Field Description

METHOD Must be GetExpressCheckoutDetails

TOKEN A time-stamped token, limited to 20 single-byte characters, the value of which was returned by the SetExpressCheckout response

A full listing of the GetExpressCheckoutDetails response fields can be found in the online documentation located at http://www.x.com/community/ppx/documentation.

DoExpressCheckoutPayment

DoExpressCheckoutPayment completes the Express Checkout transaction and returns the payment response. If you set up a billing agreement in your SetExpressCheckout API call, the billing agreement is created when you call the DoExpressCheckoutPayment API operation. Table 2-6 lists the DoExpressCheckoutPayment request fields, and Table 2-7 describes the response fields.

Table 2-6. DoExpressCheckoutPayment request fields

Field Description

METHOD Must be DoExpressCheckoutPayment .

TOKEN A time-stamped