PayPal Checkout Buttons

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 here. After 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 or how to do it, please send email us at;

Step 1: Look up your PayPal credentials

  1. Go to the PayPal Wizard and select "On your website"; 
  2. Select PayPal Checkout
  3. Go here to find your API Username, API Password, and Signature. Click Show to reveal each key.

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 required fields to connect:
    1. Label - Specify the name by which you will recognize this service later. This is just for your reference. In Paydock, you can add multiple instances of a service, which can be helpful for tracking campaigns or income streams.
    2. Client ID - This is your PayPal API Username.
    3. Secret Key - This is your PayPal API Password.
    4. Signature - This is your PayPal Signature
    5. Select 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 you're using.
  6. Configure your PayPal Checkout Button using the Paydock APU docs;
  7. Click Connect. You have successfully connected PayPal Classic to Paydock!

PayPal Smart Button

With PayPal Checkout’s Smart Buttons, Merchants can 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 more efficient to complete their purchases.

To create a gateway connection for the Smart Payment Button, you will need to connect your 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

Follow the workflow below (also displayed in the chart at the end of the flow) to add the Smart Payment Button:

  1. Generate a token and paste into the widget using the {{url}}/v1/charges/wallet endpoint. This token is what enables payments via the PayPal Smart Button.
  2. Use our widget to add PayPal Smart Buttons to your website.
  3. Your customer clicks the PayPal Smart Payment button.
  4. The button launches the PayPal Checkout experience.
  5. Your customer logs into their PayPal account, modifies the charge details, if needed, and approves the charge.
  6. You can 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 customer.
  8. Success! The charge has been completed.

You can also add the PayPal Smart Button to your website with the Client SDK package. For instructions on how to do this, go to our Client SDK documentation in the wallet-buttons-examples section.

You can also watch a detailed overview of the PayPal Smart Button in this video:

Note: For merchants using PayPal Classic, Paydock will soon deprecate PayPal Classic as it is no longer maintained by PayPal. We suggest switching to the PayPal Smart Payment Button option to continue taking advantage of PayPal checkout options.

Fraud Service Flow for PayPal Smart Buttons

To use fraud verification with the PayPal Smart Button, you will need to add the Accertify fraud service to your Paydock account. The service can be connected in passive or active mode:

  • If set in passive mode, the fraud check will be processed, but with no impact on the payment flow (i.e. the transaction will be processed regardless of the outcome). The actual result can be checked on the Paydock Dashboard;
  • If set in active mode, the fraud check will impact the payment flow and block transactions identified as fraudulent. For more information, please see our Accertify help document.

Here are the flow steps for working with the fraud service:

  1. Initialize the wallet by providing a fraud payload. To do this, refer to these instructions. After initializing the wallet, all fraud data will be included in the token from the response.
  2. Initialize PayPal Smart Buttons using the Client SDK and previously generated token.
  3. Press the Pay Now button once the widget is launched and all the required fields are filled in. The fraud check will be executed before an authorization or sale transaction (depending on how the charge was initialized in the first wallet request).
  4. If Accertify is set to active, there are 3 possible responses:
    1. ACCEPT - The transaction will follow the standard fraud flow and will be either AUTHORIZED or COMPLETED.
    2. REJECT - The transaction will fail and the authorization or sale won’t be completed by PayPal.
    3. REVIEW - The transaction will be set to In_Review status and the authorization or sale won't be completed until PayPal completes it’s review, which usually takes a few days.
  5. If Accertify is set to passive, the service checks will be performed. However, this will not block the payment flow. Fraud check response will be displayed in the Paydock Dashboard.

Note: In the case of a REVIEW response, you can continue the fraud flow. PayPal orders have a validity window of 72 hours. This means that you have 72 hours to continue the Smart Payment Button workflow if you would like. Otherwise, the transaction will fail.

You are also able to process or decline the transaction with the fraud service manually by using the corresponding API calls.

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