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 using the Button Manager API.
Note: You must have a PayPal business account in order to use the Button Manager APIs.
Verify your API settings:
Click the settings icon at the top of your PayPal account page and then click Profile and 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.
Decide whether you want PayPal to host your buttons or if you want to encrypt and dynamically create them using your API.
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
- Subscribe and Unsubscribe
- Installment Plan
- Automatic Billing
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.
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.
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.
Guides and SDK
- PayPal Payments Standard Button Manager Getting Started Guide
- Button Manager Integration Guide
- You can download the Button Manager SDK. For information about the SDKs, see NVP/SOAP API SDKs.
- To discuss issues and share ideas, visit the PayPal stackoverflow forum.