Skip to main content

Integrate WooCommerce

Overview

WooCommerce is a plugin that integrates easily with any website built on WordPress. The plugin helps merchants turn their websites into fully functional WordPress eCommerce platforms with just a few clicks.​

WooCommerce offers online retailers a suite of services including payments, marketing, shipping, and customer engagement tools to simplify the process of running an eStore for small and enterprise merchants. ​

Availability

WooCommerce integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts).

WooCommerce Settings

Regardless if you are already using the WooCommerce connector or you want to start integrating with 2Checkout to receive payments, you need to follow the steps below:

  
Current module version is not compatible with WooCommerce 8.0 (High-Performance Order Storage). A new compatible version will soon be released.
  1. Download the 2Checkout payment module from GitHub by clicking on the Code button and then on Download ZIP.

    woocommerce_connector_1_github.png

  2. After downloading the .zip archive, open it and extract the folders twocheckout-convert-plus, twocheckout-inline, and twocheckout. Archive these folders separately as a .zip file.
  3. Log in to your WordPress admin, navigate to Plugins and click on Add new.

    woocommerce_connector_1.png

  4. On the Add plugins page, click on Upload plugin, then on Choose File and on Install Now.

    woocommerce_connector_2.png

  5. On the Plugins page, activate the modules for ConvertPlus, InLine cart, and 2Pay.js by checking the boxes and clicking on the Apply button.

    woocommerce_connector_3.png

  6. Go back to Dashboard, scroll down to WooCommerce, and click on Settings.

    woocommerce_connector_4.png

  7. Under WooCommerce - Settings, click on the Payments tab.

    woocommerce_connector_5.png

  8. Enable all three modules and then click on Set up to configure each module.

    woocommerce_connector_6.png

  9. Configure each module by filling in all the fields:

    • Input a Title and Description for the module. These fields control how your users will see the module during checkout.
    • Input the Seller ID. Your Seller ID is the Merchant Code from the 2Checkout Merchant Control Panel. To copy this code from 2Checkout and paste it in the WooCommerce platform:
      • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Copy the Merchant Code from the API section and paste it into the Seller ID field in WooCommerce.
    • Input the Secret Key. To copy the Secret Key from 2Checkout and paste it in the WooCommerce platform:
      • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Copy the Secret Key from the API section and paste it into the Secret Key field in WooCommerce.
    • Input the Secret Word. Your Secret Word is the Buy-Link Secret Word from the 2Checkout Merchant Control Panel. To copy this code from 2Checkout and paste it in the WooCommerce platform:
      • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Go to the Secret Word section, edit the INS Secret Word to match the Buy-Link Secret Word, then copy the code and paste it into the Secret Word field in WooCommerce.
    • Fill in the IPN URL.
    • Check the Debug Log option if you want to log 2Checkout events.
    • Check the Demo order option if you want to be able to place test orders.

    woocommerce_connector_8.png

  10. Click on Save changes.

    woocommerce_connector_7.png

  11. Test your integration by placing an order. If your setup is correct,

    • the ConvertPlus flow will look as below

    woocommerce_connector_test_9.png

    • the InLine checkout flow will look like this

    woocommerce_connector_test_10.png

    • the 2Pay.js flow will be displayed as shown below. You can customize the form by using the Custom style option.

    woocommerce_connector_9.png

    woocommerce_connector_test_11.png

2Checkout Settings

  1. Sign in to your 2Checkout account.
  2. Navigate to Dashboard → Integrations → Webhooks & API section.
    Webhooks & API section
  3. Follow these steps to activate Redirect URL:
    • In the Redirect URL section, check Enable return after sale
    • For Redirect URL section, set the Approved URL to your WooCommerce URL
    • For Return method, select Header Redirect
  4. Click Update to save your settings.
  5. Make sure to enable the IPN webhook notification in your Merchant Control Panel.

    • Log in to the 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & API
    • Scroll down to the Notifications section and enable the IPN webhook

    set up IPN in merchant control panel_1.png

    • For the Payment notification type field, select IPN or Email Text & IPN, and then click on the Configure IPN button.
    • On the IPN settings page, click on the Add IPN URL button, input the IPN URL available in the configuration page in WooCommerce and select the SHA 2 / SHA 3 hash.

    Add IPN URL

    • Enable all triggers and response tags

    set up IPN in merchant control panel_4.png

