User Guide

HTML Variables for PayPal Payments Standard
Technical HTML Variables
A
52 April 2012 Button Manager NVP API
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
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. PayPal assigns the value when payment
buttons are first created and saved in 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 buyer 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:
 BuyNow
 AddToCart
 Donate
 Subscribe
 AutomaticBilling
 InstallmentPlan
 BuyGiftCertifcate
 ShoppingCart
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 codes 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
generated by PayPal.