On this page

PayPal Express Checkout and Reference Transactions

*IMPORTANT NOTE!  The PayPal Express Checkout integration uses the "Reference Transactions" mechanism of your PayPal account. Approval from PayPal is required to enable reference transactions for your live account.

The process for enabling reference transactions by PayPal can take some time since the request goes through a vetting (underwriting) process.

You can work with a PayPal account manager and/or call one of the following numbers to request the reference transactions feature be enabled in your live (production) PayPal account:

US/CA: 1-888-221-1161
UK: 08707 307 191 or 0800 358 7911
Australia: 1-800-073-263
Germany: 0180 500 66 27
Other: 1-402-935-2080

You must have admin permissions of your PayPal account to perform these steps. Merchant Technical Support will not enable reference transactions, you must contact PayPal Customer Support to enable this feature.

IF YOU DO NOT COMPLETE THIS STEP, THE PAYPAL EXPRESS CHECKOUT INTEGRATION FOR OCU WILL NOT WORK!

The OCU integration for PayPal Express Checkout will work to add the "PayPal" button to the first step of the OCU app's checkout page:

Note:  You need to already have PayPal Express Checkout enabled in your Shopify store first. This can be added at the Settings > Payments section of your Shopify admin.

Connecting PayPal Express Checkout

1. Login to your PayPal Business account at www.PayPal.com

2. Click "Profile" in the top-right corner -> Profile and settings

3. Click "My selling tools" from the left-side menu -> Click the "Update" link for the API access.

4. Click the "View API Signature" link in the NVP/SOAP API integration section to get your credentials.

5. Click the "Show" link next to the API credentials that you want to use and copy them from there.

There are 2 possible ways to connect PayPal Express Checkout:

  • Using Signature API credentials
  • Using Certificate API

Connect PayPal using your Signature API credentials: 

Copy and paste the API Signature information into the PayPal Express Checkout tab in the Payments > PayPal Express Checkout section of the OneClickUpsell app. 

  • API Username
  • API Password
  • API Signature
  • Set "Mode" to "Live"
  • Click the "Enabled" switch to the "On" position
  • Click on the "Save" button to store settings

Connect PayPal using an API certificate: 

Copy and paste the API Certificate information into the PayPal Express Checkout tab in the Payments > PayPal Express Checkout section of the OneClickUpsell app:

  • API Username
  • API Password
  • Download your API Certificate from your PayPal account
  • Choose the "API Certificate" method
  • Click the "Choose File" button and select your certificate file from your computer
  • Set "Mode" to "Live"
  • Click the "Enabled" switch to the "On" position
  • Click on the "Save" button to store setting

Supported Card Types = Visa, MasterCard, American Express, Discover

NOTE: If you you receive a "Security header not valid" error message... 

  1. Check to make sure that there are no extra spaces in the API credentials you enter.
  2. Check that you are using the API username and password and not your PayPal account username and password.

Hide the "PayPal" button on the OCU checkout:

The PayPal button can be hidden from the first step of the OCU checkout using this setting. You may want to do that if you're doing a Free + Shipping model for example. Or if you think your customer demographic would prefer not having the PayPal button there. If you'd like to hide the PayPal button from the first step of OCU checkout, just click the switch to the "On" position and "Save". 

*Note: If you enable this setting, PayPal will still be an available option at the "Payment Method" step of checkout which is the last step. 

Display only certain credit card Logos on the OCU checkout:

By default, all credit card logos are shown. You can choose specifically which credit card logos you want shown in-case your store only accepts certain ones through PayPal. 

This section allows you to check/uncheck the supported credit card icons you want shown on the PayPal section of the checkout page after the customer signs in to PayPal and is redirected back to Checkout to complete their order. 

Just make your selections and click "Save".

Important Technical Notes:

1. Refunds for OCU orders is a two-step process. You will have to process any refunds in your PayPal account first (to refund the $ to the customer) then in the Shopify Orders section (to make the reporting/inventory accurate). Click here for the information on processing refunds correctly.

2. If your theme has the PayPal button on the Cart page of your store and you customer clicks the button there, the OCU checkout will not be used even if you've enabled our integration. 

To hide the PayPal button from the Cart page you can either use an app from the Shopify app store, or do it manually. To do this manually, within your Shopify admin go to Online Store > Themes > Actions > Edit Code > and Open the cart.liquid  file

Find this code and comment it out:

{% if additional_checkout_buttons %} 
<div class="additional-checkout-buttons">
{{ content_for_additional_checkout_buttons }}
</div>
{% endif %}

The final result will look like this:

{%comment%}
{% if additional_checkout_buttons %}
<div class="additional-checkout-buttons">
{{ content_for_additional_checkout_buttons }}
</div>
{% endif %}
{%endcomment%}

That's it, you're done! The PayPal button will now be hidden on the Cart page and will be shown on the Shopify and OCU checkout pages instead. This will ensure that your customers will use the OCU checkout for your trigger products.

*Note: The steps above apply to most standard themes. If your theme's cart.liquid  file doesn't have the mentioned code, then we recommend to use an app instead.

3. When a customer uses the PayPal Express payment option and also uses a discount at checkout, the PayPal invoice will not show the initial order's product description. This is to prevent inaccuracies in the total price shown on the invoice sent by PayPal. The standard Order Confirmation email sent by Shopify will still be sent with the total order details, including the initial order's product description.

4. The customer is required to login to their PayPal account to pay for the order using this integration. They won't be able to checkout as a guest by using a debit/credit card from the PayPal popup window.

Did this answer your question?