About WooCommerce

WooCommerce is the most popular WordPress eCommerce plugin. And it’s available for free. Packed full of features, perfectly integrated into your self-hosted WordPress website. For more information, visit: woothemes.com/woocommerce.

FAQ

  • Does the new connector use webhooks?​​
    Yes, it uses IPN, so make sure you enable it from your Merchant Control Panel.
  • Do order statuses get updated on the WooCommerce side if any change occurs after place order?​​
    Yes, both order and fraud statuses are synchronized, as well as refunds.​
  • Can I place refunds?​
    Yes. You can place refunds from the WooCommerce portal.​
  • Can I use this connector with a 2Monetize account?​​
    No, the connector is built to cover only the 2Sell and 2Subscribe accounts.

Order tracking script

Overview

Add custom JavaScript code to the last stage of the ordering process (the Thank You page). This area can be used to add a monitoring script, such as Google Analytics, for advanced tracking of your sales, visitor, and customer conversion rates. Scripts supported are not limited to Google Analytics, and you can also include Google AdSense code.

Web Analytics platforms offer information on visitor traffic trends for your web properties. Using this tool, you can integrate your Google Analytics account with your shopping cart and extract relevant information such as behavior and transaction statistics.

Availability

Tracking scripts for the desktop version of the shopping cart are available to all 2Checkout accounts.

The tracking script is included in the Thank You page (finish.php) displayed to customers only after they successfully place an order:

  • Payment needs to be authorized successfully. This usually happens for online payment methods that are authorized instantaneously, such as credit/debit cards and PayPal.
  • Payment needs to go through without any problems or errors.

Set up tracking scripts

The tracking script is included in the Thank You page (finish.php) displayed to customers only after they successfully place an order:

  • Payment needs to be authorized successfully. This usually happens for online payment methods that are authorized instantaneously, such as credit/debit cards and PayPal.
  • Payment needs to go through without any problems or errors.

To set up tracking scripts, follow these steps: 

  1. Log in to your Merchant Control Panel.
  2. Go to Setup -> Ordering Options -> Analytics.
  3. Select the type of platform (cart) you want to include the tracking code on.
  4. You can use HTML formatting and tags and edit the code directly.
  5. Define tracking scripts for specific or for all languages available for your account. You will be able to track visitors and sales according to the cart language selected either automatically, by the 2Checkout system through its geo-location capabilities, or manually by the shoppers. If the tracking script isn't included for a certain language, you will not be able to track successful orders for customers using that language in the cart. Use the Apply for all languages option to set the same script for all languages available for your account.
  6. To change scripts, you need to edit each item in part. Selecting the Apply for all languages option will overwrite all existing scripts with the latest version you supply.
  7. Click Save tracking script to save a new script or any edits.

SSl Protocol

Use the SSL protocol when including external scripts (e.g. Google Analytics) or images:

A JS object called myOrder is available on the Thank You page providing information about the purchased products, including ID, quantity, name, price, etc.

Use the tracking script for all orders

By default, the after-sale message is displayed only for orders with payments authorized instantly (this includes usually credit cards and PayPal), after the payment is complete (transaction needs to be authorized successfully). To display the message for all placed orders regardless of the payment status:

  1. Go to Setup -> Ordering Options.
  2. Scroll down to the bottom of the Order settings area and check the checkbox for the Show message for all placed orders option.
  3. Click Save Settings.

The message will be displayed even for orders where the payment is not yet received (like bank transfers or checks).

Tracking script example

<!-- Global site tag (gtag.js) - Google Ads: 123456789 -->
  <script async src="https://www.googletagmanager.com/gtag/js?id=AW-123456789"></script>
  <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
      gtag('config', 'AW-123456789');
  </script>

  <!-- Event snippet for Example conversion page -->
    <script>
      gtag('event', 'conversion', {'send_to': 'AW-123456789/AbC-D_efG-h12_34-567',
        'value': 1.0,
        'currency': 'USD'
      });
    </script>

