PayPal Checkout Buttons

PayPal Classic

Supported Features:

Add PayPal Classic to your payments ecosystem

Before we start activation, please ensure you understand that "PayPal Classic" is not the exact same service as "PayPal" and that you know what you are integrating. Email us at for questions. 

To connect PayPal Classic to PayDock, you will need to:
  • Register a PayPal business account. (If you don't have one register hereAfter applying for a business account you will need to track your application and then need to get API credentials in your PayPal profile settings.)
  • Ensure reference payments are enabled. If you are unsure about what this is, please send us an email to the PayDock team at

Step 1: Gather your credentials from PayPal

  1. Go through the PayPal Wizard > Select "On your website" 

    2. Select "PayPal Checkout"

   3. Go  here to gather your API Username, API Password, and Signature. Click "Show" to reveal your keys.

Step 2: Connect PayPal Classic to your Paydock Account

  1. Log into your PayDock Production or Sandbox account.
  2. Navigate to "Services" from the menu on the left
  3. Click on the "Add New" tab from the top of the page
  4. Navigate to or search "PayPal Classic" and click on the "Activate" button
  5. Complete the field descriptions to connect. Field descriptions are as follows:
  6. Label – this is for your reference only. In PayDock, you are able to add multiple instances of a payment gateway or method. This can be helpful for tracking campaigns or income streams.
  7. Client ID – this is your PayPal API Username.
  8. Secret Key – this is your PayPal API Password.
  9. Signature - this is your PayPal Signature
  10. Environment Mode – this describes whether you are connecting to a PayPal Production or Sandbox Environment. Production is used for processing real transactions. Sandbox is used for testing purposes. Please ensure you’re using the correct credentials for the type of environment required.
  11. Configure your PayPal Checkout Button using our docs
  12. Click Connect. You have successfully connected PayPal Classic to PayDock 

PayPal Smart Button

With PayPal Checkout’s Smart Buttons, Merchants are able to enjoy a simplified and secure checkout experience. This feature intelligently tailors the needs of your customers by automatically presenting their preferred payment types, making it easier and efficient to complete their purchases.  

To create a gateway connection for the Smart Payment Button, you will need to connect the PayPal gateway to your Paydock account. Note: PayPal and PayPal Classic are not the same services. To add PayPal to your services, please refer to this article

Please see below the workflow for the Smart Payment Button:

  1. Generate a token that should be pasted into the widget using the {{url}}/v1/charges/wallet endpoint. With the help of this token, it is possible to make a payment with the PayPal Smart Button. 
  2. Use our widget to add PayPal Smart Buttons to your website.
  3. Your client clicks the PayPal Smart Payment button.
  4. The button launches the PayPal Checkout experience.
  5. The client logs into their PayPal account, modifies the charge details if needed and approves the created charge.
  6. It can be possible to modify the amount and shipping_amount parameters using the {{url}}/v1/charges/:id endpoint. This update can be applied if parameters were changed during checkout.
  7. Your website displays a confirmation to your client. 
  8. Success! The charge is completely done.

The PayPal Smart Button can be added to the website via the Client SDK package. To find out how this can be integrated into your website, click here in the wallet-buttons-examples section.

Note: For merchants who are using PayPal Classic, Paydock will soon deprecate PayPal Classic as this is outdated and not maintained by PayPal. We suggest switching to the PayPal Smart Payment Button option as this has broader opportunities. 

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us