2012

Table Of Contents

Name-Value Pair API Developer Guide August 2012 59

ExpressCheckout API Operations

SetExpressCheckout API Operation

The SetExpressCheckout API operation initiates an Express Checkout transaction.

SetExpressCheckout Request Message

SetExpressCheckout Request Fields

L_INSURANCEAMOUNT

n (Optional) New insurance amount based on this shipping option and the shipping

address.

NOTE: Character length and limitations: Must not exceed $10,000 USD in any

currency. No currency symbol. Regardless of currency, decimal separator

must be a period (.), and the optional thousands separator must be a comma

(,). Equivalent to nine characters maximum for USD.

OFFERINSURANCEOPTIO

(Optional) Indicates whether or not PayPal should display insurance in a drop-down

list on the Review page. When the value is true, PayPal displays the drop-down

with the associated amount and the string ‘Yes.’

NO_SHIPPING_OPTION_

DETAILS

(Optional) If you do not ship to the buyer’s shipping address, set this field to 1. The

value of CALLBACKVERSION in SetExpressCheckout request must be 61.0 or

greater, similar to the following:

CALLBACKVERSION=<61.0 or greater>

Character length and limitations: string

Field Description

METHOD (Required) Must be SetExpressCheckout.

AMT (deprecated) (Required) The total cost of the transaction to the buyer. If shipping cost 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 be equal to the sum of the purchases. If the transaction does not include a

one-time purchase such as when you set up a billing agreement for a recurring

payment, set this field to 0.

Character length and limitations: Value is a positive number which cannot exceed

$10,000 USD in any currency. It includes no currency symbol. It must have 2 decimal

places, the decimal separator must be a period (.), and the optional thousands

separator must be a comma (,).

AMT is deprecated since version 63.0. Use PAYMENTREQUEST_0_AMT instead.

Field Description