myOrder object

In addition to the custom JavaScript code that you can add to the last page of the purchase process (Thank You page - finish.php), 2Checkout also provides a JS object labeled myOrder.

productsInOrder

Array

An array containing all order products. Every array element is a JavaScript object with the following properties:

id

String

Unique system-generated product ID.

name

String

Product name.

quantity

Int

The number of product units added to cart.

code

String

Editable product code that you control

price

Float

Product price.

priceUSD

Float

Product price in USD.

priceEUR

Float

Product price in EUR.

category

String

Product category.

coupon

String

Promotion code used for the product.

discount

Float

Value of the customer discount for the product expressed in the currency used for the order.

discountEUR

Float

Value of the customer discount for the product expressed in EUR.

discountUSD

Float

Value of the customer discount for the product expressed in USD.

pricingOptions

String

Selection of product pricing options added to cart.

purchaseType

String

Product purchase type:

· REGULAR

· TRIAL

· RENEWAL

· UPGRADE

productVersion

String

Product version.

promotion

String

Marketing campaign/promotion name of the product.

productsIds

Array

Array with the IDs of the products in the cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and feature standalone IDs.

productsQuantities

Array

Array with the number of units of products added to the cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and feature quantity (1).

productsNames

Array

Array with the names of the products added to the cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system. productNames will feature the promotion title.

productsCodes

Array

Array with the codes of the products added to the cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and feature standalone codes.

productsPrices

Array

Array with the prices (expressed in the currency selected for the order) of the products added to cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and have negative values equal to the amount of the discount which gets deducted from the total order value.

productsPricesUSD

Array

Array with the prices (expressed in the USD) of the products added to the cart.

productsPricesEUR

Array

Array with the prices (expressed in the EUR) of the products added to the cart.

productsNumber

Int

The number of distinct products added to the cart.

productsPromotionsCoupons

Array

Array with promotion coupons impacting products added to cart.

refNo

Int

Unique, system-generated order reference number.

externRefNo

String

The order external reference number.

idAffiliate

Int

The affiliate ID referring products in the order (0 if the order was not referred by an affiliate).

AFFSRC

String

Affiliate source (SRC) parameter. NULL if no Affiliate SRC is used for an order.

totalPrice

Float

Total order value (in the currency selected for the order).

totalPriceUSD

Float

Total order value (in USD).

totalPriceEUR

Float

Total order value (in EUR).

discount

Float

Value of coupon discount expressed in the currency selected for the order.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and the discounted value is not included under discount.

discountUSD

Float

Value of coupon discount expressed in USD.

 

discountEUR

Float

Value of coupon discount expressed in EUR.

 

affiliateCommission

Float

Value of the affiliate commission for the order (expressed in the currency selected for the order).

affiliateCommissionUSD

Float

Value of the affiliate commission for the order (in USD).

affiliateCommissionEUR

Float

Value of the affiliate commission for the order (in EUR).

tax

Float

Value of sales tax or VAT (for EU) expressed in the currency selected for the order.

taxUSD

Float

Value of sales tax or VAT (for EU). (in USD)

taxEUR

Float

Value of sales tax or VAT (for EU). (in EUR)

shipping

Float

Shipping costs expressed in the currency selected for the order.

shippingUSD

Float

Shipping costs expressed in USD.

shippingEUR

Float

Shipping costs expressed in EUR.

currency

String

The currency selected for the order (ISO 4217 code; e.g.: EUR, USD, AUD, CAD).

city

String

Shopper city from the billing details.

state

String

Shopper state from the billing details.

Country

String

Shopper country code (ISO 3166; e.g.: US, CA, AU, FR, DE) from the billing details.

zipCode

String

Shopper country zip code from the billing.

avangateCustomerId

Int

Unique customer ID generated by 2Checkout for subscriptions sold. 2Checkout populates the value of the customer identifier only if you use the CUSTOMERID query parameter in your Buy Links.

externalCustomerId

String

Customer ID you control for subscriptions sold. 2Checkout populates the value of the customer identifier only if you use the CUSTOMERID query parameter in your Buy Links.

