Skip to main content

PayPal

Overview

PayPal is a real-time payment and money transfer solution available globally. Businesses and customers with PayPal accounts can easily send and receive payments online without the need to turn to more traditional payment mechanisms.

The total value of PayPal transactions in 2011 was $118 billion, generated by 110 million active registered accounts and owned by customers in 190 markets worldwide. PayPal mobile payment volume in 2011 was $4 billion, growing from $750 million in mobile payments in 2010. (Active accounts are those that have had activity in the past 12 months.)

Availability

PayPal is available as a payment method for all 2Checkout accounts and it can be activated from the Merchant Control Panel. This payment method is not available to merchants registered in countries not supported by PayPal.

Please verify whether your country or region is supported by PayPal here

Workflow

For orders paid with PayPal, the following information is included in the order/item description fields on PayPal receipts and emails:

  • Vendor domain (this is the only piece of info for trial conversions)
  • Type of order: new purchase or renewal
  • Order reference number (only for new purchases)

2Checkout automatically reverses fraud-suspect PayPal orders and orders with invalid data after 14 days.

Cross-sell

Overview

Use this object to retrieve information about the cross-sell campaigns you configured for your account. 

Parameters

Parameter Type/Description

MasterProducts

Array

 

Array of product codes for the items you set to trigger the cross-sell campaign.

DisplayType

String

 

  • cart – Shopping cart
  • review – Review page
  • finish – Thank you page

DisplayInEmail

Boolean

 

True or false depending on whether you set the cross-sell campaign to display in payment receipt emails or not.

Products

Array of objects

 

Details below

 

ProductCode

String

 

 

Product code for the item you set as recommended for the cross-sell campaign.

 

Discount

String

 

 

Value of the discount. This is a percentage.

 

DiscountType

String

    PERCENT – you can only set discounts as a percentage from the product price.
  Type String

 

 

Example: Own

  AutoAdded Boolean
  DiscountedPrice Array of objects
    Details below.
                            Currency String
                            Price Float
  BasePrice Array of objects
                            Currency String
                            Price Float

CampaignCode

String

 

Unique, system-generated cross-sell campaign code.

Name

String

 

Campaign name.

StartDate

String

 

YYYY-MM-DD. The start date you set for the cross-sell campaign.

EndDate

String

 

YYYY-MM-DD. The end date you set for the cross-sell campaign.

CampaignStatus String
  The status of the cross-sell campaign.
CampaignOwnerType String
  Campaign owner type: Can be either MERCH or AFF.

Regular promotions

Overview

Apply discounts to specific products added to the shopping cart. Volume discounts impact the unit price applied by the platform.

 

Availability

Available for all 2Checkout accounts, and both Channel Manager and resellers if you (merchant) use the products in both channels.

How regular promotions work 

The 2Checkout system automatically applies regular product promotions when the shopping cart contains a product you assigned the promotion to.

   The 2Checkout system applies the round-up to the discount (first calculated), not the price. Example: For a product with net price, where the price = 12.99 EUR, and discount = 50%. Step 1: The 50% discount of 6.495 EUR with round-up = 6.50 EUR. Step 2: The price in the shopping cart will be 12.99- 6.50 = 6.49 EUR.

Add a regular promotion

  1. Log in to your Merchant Control Panel account.
  2. Navigate to Marketing tools -> Promotions -> Regular promotions.
  3. Click Add regular promotion.
  4. Give a suggestive title and description to your promotion. Shoppers can see the promotion title during purchase.
    • Add localized promotion names for any of the supported languages. The 2Checkout shopping cart automatically displays localized promotion names based on the selected shopping cart language.
  5. Select when you want the promotion to run. You can limit promotions to a specific time interval or let them run indefinitely. To start a promotion as soon as you mark it Active, leave the start date empty. If you don't set the end date, the promotion will stop when the maximum number of orders has been reached or will continue to run if the maximum number of orders is unlimited.
  6. Select whether to apply the product promotion to eCommerce orders, partner orders (Channel Manager) or both.
  7. Select the coupon/voucher type:
    • Single - one voucher to impact multiple orders;
    • Multiple - individual and unique, per-order vouchers.
  8. (Optional) If the cumulative promotion option is enabled on your account, select if the regular promotion is cumulative (can be added over another regular promotion) or not. 
  9. (Optional) If the promotion is cumulative, you need to select the tax category for the discounted product as well, by selecting an option from the Product tax category drop-down list.
  10. Choose whether to restrict the promotion to a number of orders, or apply it for all orders. This option is only available for single coupons.
  11. Choose whether or not to limit the promotion based on the product quantity. Any product quantity above this limit will be sold at full price.
  12. Fill in the promotion coupon/voucher code. The maximum length of a coupon code is 255 alphanumeric characters.
    • Single: enter the coupon values manually
    • Multiple: either add the values manually one coupon per line or use the coupon generator available in the Control Panel to generate 5, 10, 20, 30, 50, or 100 vouchers at a time and either append them to an existing list or replace existing items. The generator creates random vouchers that resemble this: D8C10E32. 2Checkout recommends limiting the number of coupon codes to a maximum of 25000.
  13. Select the discount type:
    • Percentage
    • Fixed
  14. Choose whether or not to apply discounts automatically. Only available for single coupons. This option applies discounts to all selected products in all orders, without allowing shoppers to enter the coupon manually.
  15. Choose whether or not to publish the promotion to the 2Checkout Affiliate Network.
  16. Activate the promotion.
  17. Select the products to be included in the promotion.
  18. Click Save.

