User Guide

Button Manager API Reference
BMCreateButton API Operation
3
24 April 2012 Button Manager NVP API
BMCreateButton Request Fields
Option Details Fields
Field Description
METHOD (Required) BMCreateButton
BUTTONCODE (Optional) The kind of button code to create. It is one of the following values:
 HOSTED - A secure button stored on PayPal; default for all buttons except
View Cart, Unsubscribe, and Pay Now
 ENCRYPTED - An encrypted button, not stored on PayPal; default for View
Cart button
 CLEARTEXT - An unencrypted button, not stored on PayPal; default for
Unsubscribe button
 TOKEN - A secure button, not stored on PayPal, used only to initiate the
Hosted Solution checkout flow; default for Pay Now button. Since version
65.1
BUTTONTYPE (Required) The kind of button you want to create. 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.0
 AUTOBILLING - Automatic Billing button; since version 63.0
 PAYMENT - Pay Now button; since version 65.1
NOTE: Do not specify BUYNOW if BUTTONCODE=TOKEN; specify PAYMENT
instead. Do not specify PAYMENT if BUTTONCODE=HOSTED.
BUTTONSUBTYPE (Optional) The use of button you want to create. It is one of the following
values:
 PRODUCTS - button is used to purchase products; default for Buy Now and
Add to Cart buttons
 SERVICES - button is used to purchase services
L_BUTTONVAR
n (Optional) HTML standard button variables
Field Description
OPTION
nNAME (Optional) The menu name
It is one or more variables, in which
n is a digit between 0 and 4, inclusive, for
hosted buttons; otherwise, it is a digit between 0 and 9, inclusive.