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 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, 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:
    1. 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.
    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 required.
  6. Configure your PayPal Checkout Button using our docs;
  7. 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. 

Fraud Service Flow for PayPal Smart Buttons

To get started with fraud verification when using the PayPal Smart Button, it is necessary to add the Accertify fraud service to your Paydock account. The service can be connected in passive or active mode:

  • If the passive mode is set during the service creation, the fraud check will be processed; however, it will have no impact on the payment flow. The actual result can be checked on the Paydock Dashboard;
  • If the active mode is set, the fraud check will impact the payment flow. 

How the fraud service works with PayPal Smart Buttons

You can find the flow steps on how to work with the fraud service below:

  1. Initialize wallet by providing a fraud payload. In this case, feel free to 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 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 the Accertify mode is active, there can be 3 possible responses:
    4.1 ACCEPT - the transaction will follow the standard fraud flow and will be either AUTHORIZED or COMPLETED;
    4.2 REJECT - the transaction will fail and the authorization or sale won’t be performed on the PayPal side;
    4.3 REVIEW - the transaction will be set to In_Review status and the authorization or sale won't be performed until PayPal completes it’s review, usually within a few days. 
  5. If the Accertify mode is passive, the service checks will be performed; however, this will not block the payment flow. Fraud check response will be displayed at Paydock Dashboard.

Note: In the case of the 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