Duplicate an active promotion

Users can duplicate an active promotion in the Merchant Control Panel. This will improve the user experience and simplify the actions needed to add a new promotion.

The feature is available for users who are offering promotions and can be activated from all the pages from the Promotion tabs.

Promotions tabs

To use the feature, follow the steps below:

  1. Go to Marketing tools -> Promotions -> Select an active promotion that you want to Save as new.
  2. Click on Save as new button.

Promotions Save as New

  3. The promotion will be cloned as Inactive; the name will be by default Copy of cloned promotion.

  4.  A new code will be generated.

  5. Click on the Actions icon to activate the promotion.

Regular promotions actions button
  6. Click on the Activate button.

Activate button

  7. The actions will be visible in the User Activity reports tab.

User activity reports

Affiliate promotions

Overview

Configure product promotions to be available to your Affiliate Network. This way, your affiliates can offer shoppers a better price for their promoted products.

Availability

Available for all 2Checkout accounts.

Adding an affiliate promotion

  1. Go to Marketing tools -> Promotions -> Regular promotions.
  2. Click Add regular promotion.
  3. Give the promotion a suggestive title and description. Shoppers can see the promotion title during purchase.
  4. Select when you want the promotion to run. You can limit promotions to a specific time interval or let them run indefinitely. To start a promotion as soon as you mark it Active, leave the start date empty. If you don't set the end date, the promotion will stop when the maximum number of orders has been reached or will continue to run if the maximum number of orders is unlimited.
  5. Choose whether to apply the product promotion to eCommerce orders, partner orders (Channel Manager) or both.
  6. Choose the coupon / voucher type:
    • Single - one voucher to impact multiple orders;
    • Multiple - individual and unique, per-order vouchers.
  7. Choose whether to restrict the promotion to a number of orders, or apply it for all orders. This option is only available for single coupons.
  8. Choose whether or not to limit the promotion based on the product quantity. Any product quantity above this limit will be sold at full price.
  9. Fill in the promotion coupon/voucher code. The maximum length of a coupon code is 255 alphanumeric characters.
    • Single: enter the coupon values manually
    • Multiple: either add the values manually one coupon per line, or use the coupon generator available in the Control Panel to generate 5, 10, 20, 30, 50 or 100 vouchers at a time and either append them to an existing list or replace existing items. The generator creates random vouchers that resemble this: D8C10E32. 2Checkout recommends limiting the number of coupon codes to a maximum of 25000.
  10. Select the discount type:
    • Percentage
    • Fixed
  11. Choose whether or not to apply discounts automatically. Only available for single coupons. This option applies discounts to all selected products in all orders, without the need for shoppers to enter the coupon manually.
  12. Choose to publish the promotion to the 2Checkout Affiliate Network.
  13. Activate the promotion.
  14. Select the products to be included in the promotion.
  15. Click Save.

Reseller

Overview

Structure

Reseller Object
ResellerCode String
  Unique, system generated reseller identifier. Can be NULL.
Company String
  Reseller company name. Can be NULL.
FirstName String
  Reseller first name. Can be NULL.
LastName String
  Reseller last name. Can be NULL.
Email String
  Reseller email. Can be NULL.
Phone String
  Reseller phone. Can be NULL.
