On this page
No Headings
Last updated: June 10, 2026
Shows information about a hosted PayPal Payments Standard button.
Important:
The Button Manager API is deprecated. For new integrations, see the associated topic.
| Button | See |
|---|---|
| Buy Now | PayPal Checkout Overview |
| Add to Cart | Solution Providers |
| Donate | Create a Donate button |
| Automatic Billing Subscribe | Subscriptions Overview |
You can use this information to set the fields that have not changed when updating a button.
The request includes only the ID of the hosted button whose details you want to obtain.
| Field | Description |
|---|---|
METHOD | (Required) BMGetButtonDetails |
HOSTEDBUTTONID | (Required) The ID of the hosted button whose details you want to obtain. |
The response fields contain all non-inventory information related to the button.
| Field | Description |
|---|---|
BUTTONTYPE | The kind of button. Value is:
|
BUTTONCODE | The kind of button code. Value is:
|
BUTTONSUBTYPE | The use of button. Value is:
|
HOSTEDBUTTONID | ID of a PayPal-hosted button. |
WEBSITECODE | HTML code for web pages |
EMAILLINK | Code for email links and links in other documents that support external links |
L_BUTTONVARn | HTML standard button variables |
| Field | Description |
|---|---|
OPTIONnNAME | (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. |
| Field | Description |
|---|---|
L_OPTIONnSELECTx | (Optional) The menu item's name It is a list of variables for each OPTIONnNAME, in which x is a digit between 0 and 9, inclusive |
L_OPTION0PRICEx | (Optional) The price associated with the first menu item. It is a list of variables for each OPTION0NAME, in which x is a digit between 0 and 9, inclusive Note: If you specify a price, you cannot set a button variable to amount. |
| Error code | Short and long messages | User action |
|---|---|---|
| 10001 | Internal Error Internal Error | To learn more about possible causes and corrective actions, see What is API error code 10001?. |
| 11950 | Invalid Data A hosted button ID must be specified. | |
| 11951 | Invalid Argument The hosted button ID specified is invalid. | |
| 11951 | Operation Refused Operation not supported for Sample Buttons. | |
| 11992 | Invalid Argument You do not have permissions to access this button. Verify the hosted button ID and try the request again. |