Button Manager


Use the Button Manager APIs to dynamically create, manage, and edit large numbers of PayPal Payments Standard buttons. You can use the Button Manager API to manage any button you can create in your PayPal Profile.

The Button Manager API is available in any country where PayPal is accepted.

How it works

The Button Manager API enables developers to create and update PayPal buttons without editing HTML code. You can manipulate the buttons using name-value pairs (NVP) in your API code just like you would change the values using PayPal Payments Standard.

Why use Button Manager API

If you must create or manage a large number of PayPal Payment Standard buttons, or if you manage buttons for third parties (like a shopping cart for several merchants), consider using the Button Manager API. The Button Manager API is available for both NVP and SOAP. Use the Button Manager API to create these types of buttons:

Button type Storage location Encrypted? Use cases and notes
Hosted buttons On PayPal Yes You can programmatically update hosted buttons to, for example, change a value like the price or color.
Use Hosted buttons to:
Track inventory and notify buyers of inventory status.
Track profit and loss.
Encrypted buttons Not on PayPal Yes You can change the value of an encrypted button by modifying the web page hosting the button.
Clear text buttons Not on PayPal No You can change the value of a clear text button by changing a parameter value.
Important: Clear text buttons cannot be encrypted and must be used with care.
Token buttons Not on PayPal Yes You can use token buttons to initiate the Website Payments Pro Hosted Solution checkout flow.
Note: If you create a token button but don't use it, it expires after approximately two hours.

How to get started

The following is a brief overview of how to get started by using the Button Manager API.

Note: You must have a PayPal business account to use the Button Manager APIs.

  1. Verify your API settings:

    • Click your profile name in the top right corner of your account and then click Account Settings.

      Click My selling tools.

      Note: If you do not see the profile icon on the top right, navigate to My Account > Profile > My Selling Tools.

    • Under the My business setup section, click the Update link on the right side of the API access row.
  2. Decide whether you want PayPal to host your buttons or if you want to encrypt and dynamically create them using your API.
  3. You can use the PayPal Button Manager API to dynamically create and manage the following Website Payment Standard buttons:

    • Buy Now
    • Add to Cart and View Cart
    • Donate
    • Subscribe and Unsubscribe
    • Automatic Billing
  4. Choose your buttons and determine the values (price, size, color, etc.) for each button. Choose how you will define the buttons, either NVP or SOAP. Then develop the API code necessary to create and manage your buttons.
  5. Test your integration using the PayPal sandbox, as described in PayPal sandbox Testing Guide.

Once you've verified that your implementation works correctly in the sandbox, you are ready to go live.

U.S. fees

There are no setup costs, credit application fees, gateway fees, downgrade penalties, cancellation charges, or monthly fees. Transaction fees are calculated as follows.

Standard Rate Merchant Rate
The standard rate for receiving payments for goods and services is 2.9%. For more information, see PayPal's Merchant Fees. For details on the meanings of these codes, see AVS, CVV2, and payment advice response codes.

If your transactions typically average less than $10.00, you could save money with our "5% plus 5¢" rate. For more information, see MicroPayment Discounts on the PayPal Merchant Fees page.

International availability and fees

You can use Button Manager API in any country where PayPal is accepted. In some countries, certain types of buttons are not available because of legal restrictions. In Germany, for example, you can create a Subscribe button using the Button Manager API, but it is not functional. You can hold multiple currency balances in your PayPal account or convert payments you receive at competitive rates. Currency conversion and cross-border fees may apply. For information, see PayPal Merchant Fees.

Developer support

For answers to PayPal frequently asked questions, go to our Help Center. For more help, visit our Merchant Technical Services.  to discuss issues and share ideas, visit the PayPal stackoverflow forum.

Additional information

Guides and SDK

API references