Fax String
  Reseller fax. Can be NULL.
Country String
  Reseller country ISO language code (ISO 639-1 two-letter code). Can be NULL.
State String
  Reseller state. For example, "Alabama","Alaska","Arizona". Can be NULL.
City String
  Reseller city. Can be NULL.
Address String
  Reseller address. Can be NULL.
PostalCode String
  Reseller ZIP code. Can be NULL.

How to lower chargeback rates

Overview

Chargeback alert networks work with their enrolled issuing banks to alert merchants whenever cardholders file disputes for their transactions. This way, merchants can take action and offer refunds before the dispute takes place.

Being enrolled in a chargeback alert network, 2Checkout is notified when cardholders issue transaction disputes. Consequently, we eliminate the chargeback risk by offering your shoppers a refund for the disputed orders. This process takes the pain of dealing with chargebacks off your shoulders and streamlines the resolution of this type of issue.

Chargeback reasons

Analyzing shopper behavior in our system, the most frequent chargeback reasons fall in one of the following categories:

  • Customers dissatisfied with the product/service
  • Customers haven't received the product/service access
  • Customers don't recognize the transaction on their account statement

Keep in mind that when chargebacks occur, the transaction value is not the only sum that you lose. You also need to pay extra fees, such as:

  • Operational costs for the resources needed to fight the dispute together with our team
  • The 2Checkout commission, non-refundable even if the customer loses the dispute
  • The 2Checkout chargeback fee (if applicable).

Additionally, continued chargeback requests exceeding certain thresholds defined by VISA, MasterCard, or American Express subject you to chargeback monitoring programs.

Statistics show that bad customer experience news reaches over 100% more potential customers than good customer experience praise. This leads to a high number of negatively influenced potential customers who won't buy your products, even if they haven't had any experience with you as a merchant. Word of mouth is a powerful tool to skew buying decisions.

How to lower chargeback rates

Avoid chargebacks and improve the overall experience offered to your customers by following a few guidelines:

  1. Understand the chargeback reasons. 
  2. Offer a high-quality product or service. Low-quality products and services are at the top of the list when it comes to chargeback reasons. If your customers feel that they did not receive the product or service that they expected, they are likely to attempt to get a refund. Further down the road, if they can't get in touch with you, or if you refuse to provide a refund, they might request a chargeback.
  3. Offer clear product details. Use clear and concise product descriptions together with screenshots or demos that your customers can watch to learn what to expect after purchasing the product/service.
  4. Be transparent about your billing policy. Customize your statement information and inform your customers about the data they should see on their credit card statements upon purchase and/or billing. Keep in mind that they could receive their credit card statements weeks after the initial purchase, depending on your billing cycles, so make sure to tell them where their money goes!
  5. Provide flawless customer service. Make sure your customer service contact information is easily accessible on your website. Additionally, provide contact information in your order confirmation emails. Keep track of customer inquiries and communicate with them before purchase if they need extra information. You can greatly reduce the chance of chargebacks if your customers can easily get in touch with you and get the issue resolved.
  6. Cancel inactive auto-renewing accounts. Keep an eye on the usage history of your customers' purchases. There's no point in renewing a subscription that hasn't been used in the past 6 months (or more). Avoid chargebacks in these situations by notifying your customers about their inactivity before you charge them for another billing cycle.
  7. Offer easy-to-use self-service features. Your shoppers can keep an eye on their order status and disable auto-renewing subscriptions through 2Checkout myAccount.
  8. Offer refunds and be transparent about it. The whole point of chargebacks is to protect your customers against fraud. Naturally, chargeback policies are developed in favor of the customer. Chances are that if someone isn't satisfied with your product or service, they will get their money back, whether you like it or not. So why not spare yourself the hassle and refund the orders that don't rise to the customer's expectations? Make sure to inform the customers when the refund should be processed and how long it should take before they get their money back.
  9. Confirm customer identity. Use advanced tools, such as 3-D Secure and Address Verification System. Enrollment in 3-D Secure prevents your customers from asking for chargebacks.

Implemented accordingly, these recommendations should help you lower your chargeback rates and improve the overall customer satisfaction with your products or services.

Retrieve an order

Overview

Use the getOrder method to retrieve details on a specific order placed with dynamic product information, or catalog products, using the unique, system-generated reference.

Parameters

Parameters Type/Description

sessionID

Required (string)

 