FAQ

  1. Is there a way to bypass the Thank You page?
    • Yes. If you use a Redirect URL when generating Buy Links, i.e. including the BACK_REF parameter in Buy Links together with a specific URL where shoppers are redirected after placing the order. Note: Shoppers will be redirected to this URL after the payment is confirmed. The redirect URL replaces the default "Thank you" page (except for offline payment methods such as Bank Transfer).

Start using the 2Checkout API

Overview

Use the 2Checkout API to:

  • Build apps that connect to the 2Checkout system
  • Place and manage orders
  • Manage subscriptions and customers
  • Create, update and extract product catalog and pricing information for your account
  • Manage partner accounts
  • Integrate with 2Checkout to automate your backend operations

 

   Before you start using the 2Checkout API, make sure you check whether your integration requires PCI compliance. Find out more details about what PCI compliance means and what you should do to be PCI compliant here.

Connecting to the 2Checkout API

To connect to the API, you need your merchant code, secret key, and secret word. These unique codes are automatically generated for your account, and you can retrieve them from your Control Panel Dashboard → Integrations → Webhooks and API. Copy the merchant code (found in the API section) and the Instant Notification Service (INS) secret word found in the Secret word area.

secret word.png

Architecture overview

For more details on how the 2Checkout API works, here is an overview based on the architecture used:

API Authentication

Use the merchant code and secret key to authenticate with the API. Click the links below to learn how to authenticate:

Read the API documentation

Once you've authenticated with the API, you can start configuring your environment for your specific usage scenario.

Our API documentation should help you get things done as fast as possible.

3rd party applications

You can build apps that connect to the 2Checkout system to expand existing functionalities and gain more insight into your activity while optimizing your sales. Read the documentation for detailed guidance on how to build your own apps:

2Checkout GitHub

Feel free to visit our GitHub repository to download and contribute to our code samples. We also encourage you to submit your own projects related to the 2Checkout API.

Webhooks

  • Instant Payment Notification (IPN) works as a message service generating automatic order/transaction notifications for your 2Checkout account. Use the notifications to process order data into your own management systems by synchronizing it with 2Checkout account events.
  • License Change Notification (LCN) works as a message service generating automatic subscription notifications for your 2Checkout account.

Refunds

Overview

Reimburse customers by issuing Total or Partial refunds for Completed/Finished orders. Control the amount that gets returned to your shoppers, by opting to pay back the full costs associated with an order (including taxes), or just a part of the sum paid ( including taxes).

Availability

You can request total and partial refunds for a period of up to three months since the order was finished and the product delivered to the customer. The Request refund button for Finished/Complete orders is removed for orders older than three months. Refunding is still possible for up to one year after the order was finished and/or delivered. However, for orders between three and twelve months old, you need to contact 2Checkout to issue a refund.

Refund requests placed for orders that have an open chargeback are only processed after the chargeback is closed.

Total refunds

Refund the full transaction amount of an order, including but not limited to the product price and taxes (calculated automatically by 2Checkout), as well as DIS (Download Insurance Service) costs.

Follow the steps below to initiate a total refund:

  1. Go to Orders & customers -> Order search.
  2. Select the eStore orders tab.
  3. Use the filters to search for the order that you want to reimburse.
  4. Click the order reference number.
  5. Click Request refund.
  6. Choose the Total refund type.
  7. Fill in the details of the reimbursement, including whether or not to re-use keys or disable subscriptions.
  8. Fill in the cancelation reason box.
  9. Click Request refund.

Partial refunds

Reimburse only part of the transaction amount paid for Completed/Finished orders, with the system automatically calculating the repayment taxes.

Follow the steps below to initiate a partial refund:

  1. Go to Orders & customers -> Order search.
  2. Select the eStore orders tab.
  3. Use the filters to search for the order that you want to reimburse.
  4. Click the order reference number.
  5. Click Request refund.
  6. Choose the Partial refund type.
  7. Fill in the details of the reimbursement, including whether or not to re-use keys or disable subscriptions.
  8. Fill in the cancellation reason box.
  9. Click Request refund.

The sum you set to be refunded is the final sum the customer will receive, including taxes.

Product file availability

