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 allows 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 need to 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), you should consider using the Button Manager API. The Button Manager API is available using both NVP and SOAP.
Using the Button Manager API allows you to create 4 kinds of buttons.

Button type Storage location Encrypted? Use cases and notes

Hosted buttons

Stored on PayPal


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 stored on PayPal


You can change the value of an encrypted button by modifying the web page hosting the button.

Clear text buttons

Not stored on PayPal


You can change the value of a clear text button by changing a parameter value.
Caution: Clear text buttons cannot be encrypted and must be used with care.

Token buttons

Not stored on PayPal


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 2 hours.

How to get started

  1. Verify your account status. Go to your PayPal Profile under My settings and verify that your Account Type is Business, or upgrade your account.
  2. Verify your API settings. Click on My selling tools. Click Selling online and verify your API access. Click Update to view or set up your API signature and credentials.
  3. Decide whether you want PayPal to host your buttons or if you want to encrypt and dynamically create them using your API.
  4. 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
    • Buy Gift Certificate
    • Subscribe and Unsubscribe
    • Installment Plan
    • Automatic Billing
  5. 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.
  6. Test your integration using the PayPal Sandbox, as described in Testing NVP/SOAP API Calls.

Once you've verified that your implementation works correctly in the Sandbox, you are ready to go live. For complete details, refer to the documentation.

U.S. fees

There are no set-up 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 details, see PayPal's standard fee structure.

If your sales volume exceeds USD $3,000.00/month, your rate can be as low as 1.9%. For details, see PayPal Merchant Services.

If your transactions typically average less than $10.00, you could save money with our "5% plus 5¢" rate.  For information, see the MicroPayment Discounts in the Complete Payment Solutions section of the PayPal Merchant fees; expand View All Discounts & Fees.

International availability and fees

You can use Button Manager API in any country where PayPal is accepted. In some countries, certain kinds 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 Transaction Fees for Cross-border Payments.

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.

Related Information

Guides and SDK

API References

Forums to Follow

scroll to top