Skip to main content

Integrate WP e-Commerce

Availability

WP-eCommerce 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-e-commerce.git
  2. Upload the ‘wpec-twocheckout-hosted’ directory to “/wp-content/plugins/” on your web server and activate the ‘2Checkout Payment Gateway for WP e-Commerce ’ plugin.
  3. In your WordPress admin select Settings -> Store to open your WP e-Commerce settings.
  4. Under Payment click Settings under 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 and navigate to Dashboard→ 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-eCommerce admin. INS secret word.png
  8. Select the language you want the 2Checkout purchase routine to be in.
  9. Select ‘Production’ for live mode or ‘Sandbox’ for sandbox mode.
  10. Select the appropriate billing fields for the Forms Sent to Gateway section.
  11. Click Update.

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 Header redirect
    • Set the Approved URL to the URL provided in your WP e-Commerce settings  (Replace http://yourdomain.com with the actual URL to your domain)
    • Click Update to save your settings

About WP e-Commerce

WP e-Commerce is a free WordPress shopping cart plugin that lets customers buy products, services and digital downloads online.

For more information visit: https://wpecommerce.org

Integrate 1ShoppingCart

Availability

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

1ShoppingCart Settings:

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

  1. Sign in to your 1ShoppingCart account.
  2. Navigate to Setup → Gateway Setup
  3. Click the Payment Gateway radio button, then click Edit
  4. Under the Select Gateway drop-down menu, select 2CheckOut.com
  5. Enter your 2Checkout Account Number (SID) in the Gateway ID/Merchant Login field.
  6. Under Which Cards Do You Accept? ensure the following boxes are checked: Visa, MasterCard, AmEx, Discover, JCB
  7. Under Other Payment Setting set the “Sale Type” to Authorize and Capture
  8. Click the Done button.

2Checkout Settings:

Follow the below instructions in your 2Checkout Control Panel to finalize the 1ShoppingCart integration process.

  1. Sign in to your 2Checkout account.
  2. Navigate to Dashboard → Integrations → Webhooks & API section
  3. Follow these steps to activate Redirect URL:

4. Click Update to save your settings. 

About 1ShoppingCart

1ShoppingCart is the most affordable way to build your list, automate marketing and make sales online. We make it easy to get your business online, capture leads and convert them into customers automatically. Start your free trial today and experience the power of all-in-one sales and marketing software designed by marketers, for marketers.

For more information visit: 1ShoppingCart

 

Adobe Analytics reports

Overview

You can receive real-time statistics on your shopping cart performance to help you make informed decisions on increasing conversion rate and revenue.

You can request the Adobe Analytics Key Metrics report by sending an email to i.buh.cro@verifone.com. We'll investigate if this data is available, and will send you a report link in read-only format. You don’t need to have an Adobe Analytics account to view this read-only report. You will be able to change the desired time range for which you want to see the data.

Report details

The report contains the following sections:

  1. Report Key metrics evolution for the past 12 full months (updated monthly): Unique Visitors, Orders, Conversion Rate (based on Unique Visitors), Revenue per Visitor (based on Unique Visitors), Revenue (revenue generated by web orders, automatic renewals, refunds and chargebacks and test orders are not taken into account).Adobe Analytics Segments
  2. Key metrics by country for the top revenue generating countries. This set of data will also pertain to the last 12 full months and will be updated monthly.                                                                   Adobe Analytics Segments 2

The date range of the reports is automatically set to “last 12 full months” with data being updated monthly. If you wish to change the date range, you can do so by clicking on the displayed date option in the top right corner and choose a new desired date range.

Key Metrics Reports

Upsell

Overview

Upselling is the practice that allows you to invite your customers to purchase a higher-end product, an upgrade, or an additional item in order to make a more profitable sale. The 2Checkout Public API supports upsell campaigns through which you can recommend catalog products to your shoppers.

UpSell Object

Use the UpSell object in order to recommend products to customers via SOAP API 6.0.

Parameters

Parameter name Type Description

Name

String

Name of the upsell campaign.

StartDate

String

The date when the up-sell campaign starts, in the YYYY-MM-DD format. Can be NULL (starts immediately after enabling).

EndDate

String

The date when the up-sell campaign ends, in the YYYY-MM-DD format. Can be NULL (ends immediately after disabling).

DisplayForManualRenewals

Boolean/Integer

Flag to control if the campaign will be displayed for manual subscription renewal orders. Can be set as true/false/0/1.

Discount

Object

Discount definition object, details below:

      Type

String

Type of discount. Can be FIXED or PERCENT.

      Value

Integer

Percentage discount value (PERCENT discount only).

      Values

Array of objects

List of currency discounts (FIXED discount only), details below.

            Currency

String

Code of the currency for the related amount.

            Amount

Integer

Discount amount value for the related currency.

      DefaultCurrency

String

Code of default currency (FIXED discount only).

PrimaryProduct

Object

Main (primary) product object, details below:

      Code

String

The code of the product that the recommendation is made for

      Quantity

Integer

The quantity for the primary product. Can be 0 (standing for any quantity)

      PriceOptions

Array of objects

Price options list for the primary product, details below:

            Code

String

Price option group code.

            Options

Array of objects

Price options list, details below:

                  Code

String

Price option code.

                  Value

Integer

Price option value (for scale interval price option group only).

RecommendedProduct

Object

Recommended product object, details below:

      Code

String

The code of the recommended product.

      Quantity

Integer

The quantity for the recommended product. Can be 0 (standing for “match quantity” setting).

      PriceOptions

Array of objects

Price options list for the recommended product, details below:

            Code

String

Price option group code.

            Options

Array of objects

Price options list, details below:

                Code

String

Price option code.

                Value

Integer

Price option value (for scale interval price option group only).

Enabled

Boolean/Integer

Sets the campaign enabled or disabled. Can be set as true/false/0/1.

Description

Array of objects

List of campaign language descriptions, details below:

      Language

String

The language code.

      Text

String

The text of the description in the associated language.

UpsellingDisplayType String Set upsell settings display type. Can be overlay, interstitial.

 

 

JSON-RPC API

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

 

Request invoice/payment

Overview

Send invoices by email to your customers, and request payment for your products. The email sent to your customers will have a link to a checkout page where the customer can make a payment to you. The Request invoice/payment functionality exists primarily for invoicing purposes where it may be necessary to bill for a product or service that does not have a static price, or the final sales price is unknown.

You can also use Request invoice/payment for billing excess server time for web hosts, or for services that need to be billed in addition to the product/pricing structure hard-coded via 2Checkout’s product listing. 

Note: At this moment, the Request invoice/payment functionality can be sent only in English.

 

Availability

Available to all 2Checkout accounts (Request invoice → for 2Checkout PSP accounts/Request payment → for 2Checkout MoR accounts.)

You can use the Request invoice/payment functionality for both ConvertPlus and 2Checkout Default ordering flows.

Workflow

  1. Login to the 2Checkout Control Panel.
  2. Go to Setup > Generate links.
  3. Select the preferred ordering flow: Default flows or ConvertPlus.
  4. Select the product/s for which you want to send the payment request.
    • For ConvertPlus, you can request payment for dynamic products.
    • For Default flows, you can request payment for catalog products with dynamic pricing.
  5. Click on Request invoice/payment.
  6. Once the Request invoice appears, define the following attributes:
    • Language - The language used in the communication with your customers.
    • Customer name - The name of the customer used in email.
    • External ref no - External reference number that you control. Acts as an invoice number.
    • Customer email - Email used for sending the payment request.
    • Additional text - Comments displayed in the email content sent to your customers.
  7. Preview the Request invoice email, or Send it right away to your customers.

article.png

request payment.png

Reporting

You can track orders placed as a result of the Request invoice flow from Orders & customers > Order search. Filter the results by using the External reference included in the email sent to your customers. Alternatively, you can export the orders in full options template format, and check for the values in the External Reference No column.

Measure the performance of your Request invoice feature by accessing the Email Metrics report available in the Control Panel. The information extracted in the report can be split based on the ordering flow used: ConvertPlus or Default 2Checkout flows.

Affiliate sales report

Sales made through affiliates are centralized for the Affiliates Sales Report, along with sales made through cross-selling campaigns. Cross-selling involves recommending additional products right in the shopping cart, either more items from you or offerings from third-party vendors inside the Avangate network (network cross-selling).

The results listed in the Affiliates Sales Report can be filtered by affiliate and product, but searches performed could also involve parameters as specific offerings and custom time intervals. The Affiliates Sales Report provides a rundown of all affiliate sales per day, enabling the analysis of data in great detail.

Here's a list with all the details provided by the Affiliates Sales Report:

  • CTs (Clickthroughs) - unique clicks sent by affiliates
  • Complete Orders - Complete orders where the affiliate receives a credit
  • ConvR (Conversion ratio) - percent of successful sold products from all affiliate referred products (Products / CTs)
  • Total - Total amount of sold products referred by affiliates (no VAT included, commissions not excluded)
  • Refunds - Total amount of refunded products where the affiliate will be debited (no VAT included, commissions not excluded)
  • ComR - Average affiliate(s) commission percent for the referred sales (CommA/Total)
  • EUR/CT - Average order amount for every referred click (Total/CTs)
  • CommA - Affiliate(s) commission for the referred sales
  • EPC - Earnings per Click

The report uses the currency exchange rate from the day when orders were paid. Note: The data may differ from the Avangate Sales Report which employs a monthly average currency exchange rate.

Account balance report

Overview

Account Balance shows estimates of the revenue earned during the current payout interval calculated from the last payment made by 2Checkout and up to the day when it's generated. The report is calculated only for complete orders from the last payment report date, and refunds, shipping costs (if they exist), as well as taxes, are also included. All data is displayed in accordance with the currencies the orders were paid for, no conversions are made.

Account Balance offers a quick overview of the total number of customers and orders, as well as active products and promotions starting from the moment you began using your account. It includes the following amounts.

  • Orders total: total order amount, including tax/VAT, processing, and affiliate fees for the current billing interval.
  • Processing fees: processing fees paid to 2Checkout.
  • Affiliate fees: fees you pay to affiliates selling your products.
  • Retained Disputes: total value of disputed charges retained in the Disputes Balance, for the current billing interval.
  • Released Disputes: total value of disputed charges released from the Disputes Balance, in the current billing interval.
  • VAT/TAX: taxes collected by 2Checkout.
  • Total revenue: income left after processing fees, affiliate fees, tax/VAT, refunded orders and chargebacks have been deducted.

API Responses

Overview

This section contains the objects returned as API responses, based on your requests to retrieve information on orders, products, subscriptions, promotions, and others.

 

 

SaaS dashboard metrics

Overview

The 2Checkout SaaS dashboard provides insight into your subscription business, revealing valuable information on how the customer base evolves. This includes new customers, the number of total active and past-due subscriptions, number of trials, and conversions to paid services. These new metrics will help you make informed decisions that will drive further growth across your customer base.

Requirements

Your account needs to be equipped to sell subscriptions.

Please contact 2Checkout to access the SaaS dashboard functionality.

Report time span

The report spans either:

  • the last week (7 days), counting from the day preceding the day when it's generated. Data in this interval of time is compared to the previous week (7 days). For example, if the report is generated on June 28, 2013, the weekly overview covers Jun 21, 2013 - Jun 27, 2013, and the comparison period is Jun 14, 2013 - Jun 20, 2013.
  • the last month, counting from the day preceding the day when it's generated. Data in this interval of time is compared to the previous month. For example, if the report is generated on June 28, 2013, the monthly overview covers May 29, 2013 - Jun 27, 2013, and the comparison period Apr 29, 2013 - May 28, 2013.

The SaaS dashboard time zone is (GMT+02:00) Athens, Bucharest, Istanbul.

Data is updated daily.

SaaS dashboard metrics

Customers

New paying

The number of new active customers created in the 2Checkout system during the report interval. Active customers have at least one active or a past-due subscription. Customers owning only active trials, but no active subscriptions, are not taken into account.

The percentage reflects the comparison of the number of new customers in the latest report interval vs. that of the previous interval. If a new customer becomes inactive during the report interval, it will be counted both under New paying and Canceled.

Canceled

The number of customers who have become inactive during the report interval (all their active or past due subscriptions have expired or were canceled). Customers for which all subscriptions have been moved under other customer entities in the 2Checkout system are considered Canceled.

The percentage reflects the comparison of the number of canceled customers in the latest report interval vs. that of the previous interval. If a new customer becomes inactive during the report interval, it will be counted both under New paying and Canceled.

 

Subscriptions

Total active

The total volume of active subscriptions and trials reported for the day preceding the day when the report is generated. The number is a snapshot of all active subscriptions the day prior to the creation of this report.

Total past due

The total number of subscriptions that are in the grace period (Past Due status), namely have passed their renewal deadline but are not expired, for your account the day prior to when the report is generated. The number is a snapshot of all Past due subscriptions the day prior to the creation of this report.

New trials

The total number of active trial subscriptions started in the 2Checkout system during the report interval. The percentage reflects the comparison of the number of new trials in the latest report interval vs. that of the previous interval. (Available only of your account uses trials). If a new trial is converted during the report interval, it will be counted both under New trials and Converted trials.

Converted trials

The total number of subscriptions that were converted from trials to paying products during the report interval. The volume of converted trials reported does not subtract eventual refunds. (Available only of your account uses trials). If a new trial is converted during the report interval, it will be counted both under New trials and Converted trials.

Note: In some scenarios, the same customer and trials can be counted multiple times by the report, which is designed to take into account customer and subscription status. For example:

  • Customer A owns Subscription A. If during Jun 21, 2013 - Jun 27, 2013, Customer A that was originally active becomes inactive, Subscription A is not renewed and expires. If it's then manually re-activated by you, this will also reactivate the customer, so Customer A will be counted twice for New paying and once for Canceled.
  • Customer A owns Trial A (the evaluation version of Subscription A). If during Jun 21, 2013 - Jun 27, 2013, Trial A is converted to the full paid Subscription A, then Trial A will be counted both as a New trial and a Converted trial.

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