Product files assigned to active subscriptions are still available for shoppers to download even after placing a partial refund. To cut shopper access to product files, disable the assigned subscription.

If the total amount of the partial refunds is equal to the total order value, shoppers do not have access to the product file anymore.

  Subscription active Subscription disabled
Partial refund Product file available Product file not available
Total refund Product file not available Product file not available

Adding custom refund reasons

You can define your own refund reasons, to tailor the refund process to your own business needs, and gain more control over what you offer to your shoppers. The reason codes created will be included in the refunds reports, increasing their accuracy, and helping you take better business decisions.

Important: adding new refund reasons completely replaces the existing default refund reasons in the 2Checkout platform.

New reasons are displayed as follows:

  • For shoppers: upon requesting a refund from 2Checkout myAccount
  • For merchants: upon refunding a transaction and inside the Refunds report export.

Follow the steps below to add new refund reasons.

  1. Go to Orders & customers -> Refunds.
  2. Go to the Refund settings tab.
  3. Click New reason.
  4. Enter the reason name.
  5. Click Save

You have to repeat the process for adding a new reason. After you save a refund reason, you can add localized versions. Click Edit, select the language that you want to edit, and enter the localized version. Then, click Save.

To delete a refund reason, click Delete on the reason list.

To reorganize the reason list, drag, and drop the reasons inside the list.

refunds.JPG

Your control over the refund process if further enhanced by the fact that the display order that you set in Control Panel will be reflected when customers are requesting refunds from their 2Checkout account, as displayed in the screenshot below.

customers_reasons

Take advantage of the new process by better engaging your customers and gathering their feedback.

Canceling refund requests

You can cancel a refund request as long as the reimbursement process hasn’t started.

Follow the steps below to cancel an unprocessed refund.

  1. Go to Orders & customers -> Order search.
  2. Select the eStore orders tab.
  3. Use the filters to search for the order that you initiated the refund for.
  4. Click the order reference number.
  5. Click You can view the refund details or cancel the request.
  6. Click Cancel this refund request.

Bundle refunds

You can request and issue refunds for orders containing product bundles. To request a bundle refund, follow the same steps described above for either a total or a partial refund while paying attention to the following two scenarios.

Parent-level subscription bundles

When issuing refunds for parent-level subscription bundles, you have the following options:

  • Cancel the subscription generated for the bundle. Customers can no longer use, renew or upgrade the products in the bundle.
  • Stop automatic billing. Customers can manually renew and upgrade the products included in the bundle.

Child-level subscription bundles

When issuing refunds for child-level subscription bundles, you have the following options:

  • Cancel all or some of the included subscriptions. Customers can no longer use, renew or upgrade the selected subscriptions.
  • Stop automatic billing. Customers can manually renew and upgrade the selected subscriptions.

