Technical HTML Variables
Technical HTML variables control how PayPal responds technically when people click Buy Now, Donation, Subscribe, Add to Cart, and View Cart buttons or when third party or custom carts initiate payment processing with the Cart Upload command. They also control how your buttons interact with special PayPal features.
Table 1. Allowable Values for the cmd HTML Variable
Value of cmd | Description |
_xclick | The button that the person clicked was a Buy Now button. |
_donations | The button that the person clicked was a Donate button. |
_xclick-subscriptions | The button that the person clicked was a Subscribe button. |
_oe-gift-certificate | The button that the person clicked was a Buy Gift Certificate button. |
_cart | For shopping cart purchases; these additional variables specify the kind of shopping cart button that the person clicked:
|
_s-xclick | The button that the person clicked was protected from tampering by using encryption, or the button was saved in the merchant's PayPal account. PayPal determines which kind of button was clicked by decoding the encrypted code or by looking up the saved button in the merchant's account. |
Table 2. HTML Variables for Special PayPal Features
Name | Required or Optional | Description | Character Length |
notify_url | Optional | The URL to which PayPal posts information about the transaction, in the form of Instant Payment Notification messages. | 255 |
hosted_button_id | 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. Allowable values are assigned by PayPal when payments buttons are first created and saved merchants' PayPal accounts. Note: A merchant's PayPal account can have a maximum of 1,000 saved payment buttons. | See description. |
bn | Optional | An identifier of the source that built the code for the button that the payer clicked, sometimes known as the build notation. Specify a value using the following format: <Company>_<Service>_<Product>_<Country> Substitute <Service> with an appropriate value from the following list:
Substitute <Product> with WPS always for Website Payments Standard payment buttons and for the Website Payments Standard Cart Upload command. Substitute <Country> with an appropriate two-letter country code from those defined by the ISO 3166-1 standard. For example, a Buy Now button on your website that you coded yourself might have the following line of code: bn="DesignerFotos_BuyNow_WPS_US" Note: HTML button code that you create on the PayPal website includes bn variables with valid values only for PayPal-generated buttons. |