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. Using the Button Manager API enables you to create four types of buttons.

Button type Storage location Encrypted? Use cases and notes
Hosted buttons Stored 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 stored on PayPal Yes You can change the value of an encrypted button by modifying the web page hosting the button.
Clear text buttons Not stored 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 stored 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 using the Button Manager API.

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

  1. Verify your API settings:

    • Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings, then select 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
    • Buy Gift Certificate (Note: The Gift Certificate button is discontinued as of February 1, 2017.)
    • Subscribe and Unsubscribe
    • Installment Plan
    • 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 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 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 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.

Additional information

Guides and SDK

API references