FAQ

  1. Does 2Checkout send refund notifications?
    • Yes. Customers receive an email with information on the evolution of the refund, regardless of whether it was approved or rejected. You also get a notification message and have the option of viewing the details of an order for which a refund was issued.
  2. How is the refund reflected in the order status?
    • Once a total or partial refund was approved and the customer reimbursed, the status of the order changes to Refunded. The Request refund button changes to View original order for Refunded orders, with all the payment details illustrating the reimbursement. A refund request can still be placed after a partial refund, and the original order will display “Request refund”.
  3. How long does it take for a transaction to be refunded?
    • Once a refund was approved, reimbursement occurs. The refund amount will be available in the customer's bank account after the refund is processed, depending on the issuing bank.
  4. Can I issue more than one refund to a customer for the same order?
    • Yes. You can issue either a single total refund or several partial refunds for each order. 
  5. Can shoppers request refunds directly from 2Checkout?
    • Yes. 2Checkout evaluates refund requests from both you and your customers. In case your shoppers contact 2Checkout directly, 2Checkout notifies you via email. Failing to reply to the refund request that was referred to you, causes 2Checkout to issue the reimbursement automatically if it’s found to have merit. Please see the refunds section of your 2Checkout e-Commerce Agreement for additional details.
  6. Are there any costs associated with a refund?
    • No. Neither you nor the shopper gets charged when refunding an order, but the order processing commissions already received by 2Checkout will not be returned.
  7. Can keycodes for a refunded product be reused?
    • Keycodes for electronic delivery can be re-used only if they are part of static lists or if the lists allow the use of duplicates. Keycodes from static lists can be assigned to multiple instances of a product or to multiple products. To be able to reuse keycodes, select the Re-use keycodes checkbox when requesting a refund from the order via the Merchant Control Panel.
  8. What happens to refunded subscriptions?
    • The Disable license functionality impacts only renewal licenses managed through the 2Checkout platform, but not the licenses of the products acquired by your customers. For subscriptions, you control the transaction amount considered for a reimbursement, which can be the last payment or all payments a customer made, with forthcoming renewal licenses being canceled automatically.
  9. What types of orders can be refunded?
    • Total and partial refunds may be performed only against settled transactions, so the options are not available for Unfinished, Canceled or Processing (In Progress and Pending Approval) orders. In Progress and Pending Approval orders can only be reversed, not refunded. However, the reverse of a refund can only be performed by 2Checkout, so for this purpose contact our Refunds Department. 
  10. What happens to licenses when refunds are issued?
    • When a partial refund or total refund is issued, you have the option to disable the subscription by selecting the Cancel subscription checkbox when requesting a refund from the order via the Merchant Control Panel. Otherwise, subscriptions will remain active. 

myAccount custom domain

Overview

You have the option of hosting 2Checkout myAccount on a custom domain to offer a personalized experience to your shoppers complemented by branding and a design aligned with the look and feel of your website. Control the 2Checkout customer service platform for your shoppers, focusing it only on interactions they have with your company. Offer mature shopper portal management capabilities, enabling subscribers to manage subscriptions, upgrade and even update their information, including payment details, via a single account.

Availability

Contact 2Checkout for availability.  

Requirements

Custom domain. Contact 2Checkout to set up a custom domain. 

Custom 2Checkout myAccount domains

If you are already using custom domains for the shopping cart, we recommend enhancing the shopping experience even further via personalized myAccount domains. Custom 2Checkout myAccount domains are available in tandem with personalized Ordering Hosts, providing your customers with accounts that share the same domain as the shopping cart used to buy your products.

Take advantage of custom myAccount domains to centralize and offer access only to information for the products that shoppers purchase from you, filtering out their actions in the 2Checkout network that are not related to your subscriptions.

Monthly order report

The report centralizes data for finished and refunded orders within a specific time interval, paid in a specified currency. Data included in the report originates from the following sales channels: eStore, Affiliate Network, Network Cross-Sales, and Distribution Partners (a filter allowing the selection of specific partners is available). The Monthly Orders Report uses the 2Checkout currency exchange rates from the day when customers paid the orders, and as such, all aggregated amounts are estimated.

You can use this report to see the value of finished and refunded orders placed in a specific currency or the value of all the orders converted to the default payout currency.

The Compare with previous period option enables a year over year comparison of order data, including statistics from the year preceding the last 12 months.

Report data may differ from the 2Checkout Sales Report for accounts with EUR and USD settlement currencies, due to the exchange rate used during currency conversion.

Integrate PrestaShop

Overview

Merchants can use the PrestaShop connector to integrate with 2Checkout and process orders with ConvertPlus, InLine Cart, and 2Pay.js, and provide an improved experience to their shoppers.​

Availability

PrestaShop integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts).

PrestaShop Settings

Regardless you are already using the PrestaShop connector or you want to start integrating with 2Checkout, you need to follow the steps below:

1. Download the 2Checkout payment module from GitHub by clicking on the Code button and then on Download ZIP.

prestashop_connector_1New.png

2. After downloading the .zip archive, open it and extract the folder twocheckout, then archive it separately as a .zip file.

3. Sign in to your PrestaShop admin and navigate to Modules → Module Manager.

prestashop connector_2.png

4. On the Module Manager page, click on Upload module and upload the twocheckout .zip folder.

prestashop connector_3.png

prestashop connector_4.png

5. After upload, the new module will appear as shown here:

prestashop connector_5.png

