• Choose a category
• All
• Classic-Fiction

API - Callback

API - Flatrate

INSURANCEOPTIONSELECTED The Yes/No option that you chose for insurance.

SHIPPINGOPTIONISDEFAULT Is true if the buyer chose the default shipping option. Value will be either TRUE or FALSE .

SHIPPINGOPTIONAMOUNT The shipping amount that was chosen by the buyer. 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 (,).

SHIPPINGOPTIONNAME This is true if the buyer chose the default shipping option.

PAYMENTREQUEST_n_SELLERPAYPALACCOUNTID Unique identifier for the merchant. For parallel payments, this field contains either the Payer ID or the email address of the merchant.

Callback

Callback allows you to return any relevant shipping information to the PayPal review page.Table 2-8 outlines the required Fields for Callback requests and Table 2-9 outlines the required fields for Callback responses.

Table 2-8. Callback request fields

Field Description

METHOD Must be Callback (required).

CURRENCYCODE The three-character currency code for the transaction from the Express Checkout API (required). Default is USD .

L_NAME n Item name from the Express Checkout API. Parameters must be numbered sequentially starting with 0 (e.g., L_NAME0, L_NAME1 ).

L_NUMBER n Item number from the Express Checkout API. Parameters must be numbered sequentially starting with 0 (e.g., L_NUMBER0, L_NUMBER1 ).

L_DESC n Item description from the Express Checkout API. Parameters must be numbered sequentially starting with 0 (e.g., L_DESC0, L_DESC1 ).

L_AMT n Item unit price from the Express Checkout API. Parameters must be numbered sequentially starting with 0 (e.g., L_AMT0, L_AMT1 ).

L_QTY n Item unit quantity from the Express Checkout API. Parameters must be numbered sequentially starting with 0 (e.g., L_QTY0, L_QTY1 ).

L_ITEMWEIGHTVALUEn L_ITEMWEIGHTUNIT n The weight of the item. You can pass this data to the shipping carrier as is, with no additional database query. Parameters must be numbered sequentially starting with 0 (e.g., L_ITEMWEIGHTVALUE0, L_ITEMWEIGHTVALUE1 ).

L_ITEMHEIGHTVALUEn L_ITEMHEIGHTUNIT n The height of the item. You can pass this data to the shipping carrier as is, with no additional database query. Parameters must be numbered sequentially starting with 0 (e.g., L_ITEMHEIGHTVALUE0, L_ITEMHEIGHTVALUE1 ).

L_ITEMWIDTHVALUEn L_ITEMWIDTHUNIT n The width of the item. You can pass this data to the shipping carrier as is, with no additional database query. Parameters must be numbered sequentially starting with 0 (e.g., L_ITEMWIDTHVALUE0, L_ITEMWIDTHVALUE1 ).

L_ITEMLENGTHVALUEn L_ITEMLENGTHUNIT n The length of the item. You can pass this data to the shipping carrier as is, with no additional database query. Parameters must be numbered sequentially starting with 0 (e.g., L_ITEMLENGTHVALUE0, L_ITEMLENGTHVALUE1 ).

SHIPTOSTREET The first street address. This is required if using a shipping address. Limitation: Up to 100 single-byte characters.

SHIPTOSTREET2 The second street address. Limitation: Up to 100 single-byte characters.

SHIPTOCITY The name of the city. This is required if using a shipping address. Limitation: Up to 40 single-byte characters.

SHIPTOSTATE The state or province. Required if using a shipping address. Limitation: Up to 40 single-byte characters.

SHIPTOZIP U.S. postal zip code or other country-specific postal code. Required if using a U.S. shipping address; may be required for other countries. Limitation: Up to 20 single-byte characters.

SHIPTOCOUNTRY Country code. Required if using a shipping address. Limitation: Up to two single-byte characters.

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

Table 2-9. Callback response fields

Field Description

METHOD Must be CallbackResponse (required).

CURRENCYCODE The