BMSetInventory API Operation (NVP)

METHOD

(Required) BMSetInventory

HOSTEDBUTTONID

(Required) The ID of the hosted button whose inventory you want to set.

TRACKINV

(Required) Whether to track inventory levels associated with the button. Value is:

• 0. Do not track inventory

• 1. Track inventory.

TRACKPNL

(Required) Whether to track the gross profit associated with inventory changes. Value is:

• 0. Do not track the gross profit

• 1. Track the gross profit.

OPTIONNAMEINDEX

(Optional) Option index, which identifies the button. Option index 0 is the menu that contains the price if one exists; otherwise, it is the first menu without a price.

Character length and limitations: One single-byte alphanumeric character.

SOLDOUTURL

(Optional) The URL to which the buyer's browser is redirected when the inventory drops to 0.

Character length and limitations: 127 single-byte alphanumeric characters.

REUSEDIGITALDOWNLOADKEYS

(Optional) Whether to reuse download keys:

• 0. Do not reuse keys. The default.

• 1. Reuse keys.

APPENDDIGITALDOWNLOADKEYS

(Optional) Whether to append download keys:

• 0. Do not append keys. The default.

• 1. Append keys.

L_DIGITALDOWNLOADKEYSn

(Conditional) One or more digital download keys, up to a maximum of 1,000 keys. This field is required if REUSEDIGITALDOWNLOADKEYS and APPENDDIGITALDOWNLOADKEYS are set to 1.

The variable n in the field name is a number between 0 and 999, inclusive, that specifies the key.

Character length and limitations: 1,000 single-byte alphanumeric characters each.

ITEMNUMBER

(Optional) The ID for an item associated with this button.

ITEMQTY

The quantity of the item associated with this button. Specify either the absolute quantity in this field or the change in quantity in the quantity delta field.

ITEMQTYDELTA

The change in quantity you want to specify for the item associated with this button. Specify either the change in quantity in this field or the absolute quantity in the item quantity field.

ITEMALERT

(Optional) The quantity of the item associated with this button below which PayPal sends you an email notification.

ITEMCOST

(Optional) The cost of the item associated with this button.

L_OPTIONNUMBERn

(Optional) The menu item's ID for an option in a drop-down menu

Lists variables for each menu item, where n is a digit between 0 and 9, inclusive.

L_OPTIONQTYn

The quantity you want to specify for the option associated with this menu item. Specify either the absolute quantity in this field or the change in quantity in the quantity delta field

Lists variables for each menu item, where n is a digit between 0 and 9, inclusive.

L_OPTIONSELECTn

(Optional) The menu item's name in a drop-down menu

Lists variables for each menu item, where n is a digit between 0 and 9, inclusive.

L_OPTIONQTYDELTAn

The change in quantity you want to specify for the option associated with this menu item. Specify either the change in quantity in this field or the absolute quantity in the quantity field.

Lists variables for each menu item, where n is a digit between 0 and 9, inclusive.

L_OPTIONALERTn

(Optional) The quantity of the option associated with this menu item below which PayPal sends you an email notification

Lists variables for each menu item, where n is a digit between 0 and 9, inclusive.

L_OPTIONCOSTn

(Optional) The cost of the option associated with this menu item

Lists variables for each menu item, where n is a digit between 0 and 9, inclusive.

Limitations: Value must be a positive number, with no currency symbol. It must have two decimal places and the decimal separator must be a period (.). It may have an optional comma (,) for the thousands separator.

TRANSACTIONID

Transaction ID

12210