6. Click on Configure to add your information:

  • Seller ID (Merchant Code)
  • Buy Link Secret Word
  • Secret Key
  • Select the cart type:
  • Select "Demo mode" if you wish to enable it. This will allow you to place test orders using test payment methods, to check your integration with 2Checkout.
  • Select the style for the API form. You can choose to use the "Default style" or you can customize it by implementing the code snippet provided there.
  1. The Seller ID is your 2Checkout Merchant Code that you can obtain by logging in to your Merchant Control Panel and navigating to Integrations → Webhooks & API. 
  2. To find the Buy Link Secret Word, log  in to your 2 Checkout Merchant Control Panel and navigate to Integrations → Webhooks & API → Secret Word . Edit your  INS Secret Word to match the Buy Link Secret Word , copy the value and paste it in the PrestaShop admin.
  3. The Secret key can be found in your 2Checkout Merchant Control Panel, right next to the Merchant Code. Copy and paste it in your PrestaShop admin.

prestashop connector_6.png

7. Once you've filled in all the information, click on Update settings at the bottom of the page.

prestashop connector_7.png

8. Test your integration by placing an order. If your set-up is correct, you will be able to see the Pay with 2Checkout option:

  • for ConvertPlus and InLine checkout flow

prestashop connector_8New.png

  • for 2Pay.js checkout flow

test prestashop api payment.png

2Checkout Settings

  1. Sign in to your 2Checkout account.
  2. Navigate to Dashboard → Integrations → Webhooks & API
  3. Follow these steps to activate Redirect URL:
  4. Click Update to save your changes.
  5. Make sure to enable the IPN webhook notification in your Merchant Control Panel
  • Log in to the 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & API
  • Scroll down to the Notifications section and enable the IPN webhook

set up IPN in merchant control panel_1.png

  • For the Payment notification type field, select IPN or Email Text & IPN, and then click on the Configure IPN button.
  • On the IPN settings page, click on the Add IPN URL button and input the IPN URL available in the configuration page in Prestashop.

set up IPN in merchant control panel_2.png

set up IPN in merchant control panel_3.png

  • Enable all triggers and response tags

set up IPN in merchant control panel_4.png

About PrestaShop

PrestaShop is an eCommerce marketplace for small and medium merchants and offers them a variety of tools to download that help them build their online businesses. Fast, efficient, and easy to use, PrestaShop’s free eCommerce solution provides everything merchants need to open, operate, and maintain a successful online store.

For more information visit PrestaShop.com.

FAQ

1. Does the new connector use webhooks?​​​

Yes, it uses IPN, so make sure you enable it from your Merchant Control Panel.

2. Do order statuses get updated on the PrestaShop side if any change occurs after place order?​​​

Yes, both order and fraud statuses are synchronized, as well as refunds.​​

3. Can I place refunds?​​​

Yes, but only from the 2Checkout Control Panel. You will be able to place refunds from the PrestaShop portal in the next release of the connector.​

4. Can I use the connector with a 2Monetize account?​​​

No, you can't. This connector is built to cover only the 2Sell and 2Subscribe accounts.

Integrate WP-Invoice

Availability

WP-Invoice integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts). 

WP e-Commerce Settings:

  1. Download or clone the 2Checkout payment module at https://github.com/craigchristenson/2checkout-wp-invoice
  2. Upload the files under the “wp-invoice” directory to “/wp-content/plugins/wp-invoice” on your web server.
  3. In your WordPress admin select Invoice -> Settings to open your WP Invoice settings.
  4. Under Payment select 2Checkout.
  5. Enter Display Name. Example: Credit Card (Visa, MasterCard, American Express, Discover, JCB, PIN Debit) and PayPal
  6. Enter your 2Checkout Merchant Code.
  7. Enter your 2Checkout Secret Word. (Must be the same value entered on your 2Checkout Control Panel.) To obtain the Secret Word, log in to your 2Checkout Merchant Control Panel account and navigate to Integrations → Webhooks & API → Secret Word → INS Secret word.  Your INS secret word should be the same as the buy-link secret word (can be found under Dashboard → Integrations → Webhooks & API, scroll down to the Secret Word area, under the INS Secret Word). Edit your INS secret word and buy-link secret word to match each other, then copy and paste them into your WP-Invoice admin. INS secret word.png
  8. For demo sales set Demo Mode to Yes. For live sales keep Demo Mode at No.
  9. Under Direct Checkout select Yes.
  10. Copy the URL provided under “2Checkout Approved URL/INS URL”.
  11. Click Save All Settings.

