Button Manager API (SOAP) Last updated: April 2012
Button Manager SOAP API Document Number: 10090.en_US-201204 © 2012 PayPal, Inc. All rights reserved. PayPal is a registered trademark of PayPal, Inc. The PayPal logo is a trademark of PayPal, Inc. Other trademarks and brands are the property of their respective owners. The information in this document belongs to PayPal, Inc. It may not be used, reproduced or disclosed without the written approval of PayPal, Inc. Copyright © PayPal. All rights reserved. PayPal S.à r.l. et Cie, S.C.A.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Chapter 1 PayPal Payments Standard Button Manager API Overview . 7 Button Manager Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Generated Button Code . . . . . . . . . . . . . . . . . . .
Contents BMButtonSearch Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 BMButtonSearch Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 BMGetButtonDetails API Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 BMGetButtonDetails Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 BMGetButtonDetails Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 BMGetButtonDetails Errors . . . . . . . . . . . .
Preface This document describes the Button Manager API for SOAP. Intended Audience This document is intended for merchants and developers implementing PayPal Payment Standard (previously known as Website Payments Standard) buttons using an API. Revision History Revision history for Button Manager API (SOAP). TABLE P.1 Revision History Date Description 04/03/12 Updated references to Website Payments Standard and Website Payments Pro to PayPal Payments Standard and PayPal Payments Pro, respectively.
Revision History 6 April 2012 Button Manager SOAP API
1 PayPal Payments Standard Button Manager API Overview The PayPal Payments Standard (previously known as Website Payments Standard) Button Manager API lets you programatically create, manage, edit, and delete PayPal Payment Standard buttons, which are the same kind of buttons that you can create from the PayPal Profile.
1 PayPal Payments Standard Button Manager API Overview Generated Button Code Subscribe and Unsubscribe Pay Now (Hosted Sole Solution only) Installment Plan Automatic Billing The following buttons are some of those that you can create using the Button Manager API: Generated Button Code When you create a button, PayPal responds by generating code that you can paste into your web page or document.
PayPal Payments Standard Button Manager API Overview Generated Button Code 1 created through the API. If you can create the button for the specified country using Create PayPal payment button on PayPal, your merchant will be able to use the button. This example shows the PayPal code for displaying a hosted Add to Cart button to sell a wireless mouse:
PayPal Payments Standard Button Manager API Overview Inventory Management Using Hosted Buttons Update a hosted button, which lets you to change individual parameters, such as price, in a hosted button Manage hosted button status; currently, you can only delete a button Get and set inventory information associated with the button 1 Inventory Management Using Hosted Buttons You can get or set the inventory level for the item associated with a hosted button.
1 PayPal Payments Standard Button Manager API Overview Button Manager API Summary Button Manager API Summary The Button Manager API is available for both NVP and SOAP.
PayPal Payments Standard Button Manager API Overview Granting Third-Party Permission for APIs 1 5. Click Configure a custom API authorization. 6. Enter your Partner API username, as specified by your shopping cart or third party. 7. Check each Button Manager API you want to provide access to: 8. Click Submit.
1 14 PayPal Payments Standard Button Manager API Overview Granting Third-Party Permission for APIs April 2012 Button Manager SOAP API
2 Using the Button Manager API With SOAP These examples show basic Button Manager API capabilities. The examples show how to create buttons and set inventory levels. Specifying HTML Variables Creating a Button Using SOAP Tracking Inventory for a Button Using SOAP Specifying HTML Variables When you create or update a button using the Button Manager API, you must specify the same HTML variables that you specify when creating any PayPal Payments Standard button.
2 Using the Button Manager API With SOAP Creating a Button Using SOAP HTML Variable Notes no_note Must be specified for Subscribe buttons. Enables a subscriber to not be prompted to include a note with the subscription, a function which PayPal subscriptions does not support. This variable must be included, and the value must be set to 1. business Secure Merchant ID or Email Address. When omitted, defaults to the secure merchant ID of the merchant.
Using the Button Manager API With SOAP Creating a Button Using SOAP 2 item_number=#1234 shipping=0.50 tax_rate=2.50 address1= state= city= zip= no_shipping=0 address_override=0 DD1
2 Using the Button Manager API With SOAP Tracking Inventory for a Button Using SOAP <__value__> BUYNOW <__value__> SUBSCRIBE <__value__> US
3 Button Manager API Reference The Button Manager API enables you to programatically create, edit, and delete PayPal Payments Standard buttons hosted on PayPal, and track product inventory associated with these buttons. You can also create non-hosted buttons with the Button Manager API; however, only hosted buttons support button maintenance and inventory management.
3 20 Button Manager API Reference BMCreateButton API Operation April 2012 Button Manager SOAP API
Button Manager API Reference BMCreateButton API Operation 3 BMCreateButton Request Fields Field Description ButtonCode ebl:ButtonCodeType (Optional) The kind of button code to create.
3 Button Manager API Reference BMCreateButton API Operation Field Description OptionSelectionDetails ns:OptionSelectionDetailsType (Optional) Menu items Option Selection Details Fields OptionSelection xs:string (Optional) The menu item’s name Price xs:string (Optional) The price associated with the first menu item N O TE : OptionType ebl:OptionTypeListType (Optional) The installment option type for an OPTIONnNAME, which is one of the following values: FULL - Payment in full VARIABLE - Variabl
Button Manager API Reference BMCreateButton API Operation ShippingAmount xs:string (Optional) The shipping amount to bill for the cycle, in addition to the base amount. TaxAmount xs:string (Optional) The tax amount to bill for the cycle, in addition to the base amount. 3 Button Language Options The button language must be compatible with the country identified by the country code.
3 Button Manager API Reference BMCreateButton API Operation Country Button Language Options Switzerland United States de - German; default fr - French en - English en - English; default fr - French es - Spanish zh - Chinese BMCreateButton Response The response contains an ID if the button is hosted on PayPal, and code for HTML in a website and for a link in email.
Button Manager API Reference BMCreateButton API Operation Field Description HostedButtonID xs:string ID of a PayPal-hosted button or a Hosted Solution token 3 BMCreateButton Errors Error Code Short Message Long Message 10001 Internal Error Internal Error 11923 Invalid Argument The button image value specified is invalid. 11924 Invalid Argument The button image URL specified is invalid. 11925 Invalid Argument The button type specified is invalid.
3 Button Manager API Reference BMUpdateButton API Operation Error Code Short Message Long Message 11938 Invalid Argument The button code value specified is invalid. 11940 Invalid Argument An option name specified is invalid. Option names must not exceed 64 characters. 11941 Invalid Argument An option selection value specified is invalid. Option selection values must not exceed 64 characters. 11942 Invalid Argument An option price value specified is invalid.
Button Manager API Reference BMUpdateButton API Operation 3 BMUpdateButton Request The hosted button ID identifies the button you want to modify. The remaining request fields specify the characteristics of your button.
3 Button Manager API Reference BMUpdateButton API Operation BMUpdateButton Request Fields Field Description HostedButtonID xs:string (Required) The ID of the hosted button you want to modify. ButtonType ebl:ButtonTypeType (Required) The kind of button you want to update.
Button Manager API Reference BMUpdateButton API Operation Field Description OptionDetails ns:OptionDetailsType (Optional) Menu items TextBox xs:string (Optional) Text description for a menu item It is a list of variables, in which n is a digit between 0 and 1, inclusive. ButtonImage ebl:ButtonImageType (Optional) The kind of button image.
3 Button Manager API Reference BMUpdateButton API Operation Field Description OptionSelectionDetails ns:OptionSelectionDetailsType (Optional) Menu items Option Selection Details Fields OptionSelection xs:string (Optional) The menu item’s name Price xs:string (Optional) The price associated with the first menu item N O TE : OptionType ebl:OptionTypeListType (Optional) The installment option type for an OPTIONnNAME, which is one of the following values: FULL - Payment in full VARIABLE - Variabl
Button Manager API Reference BMUpdateButton API Operation ShippingAmount xs:string (Optional) The shipping amount to bill for the cycle, in addition to the base amount. TaxAmount xs:string (Optional) The tax amount to bill for the cycle, in addition to the base amount. 3 Button Language Options The button language must be compatible with the country identified by the country code.
3 Button Manager API Reference BMUpdateButton API Operation Country Button Language Options Switzerland United States de - German; default fr - French en - English en - English; default fr - French es - Spanish zh - Chinese BMUpdateButton Response The response contains the hosted button ID, code for HTML in a website, and code for a link in email.
Button Manager API Reference BMUpdateButton API Operation Field Description HostedButtonID xs:string ID of a PayPal hosted button 3 BMUpdateButton Errors Error Code Short Message Long Message 10001 Internal Error Internal Error 11923 Invalid Argument The button image value specified is invalid. 11924 Invalid Argument The button image URL specified is invalid. 11925 Invalid Argument The button type specified is invalid.
3 Button Manager API Reference BMButtonSearch API Operation Error Code Short Message Long Message 11938 Invalid Argument The button code value specified is invalid. 11940 Invalid Argument An option name specified is invalid. Option names must not exceed 64 characters. 11941 Invalid Argument An option selection value specified is invalid. Option selection values must not exceed 64 characters. 11942 Invalid Argument An option price value specified is invalid.
Button Manager API Reference BMButtonSearch API Operation 3 BMButtonSearch Request The request contains optional fields that are not currently used. All hosted buttons are automatically requested. BMButtonSearch Request Fields Field Description StartDate xs:dateTime (Required) Starting date for the search. The value must be in UTC/GMT format; for example, 2009-08-24T05:38:48Z. No wildcards are allowed. EndDate xs:dateTime (Optional) Ending date for the search.
3 Button Manager API Reference BMButtonSearch API Operation BMButtonSearch Response The response contains a list of all hosted buttons and their associated characteristics.
Button Manager API Reference BMGetButtonDetails API Operation 3 BMButtonSearch Errors Error Code Short Message Long Message 10001 Internal Error Internal Error 11994 Search Warning You have exceeded the maximum number of buttons that can be returned. Please adjust your seach parameters if required. 11997 Invalid Argument A start date value must be specified. 11998 Invalid Argument The start date specified is invalid. 11999 Invalid Argument The end date specified is invalid.
3 Button Manager API Reference BMGetButtonDetails API Operation BMGetButtonDetails Request Fields Field Description HostedButtonID xs:string (Required) The ID of the hosted button whose details you want to obtain. BMGetButtonDetails Response The response fields contain all non-inventory information related to the button.
Button Manager API Reference BMGetButtonDetails API Operation 3 BMGetButtonDetails Response Fields Field Description ButtonType ebl:ButtonTypeType The kind of button. It is one of the following values: BUYNOW - Buy Now button CART - Add to Cart button GIFTCERTIFICATE - Gift Certificate button SUBSCRIBE - Subscribe button DONATE - Donate button UNSUBSCRIBE - Unsubscribe button VIEWCART - View Cart button PAYMENTPLAN - Installment Plan button; since version 63.
3 Button Manager API Reference BMGetButtonDetails API Operation Option Details Fields Field Description OptionName xs:string (Optional) The menu name OptionSelectionDetails ns:OptionSelectionDetailsType (Optional) Menu items Option Selection Details Fields OptionSelection xs:string (Optional) The menu item’s name Price xs:string (Optional) The price associated with the first menu item N O TE : OptionType ebl:OptionTypeListType (Optional) The installment option type for an OPTIONnNAME, which is
Button Manager API Reference BMManageButtonStatus API Operation TotalBillingCycles xs:int (Optional) The total number of billing cycles, regardless of the duration of a cycle; 1 is the default Amount xs:string (Optional) The base amount to bill for the cycle. ShippingAmount xs:string (Optional) The shipping amount to bill for the cycle, in addition to the base amount. TaxAmount xs:string (Optional) The tax amount to bill for the cycle, in addition to the base amount.
3 Button Manager API Reference BMManageButtonStatus API Operation BMManageButtonStatus Request Fields Field Description HostedButtonID xs:string (Required) The ID of the hosted button whose status you want to change. ButtonStatus ebl:ButtonStatusType (Required) The new status of the button. It is one of the following values: DELETE - the button is deleted from PayPal BMManageButtonStatus Response The response does not include any fields that are specific to the BMManageButtonStatus API operation.
Button Manager API Reference BMSetInventory API Operation Error Code Short Message Long Message 11992 Invalid Argument You do not have permissions to access this button. Please check the hosted button ID and try again. 11993 Invalid Argument The button status value specified is not valid. 3 Correcting This Error... BMSetInventory API Operation Use the BMSetInventory API operation to set the inventory level and inventory management features for the specified button.
3 Button Manager API Reference BMSetInventory API Operation BMSetInventory Request Fields Field Description HostedButtonID xs:string (Required) The ID of the hosted button whose inventory you want to set. TrackInv xs:string (Required) Whether to track inventory levels associated with the button. It is one of the following values: 0 - do not track inventory 1 - track inventory TrackPnl xs:string (Required) Whether to track the gross profit associated with inventory changes.
Button Manager API Reference BMSetInventory API Operation Field Description OptionIndex xs:string (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: 1 single-byte alphanumeric character SoldoutURL xs:string (Optional) The URL to which the buyer’s browser is redirected when the inventory drops to 0.
3 Button Manager API Reference BMSetInventory API Operation ItemQtyDelta xs:string The change in quantity you want to specify for the item associated with this button.
Button Manager API Reference BMSetInventory API Operation 3 BMSetInventory Response Fields Field Description TransactionID xs:string Transaction ID BMSetInventory Errors Error Code Short Message Long Message 10001 Internal Error Internal Error 11950 Invalid Data A hosted button ID must be specified. 11951 Invalid Argument The hosted button ID specified is invalid. 11951 Invalid Argument The hosted button ID specified is invalid.
3 48 Button Manager API Reference BMSetInventory API Operation Error Code Short Message Long Message 11958 Invalid Data You cannot specify both an ItemQty and ItemQtyDelta value. 11959 Invalid Data You cannot specify both an OptionQty and OptionQtyDelta value. 11960 Invalid Data You cannot specify item level or option level inventory when TrackInv is 0. 11961 Invalid Data You must either track inventory by item or by option when TrackInv is 1.
Button Manager API Reference BMSetInventory API Operation Error Code Short Message Long Message 11975 Invalid Data The number of option quantity or option quantity delta values specified is greater than the number of option selections in the saved button. 11976 Invalid Data You must specify either option quantity or option quantity delta values with a valid integer value. 11977 Invalid Data An option quantity or option quantity delta value must not be specified when TrackInv is 0.
3 Button Manager API Reference BMGetInventory API Operation BMGetInventory API Operation Use the BMGetInventory API operation to determine the inventory levels and other inventory-related information for a button and menu items associated with the button. Typically, you call BMGetInventory to obtain field values before calling BMSetInventory to change the inventory levels.
Button Manager API Reference BMGetInventory API Operation 3 BMGetInventory Response The response fields contain inventory information related to the button. BMGetInventory Response Fields Field Description HostedButtonID xs:string The ID of the hosted button whose inventory you want to set. TrackInv xs:string Whether to track inventory levels associated with the button.
3 Button Manager API Reference BMGetInventory API Operation Field Description TrackPnl xs:string Whether to track the gross profit associated with inventory changes. It is one of the following values: 0 - do not track the gross profit 1 - track the gross profit N O TE : The gross profit is calculated as the price of the item less its cost, multiplied by the change in the inventory level since the last call to BMSetInventory.
Button Manager API Reference BMGetInventory API Operation 3 Option Tracking Details Fields OptionNumber xs:string The menu item’s ID for an option in a dropdown menu OptionQty xs:string The current inventory level of the option associated with this menu item OptionSelect xs:string The menu item’s name in a dropdown menu OptionQtyDelta xs:string Not used OptionAlert xs:string The quantity of the option associated with this menu item below which PayPal sends you an email notification OptionCost x
3 54 Button Manager API Reference BMGetInventory API Operation April 2012 Button Manager SOAP API
A HTML Variables for PayPal Payments Standard You can use all variables supported for your button: Buy Now, Donation, Subscribe, Add to Cart, and View Cart buttons. You can also use HTML variables supported the Cart Upload command. Technical HTML Variables Technical HTML variables control how PayPal responds technically when people click PayPal Payments Standard payment buttons or when third-party or custom carts initiate payment processing with the Cart Upload command.
A HTML Variables for PayPal Payments Standard Technical HTML Variables HTML Variables for Special PayPal Features Name Required or Optional notify_url Optional The URL to which PayPal posts information about the payment, in the form of Instant Payment Notification messages. 255 hosted_button_i d See description. Required for buttons that have been saved in PayPal accounts; otherwise, not allowed. The identifier of a button that was saved in a merchant’s PayPal account.
HTML Variables for PayPal Payments Standard HTML Variables for Individual Items A HTML Variables for Individual Items HTML variables for individual items specify information about a product or service for Buy Now and Add to Cart buttons, or they specify information about a contribution for Donate buttons. HTML Variables for Individual Items Name Required or Optional Description amount See description.
A HTML Variables for PayPal Payments Standard HTML Variables for Individual Items Name Required or Optional discount_num Optional Number of additional quantities of the item to which the discount applies. Applicable when you use discount_amount2 or discount_rate2. Use this variable to specify an upper limit on the number of discounted items. Valid only for Buy Now and Add to Cart buttons. item_name See description. Description of item.
HTML Variables for PayPal Payments Standard HTML Variables for Individual Items Name Required or Optional tax Optional Transaction-based tax override variable. Set this variable to a flat tax amount to apply to the payment regardless of the buyer’s location. This value overrides any tax settings set in your account profile. Valid only for Buy Now and Add to Cart buttons. Default – Profile tax settings, if any, apply. tax_rate Optional Transaction-based tax override variable.
A HTML Variables for PayPal Payments Standard HTML Variables for Individual Items Name Required or Optional os0 Optional Character Length Description Option selection of the buyer for the first option field, on0. If the option field is a dropdown menu or a set of radio buttons, each allowable value should be no more than 64 characters. If buyers enter this value in a text field, there is a 200character limit. NOT E : See description. The option field on0 must also be defined.
HTML Variables for PayPal Payments Standard HTML Variables for Individual Items Name option_index Required or Optional See description. Description A Character Length The cardinal number of the option field, on0 through on9, that has product options with different prices for each option. Include option_index if the option field with prices is not on0.
A HTML Variables for PayPal Payments Standard HTML Variables for Payment Transactions Name Required or Optional option_select1 Optional Character Length Description For priced options, the value of the second option selection of the on0 dropdown menu. For example: 64 ... ...
HTML Variables for PayPal Payments Standard HTML Variables for Shopping Carts A HTML Variables for Payment Transactions Required or Optional Name Description Character Length address_ override Optional 1 – The address specified with automatic fill-in variables overrides the PayPal member’s stored address. Buyers see the addresses that you pass in, but they cannot edit them. PayPal does not show addresses if they are invalid or omitted. 1 currency_code Optional The currency of the payment.
A HTML Variables for PayPal Payments Standard HTML Variables for Shopping Carts HTML Variables for Shopping Carts Name add Required or Optional Description See description. Add an item to the PayPal Shopping Cart. This variable must be set as follows: Character Length 1 add="1" The alternative is the display="1" variable, which displays the contents of the PayPal Shopping Cart to the buyer. If both add and display are specified, display takes precedence.
HTML Variables for PayPal Payments Standard HTML Variables for Recurring Payments Buttons Name Required or Optional handling_ cart Optional Single handling fee charged cart-wide. If handling_cart is used in multiple Add to Cart buttons, the handling_cart value of the first item is used. item_name_x Required The name associated with item x. To pass an aggregate name for the entire cart, use item_name_1. Applies only to the Cart Upload command.
A HTML Variables for PayPal Payments Standard HTML Variables for Recurring Payments Buttons Installment Plan buttons HTML variables for recurring payments buttons set terms for different kinds of PayPal automatic payment plans. Subscribe Button HTML Variables 66 Name Required or Optional business Required Your PayPal ID or an email address associated with your PayPal account. Email addresses must be confirmed. item_name Optional Description of item being sold.
HTML Variables for PayPal Payments Standard HTML Variables for Recurring Payments Buttons Name Required or Optional t3 Required Regular subscription units of duration. Allowable values are: D – for days; allowable range for p3 is 1 to 90 W – for weeks; allowable range for p3 is 1 to 52 M – for months; allowable range for p3 is 1 to 24 Y – for years; allowable range for p3 is 1 to 5 1 src Optional Recurring payments.
A HTML Variables for PayPal Payments Standard HTML Variables for Recurring Payments Buttons Name Required or Optional modify Optional Character Length Description Modification behavior. Allowable values are: 0 – allows subscribers only to sign up for new subscriptions 1 – allows subscribers to sign up for new subscriptions and modify their current subscriptions 2 – allows subscribers to modify only their current subscriptions 1 The default value is 0.
HTML Variables for PayPal Payments Standard HTML Variables for Recurring Payments Buttons A Installment Plan Buttons HTML Variables Name Required or Optional disp_tot Optional Description Display the total payment amount to buyers during checkout Allowable values are: Y – display the total N – do not display the total Character Length 1 The default is N.
A HTML Variables for PayPal Payments Standard HTML Variables for Recurring Payments Buttons Name 70 Required or Optional Character Length Description option_selectn_ type Required Whether the single plan or plan option n offered by the button is paid in full, in equal periods, or in variable periods Allowable values are: F – pay in full, at checkout E – pay in equal periods, beginning at checkout or sometime later V – pay in variable periods, beginning at checkout option_selectn_ am Require
HTML Variables for PayPal Payments Standard HTML Variables for Displaying PayPal Checkout Pages A H T M L Va r i a b l e s f o r D i s p l a y i n g P a y P a l C h e c k o u t P a g e s HTML variables for displaying PayPal checkout pages control how the pages appear and function. HTML Variables for Displaying PayPal Checkout Pages Name Required or Optional page_style Optional Description The custom payment page style for checkout pages.
A HTML Variables for PayPal Payments Standard HTML Variables for Displaying PayPal Checkout Pages Name Required or Optional Character Length Description cpp_ headerback_ color Optional The background color for the header of the checkout page. Valid value is case-insensitive six-character, HTML hexadecimal color code in ASCII. Deprecated for Buy Now and Add to Cart buttons and the Cart Upload command. 6 cpp_ headerborder_co lor Optional The border color around the header of the checkout page.
HTML Variables for PayPal Payments Standard HTML Variables for Displaying PayPal Checkout Pages Name Required or Optional no_note Optional Description Do not prompt buyers to include a note with their payments. Allowable values are: 0 – provide a text box and prompt for the note 1 – hide the text box and the prompt A Character Length 1 The default is 0. cn Optional Label that appears above the note field. This value is not saved and does not appear in any of your notifications.
A HTML Variables for PayPal Payments Standard HTML Variables for Filling Out PayPal Checkout Pages Automatically Name Required or Optional cbt Optional Sets the text for the Return to Merchant button on the PayPal Payment Complete page. For Business accounts, the return button displays your business name in place of the word “Merchant” by default. For Donate buttons, the text reads “Return to donations coordinator” by default.
HTML Variables for PayPal Payments Standard HTML Variables for the Instant Update API Name Required or Optional lc Optional Sets the language for the billing information/log-in page only. The default is US. charset Optional Sets the character set and character encoding for the billing information/log-in page on the PayPal website. In addition, this variable sets the same values for information that you send to PayPal in your HTML button code.
A HTML Variables for PayPal Payments Standard HTML Variables for the Instant Update API HTML Variables to Set Up an Instant Update Payment Name Required or Optional Description Character Length callback_url Required The URL of your Instant Update callback server 1024 callback_timeou t Required The timeout in seconds for callback responses from your Instant Update callback server.
HTML Variables for PayPal Payments Standard HTML Variables for the Instant Update API Required or Optional Name Description fallback_insura nce_option_offe red Optional Indicates that insurance is offered. PayPal ignores this HTML variable if fallback_insurance_amount is omitted or the value is 0 or less. Allowable values are: 1 – insurance is offered 0 – insurance is not offered fallback_insura nce_amount Optional Insurance amount to use as a fallback, if the callback response times out.
A 78 HTML Variables for PayPal Payments Standard HTML Variables for the Instant Update API Name Required or Optional length_unit Optional Character Length Description Unit of measure for the value specified by length_x Allowable values are any values that you choose to provide. PayPal passes the value to your callback server in callback requests.