Session identifier, the output of the Login method. Include sessionID into all your requests. 2Checkout throws an exception if the values are incorrect.  The sessionID expires in 10 minutes.

orderReference

Required (string)

 

Order reference number of an older order, which is already approved/paid.

skipPartnerOrders Optional (boolean)
 

Default value = TRUE. 

Decides if the partner orders should be retrieved or not. By default, they are skipped and instead of returning the partner order according to the orderReference, it will return the master order.

Response

Parameters Type/Description

Order information

Object (orders with catalog products)

Order information Object (orders with dynamic product information)
WSOrder String

 

   Only orders with STATUS = COMPLETE are returned when placing a  getOrder  API call.

Request 

<?php

require ('PATH_TO_AUTH');

$orderReference = 'YOUR_ORDER_REFERENCE';
$skipPartnerOrders = 'FALSE';

try {
    $fullOrderDetails = $client->getOrder ($sessionID, $orderReference, $skipPartnerOrders);
}
catch (SoapFault $e) {
    echo "fullOrderDetails: " . $e->getMessage();
    exit;
}
var_dump("fullOrderDetails", $fullOrderDetails);
?>

 

Integrate OpenCart

Overview

OpenCart is a free open-source eCommerce platform for seasoned web developers looking for a user-friendly interface and for shop owners just launching their online business.

Availability

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

   OpenCart 4 is not supported.

Integrate OpenCart with 2Checkout

Whether you are an existing merchant using OpenCart and you need to upgrade your integration, or you are a new merchant looking to integrate with 2Checkout, you need to follow the instructions below.

OpenCart Settings

  1. Download the 2Checkout payment module from Github.
  2. Upload the files to your server under your store’s directory.
    OpenCart_integration_new_1.png
  3. Sign in to your OpenCart admin.
  4. Navigate to Extensions → Installer.
    OpenCart_integration_new_2.png
  5. On the Extension Installer page, click on Upload to upload your extension files.
    OpenCart_integration_new_3.png
  6. Go to Extensions → Choose the extension type and select the Payments extension type from the drop-down list.
    OpenCart_integration_new_4.png
  7. Click Install on the payment option you want to use (2Checkout API, 2Checkout Convert Plus, 2Checkout Inline).
  8. Click on the Edit button of the selected integration to enable it.
    OpenCart_integration_new_5.png
  9. Configure your 2Checkout integration by editing the details of the 2Checkout API, 2Checkout ConvertPlus, or 2Checkout InLine, as shown in the next image.

    • Input your Merchant Code, Secret Key, and Buy-link Secret Word from the 2Checkout Merchant Control Panel into the OpenCart admin. 
    • To obtain the Merchant Code, log in to your 2Checkout Merchant Control Panel.
    • Navigate to Integrations → Webhooks & API → Merchant Code and copy and paste the code into the OpenCart admin area.
    • Then copy and paste the Secret Key from the 2Checkout Control Panel into the OpenCart admin.
    • Go to Integrations → Webhooks & API → Secret Word → Buy-Link secret word and copy and paste the buy-link secret word into the OpenCart admin. 

    OpenCart_integration_new_6.png

  10. Under Test Mode select No for live sales or Yes for test sales.
  11. Select Complete under Order Status.
  12. Select Enabled under Status.
  13. Save your changes.

2Checkout Settings

  1. Sign in to your 2Checkout Merchant Control Panel account.
  2. Navigate to Dashboard → Integrations → Webhooks & API section.
  3. 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
      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 OpenCart and select the SHA 2 / SHA 3 hash.
      Add IPN URL
    • Enable all triggers and response tags.
      OpenCart_integration_new_8.png

2Checkout PayPal Direct Setup

OpenCart Settings

  1. Sign in to your OpenCart admin.
  2. Click Extensions tab and Payments subtab.
  3. Under 2Checkout PayPal Direct click Install and then click Edit.
  4. Enter your 2Checkout Merchant Code.
  5. Select Complete under Order Status.
  6. Select Enabled under Status.
  7. Enter your Secret Word (Must be the same value entered on your 2Checkout Site Management page.)
  8. Save your changes.

2Checkout Settings:

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

About OpenCart

 
OpenCart si a free open-source eCommerce platform for web developers looking for a user-friendly interface and for shop owners just launching their online business. More than 30,000 companies, mostly small and medium businesses from the US, are using OpenCart in the retail industry. OpenCart offers support for both physical and digital products, as well as services.

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