2Checkout Settings:

  1. Sign in to your 2Checkout account.
  2. Navigate to Dashboard → Integrations → Webhooks & API
  3. Follow these steps to activate Redirect URL:
    • In the Redirect URL section check “Enable return after sale”
    • For Return method, select Link in the Thank You Page or Header redirect
    • Set the Approved URL to the URL provided in your WP Invoice settings (Replace http://yourdomain.com with the actual URL to your domain)
    • Click Update to save your settings
  4. In the Webhooks and API section, under the Instant Notification Service (INS) card, check the Enable Global URL box. 
  5. Enter the Approved URL (it must be the same value entered in your WP Invoice settings) as the Global URL (replace http://www.yourdomain.com with your actual website URL)
  6. Enable all triggers.
  7. Click Update to save your changes.

About WP-Invoice

WP-Invoice lets WordPress blog owners send itemized invoices to their clients. Ideal for web developers, SEO consultants, general contractors, or anyone with a WordPress blog and clients to bill. The plugin ties into WP’s user management database to keep track of your clients and their information.

For more information visit: http://wordpress.org/extend/plugins/wp-invoice/

Integrate osCommerce

Overview

Integrate osCommerce to be able to process payments through the 2Checkout platform in over 200 countries and more than 100 currencies.

osCommerce is an eCommerce and online store management software that helps merchants to launch their businesses.

Availability

Before you are able to start accepting payments, you need to request and finalize the activation of your live account by completing a form, and provide information that will help us verify the business and identity of the individuals involved in your business. 

osCommerce integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe).

osCommerce Settings

Perform the below set of instructions in your osCommerce account to integrate it with 2Checkout.

  1. Download the new 2Checkout module from Github.
  2. Upload the files to your server under your store’s directory.
  3. Log in to your osCommerce admin area.
  4. Navigate to Administration → Modules and click on Payment.
    integrate_osCommerce-connector_1.png
  5. On the Payment page, click Install on 2Checkout.
    integrate_osCommerce-connector_2.png
  6. Select 2Checkout API, 2Checkout ConvertPlus or 2Checkout InLine and click on Install Module.
    integrate_osCommerce-connector_3.png
  7. Enter your 2Checkout details:

    • 2Checkout Account ID. The 2Checkout ID is your 2Checkout Merchant Code, and you can find it in the 2Checkout Merchant Control Panel, under Integration → Webhooks and API.
    • Secret Key (you can find it in the 2Checkout Merchant Control Panel, under Integration → Webhooks and API)
    • Buy-Link Secret Word (you can find it in the 2Checkout Merchant Control Panel, under Integration → Webhooks and API)

    integrate_osCommerce-connector_4.png

  8. Under Test Mode select No for live sales or Yes for test sales.
  9. Click Save Changes.

2Checkout Settings

  1. Log in to your 2Checkout Merchant Control Panel.
  2. Navigate to the Integrations → Webhooks & API section.
  3. Enable the IPN webhook notification.
    • Go to Integrations → Webhooks & API
      Webhooks & API
    • Scroll down to the Notifications section and enable the IPN webhook.
    • For the Payment notification type field, select IPN or Email Text & IPN, and then click on the Configure IPN button.
    • On the IPN settings page, click on the Add IPN URL button, input the IPN URL available on the configuration page in osCommerce and select the SHA 2 / SHA 3 hash.
      Add IPN URL
    • Enable all triggers and response tags.

About osCommerce

osCommerce (Open-Source Commerce) is an eCommerce and online store management software. ​It’s one of the oldest eCommerce solutions that help merchants to launch their businesses.​ It has support for both physical and digital products, as well as services.​

osCommerce provides a complete package of solutions to different aspects of online business(features like billing, product display, multi-language options, different currencies, etc.)

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo