Overview


PayPal Checkout v2 payment option gives your buyers a simplified checkout experience that keeps them local to your website or mobile app throughout the payment authorization process and lets them use their PayPal balance, bank account, or credit card to pay without sharing or entering any sensitive information on your site.

HostBill supports PayPal Checkout v2 payment gateway for collecting payments out of the box.

Activating the module


In order to activate the module login to your HostBill admin panel, go to Settings → Modules → Payment Modules, choose PayPal Checkout v2 gateway and click Activate.  

Module configuration


Once the payment gateway is activated you need to configure it. 
Please see external articles on how to setup:

Then proceed to filling in all other configuration fields:

Styling of checkout button:

  1. Button layout
  2. Button color
  3. Button size
  4. Button shape
  5. Button label
  6. Locale

Remaining configuration options:

  1. Disable subscriptions - when enabled no "subscribe" button will appear
  2. Disable Pay now - when enabled and subscription is possible, no "Pay now" button will appear
  3. Terminate subscriptions - Cancels client subscription if his account is terminated
  4. Sandbox mode - When enabled sandbox APi mode will be used
  5. Client id - obtained from paypal developer console - described below
  6. Client secret - obtained from paypal developer console - described below

All required information can be obtained once you login to your PayPal Dashboard panel.

To get your Client ID and App secret

  1. Login to your PayPal account
  2. Navigate to DeveloperMy Account → My Apps & Credentials  
  3. Scroll down to REST API Apps and click the name of your app to see the app's details. If you don't have any apps, create one.
    1. Copy: Client ID
    2. Copy: Secret

Click the Sandbox / Live toggle to display and copy the "client ID" and "App secret" for each environment.


The next step is to create a webhook.

To create the webhook, proceed to your App details (created in previous step in PayPal Developer dashboard).

  1. Go to My Apps & Credentials.

  2. In the REST API apps section, click the link for the app to which you want to create a webhook.

  3. In the WEBHOOKS section, click Add Webhook.

  4. Add the URL for your webhook, which is the callback URL from HostBill PayPal Checkout v2 module.

  5. From the event types list, select:

    1. Checkout order approved
    2. Billing subscription cancelled
    3. Billing subscription expired
    4. Payment capture completed
    5. Payment capture denied
    6. Payment capture declined
    7. Payment sale completed
    8. Payment sale denied
    9. Payment sale pending
    10. Payment sale refunded
    11. Payment sale reversed
  6. Click Save 

  7. Copy newly created webhook id - set it in HostBIll module configuration


FAQ


Question: I've enabled the module but it does not display in my client portal.
Answer: This module does not support the currency you attempt to display it in, please use background currency conversion.