Skip to main content

Download Insurance Service (DIS) Guide

Overview

Offer your customers the opportunity to purchase Download Insurance Service (DIS) during the ordering process, and enable them to download a file assigned to your products for an extended period of time, either by accessing a link sent via email or by logging in to 2Checkout myAccount. 2Checkout will store and serve all insured product files.

Availability

All 2Checkout accounts.

Benefits

  • Product file availability extended to 24 months – Download Insurance Service overrides the default product file download settings and offers shoppers that purchased your offerings unrestricted access to product files for as much as two (2) years.
  • Unlimited number of downloads – DIS also contributes to removing any download restrictions, ensuring that files can be downloaded as many times as needed for the entire 24 months after purchases are made.

If the customer does not purchase DIS, by default, product file downloads are available only for a limited period of time, namely a maximum of two (2) weeks. In addition, the number of times that the product files can be accessed and downloaded is also limited to just 3 (three) tries.

Global Download Insurance Service (DIS)

Global DIS settings can be configured from the Merchant Control Panel.

  1. Log in to your Merchant Control Panel.
  2. Navigate to Setup → Fulfillment.
  3. Click on the Download Insurance tab.

fulfillment_cpanel.png

As it's treated the same as any additional product when added to the cart, the Download Insurance feature has a unique product ID, product name (Download Insurance Service), and product code (DOWNLOAD_INSURANCE), although some functionalities, including quantity, won't be available to your shoppers.

Price Settings and Fees

2Checkout charges you a service fee when you offer DIS to customers, based on the size of the file stored on the 2Checkout servers that shoppers are offered for download. The fees are clearly displayed in the Merchant Control Panel, on the Download Insurance Service page, in the Prices section (see the image above).

The 2Checkout commission is applied to the entire transactional value of orders including the DIS costs, even if the DIS service fee is also paid.

You can set up your own pricing for DIS for all transactional currencies activated for your account, also in accordance with the size of the file offered to your shoppers. The prices you define here are those that your customers will see in the cart and ultimately pay when ordering DIS.

You can define DIS prices in a single transactional currency activated for your account and the 2Checkout system will convert them into all other currencies available to shoppers. The prices set up for the active currency will be converted automatically into currencies that do not feature pricing details.

Since you have complete control over all of the prices, regardless of transactional currency, you can configure specific prices as a part of your localization currency. This way, customers in specific markets worldwide will see the prices you defined for their local currency.

The total price of this service is calculated based on the total size in MB of the DIS product files in the shopping cart. For example, if product A has assigned a file of 10MB and product B has a file of 13MB, the total price will be calculated from the range of 16MB – 50MB for the total of 25MB per order. Purchased individually, the total price will be calculated from the range of 0MB - 15MB.

  • Net price – VAT is added to this price where VAT is applicable. Customers liable to VAT will pay the net price + VAT and customers exempt from VAT will pay the net price.
  • Gross prices – Final price paid by the customer, regardless of VAT applicability. Where VAT is applicable, 2Checkout deducts VAT from the gross price so the final product price (including VAT) remains unchanged. Customers liable to VAT and customers exempt from VAT will pay the same price. In cases where VAT is applied, you will receive less for the sale.

Set up product files

To upload product files, follow these steps:

  1. Log in to your Merchant Control Panel.
  2. Navigate to Setup → Fulfillment.
  3. Click on the Product Files tab.

fulfillment_product files.png

4. On the Product files page, you can use the file manager to:

  • Specify a display name
  • Specify a file version
  • Upload files
  • Delete files
  • Replace files
  • Edit files

fulfillment_product files_1.png

The default disk space available is 200 MB, a number that coincides with the size of the upload file. For more space and for the ability to upload larger files, contact 2Checkout directly.

When editing uploaded product files you can:

  • Change display name
  • Change file version
  • Delete file. Delete files option is only available when no active download links exist for product files. You won't be allowed to remove a product file for two years from the moment one of your shoppers acquired the product it was assigned to as well as the DIS option.
  • Replace file. Please note that if this file has Download Insurance Service enabled, all users who have purchased this service will have the latest file available for download and not the original file. If this is not the default behavior for major updates of an already existing product, you can leave this file as is and add a separate one. The old file will be available for previous version purchases while the new file will be available for purchases for the new version.

Assign products to files

To assign products to files, follow the steps below:

  1. Log in to your Merchant Control Panel.
  2. Navigate to Setup → Fulfillment.
  3. Click on the Product Files tab.
  4. Click to edit a product file.

edit DIS.png

5. On the next page, scroll down to the bottom. In the Assign products area, you'll be able to select one or multiple offerings configured in the 2Checkout platform and associate them simultaneously with the product file you're editing. When assigning the product file, you can opt to make it available for:

  • Download
  • Download Insurance Service (DIS)
  • Partner (in their Partner Control Panel)

DIS_assign products.png

You can also assign files to products.

Configure the Download Insurance Service (DIS)

The DIS is considered an extra delivery 2Checkout service. DIS is offered to your shoppers only when you select the Electronic delivery type under the Fulfillment tab for your offering as:

  • 2Checkout delivery (binary keys, activation codes, product file, DIS), or
  • Delivery made by you (you need to confirm order fulfillment in 2Checkout through IDN or manually to complete orders).

When selecting the No delivery needed (subscription-based applications, access to services, etc.) option for a specific product, 2Checkout won't offer shoppers DIS.

When editing a product, make sure that the DIS (Download insurance service) option is checked under the Delivery content & methods section. Once checked, this option will display the Product file area, enabling you to select a product file from a list of item you uploaded. Check the box next to the Display to partners in their Partner Control Panel if you want the file to be shared with your partners.

Include the pre-checked DIS option when generating buy-links

When generating buy-links for your products you can opt to:

  • Display Download Insurance Service in the shopping cart and leave it up to shoppers to decide if they acquire it or not
  • Have DIS auto-selected in the shopping cart in addition to being displayed, but leave shoppers the possibility to opt-out and not acquire it they so prefer.

To include the pre-checked DIS option when you generate buy-links, follow the steps below:

  1. Log in to your Merchant Control Panel.
  2. Go to Setup → Generate Links.
  3. Expand the advance options drop-down.
  4. Scroll down to the Overwrite extra options in the shopping cart section and check the Auto-select download insurance option box. Checking this box will automatically display the option as pre-selected in the shopping cart for shoppers.

DIS_generatelinks.png

When you generate a URL to sell products with the DIS option automatically selected in the cart, the &CHK_DIS parameter is added to the created buy-link, as in the example below.

This is a standard buy-link that will let shoppers opt-in to purchase DIS in addition to your product:

https://secure.2checkout.com/order/cart.php?PRODS=1234567&QTY=1

The following is a buy-link that will display the DIS option as pre-checked in the cart and allow shoppers to opt-out of acquiring the extra service if they so choose. Note that the &CHK_DIS parameter was added at the end.

https://secure.2checkout.com/order/cart.php?PRODS=1234567&QTY=1&CHK_DIS
The links displayed above are offered only for demo purposes and are not functional, hence the use of the 1234567 dummy product ID.

Use the A/B testing capabilities of the 2Checkout platform in order to try out different scenarios which increase the level of control over how DIS is offered to shoppers.

Add the DIS option directly to the shopping cart when generating buy-links

When building buy-links you have the option to not only include the pre-checked DIS option but also to add it to the cart. Note that shoppers will still have the option to remove DIS.

1. Let's assume that the following is the standard buy-link generated by the 2Checkout system:

https://secure.2checkout.com/order/checkout.php?PRODS=1234567&QTY=1

2. And let's also assume that the product ID for your DIS option is 667788.

3. To create a buy-link that will have DIS automatically pre-checked and added to cart, treat DIS as another product:

https://secure.2checkout.com/order/checkout.php?PRODS=1234567,667788&QTY=1

Use the A/B testing capabilities of the 2Checkout platform in order to try out different scenarios which increase the level of control over how DIS is offered to shoppers.

A/B Testing DIS

When configuring an A/B test for Download Insurance Service options, the following options are available:

  • Display Download Insurance Service in shopping cart
  • Force Download Insurance Service into the shopping cart
  • Download Insurance Service checkbox will be pre-checked
  • Download Insurance Service will be added automatically in the shopping cart

Read the 2Checkout A/B testing guide for details on how to use 2Checkout's A/B testing technology to see how your customers will respond to various scenarios involving DIS.

Disable Download Insurance Service (DIS)

You can disable DIS by following these steps:

  1. Log in to your Merchant Control Panel.
  2. Navigate to Setup → Fulfillment.
  3. Click on the Download Insurance tab.
  4. Select No for the Enable download insurance service option.
  5. Scroll down to the bottom of the page, and hit the Save settings button.

disable DIS.png

You can re-enable DIS at any time, and the 2Checkout system will begin adding Download Insurance Service to the shopping cart once again.

Reporting

The following reports are also designed to centralize and display data on Download Insurance Service: 

F.A.Q.

1. Why isn't DIS displayed multiple times in the shopping cart when shoppers order multiple products, each with its own Download Insurance Service option?

DIS is displayed only as a standalone product in the shopping cart even when multiple products, each with its own DIS settings, are purchased simultaneously. The 2Checkout system is designed to calculate the total price of DIS based on the size of the downloadable product file and the price details you configured.

Set partner

Overview

Set the partner for the current shopping cart session. It's mandatory to set the partner for the current cart session to use all Channel Manager methods with the exception of logingetPartnerByCode, getPartnerSingleSignOn and searchPartners.

Parameters

Parameter Type/Description
sessionID Required (string)
  Session identifier, output of the Login method. An exception will be thrown if the values are incorrect.
partnerCode Required (string)
  Unique identifier that you need to specify when creating a partner in the Control Panel. You can find it under the General Information area when editing partner details.

Response

Parameter Type/Description
Result Boolean
  True or false

Request

<?php

require('PATH_TO_AUTH'); // Authentication example: https://knowledgecenter.avangate.com/Integration/Channel_Manager_API/SOAP/02Authentication

$partnerCode = 'YOUR_PARTNER_CODE'; // the partner code assigned to the partner account you want to set

try { 
    $Partner= $client->setPartner($sessionID, $partnerCode); 
} catch (SoapFault $e) {
    echo "Partner: " . $e->getMessage(); 
    exit; 
}

var_dump ("Partner", $Partner);

?>

Errors

Error Description

INVALID_PARTNER

Partner code is mandatory.

INVALID_PARTNER

Provided partner code is not associated with an active partner account in the Avangate system.

 

Subscription history

Overview

Retrieve information about a subscription.

Parameters

Parameters

Type/Description

ReferenceNo

String

 

Unique, system-generated order reference number.

Type

String

 

Purchase type:

  • SALE
  • RENEWAL
  • UPGRADE

SubscriptionReference

String

 

Unique, system-generated subscription reference.

StartDate

String

 

Subscription start date(YYYY-MM-DD) - StartDate is mandatory when importing subscription data. If you changed the time zone for the Avangate API by editing system settings under Account settings, then the StartDate you provide must be in accordance with your custom configuration.

ExpirationDate

String

 

Subscription expiration date(YYYY-MM-DD) - ExpirationDate is mandatory when importing subscription data. If you changed the time zone for the Avangate API by editing system settings under Account settings, then the ExpirationDate you provide must be in accordance with your custom configuration.

Lifetime

Boolean

 

Possible values:

  • True – the subscription is evergreen

False – the subscription has a recurring billing cycle less than or equal to three years.

SKU

String

 

Stock keeping unit you defined.

DeliveryInfo

Object

 

Object with information about the delivery made to the customer - structure described below

PartnerCode

String

 

Possible values:

  • Empty = ecommerce order
  • Partner Code

 

 

Place a renewal order

Overview

Renew a subscription and collect recurring revenue using the 2Checkout Subscription Reference. You can renew subscriptions for both catalog and dynamic products. 

Requirements

To place a renewal order, you need to provide a valid subscription reference number.

Payment methods

You can place renewal orders using the following payment methods:

  • Credit/Debit cards: Visa, Visa Electron, MasterCard, Maestro, Amex, Discover, Dankort, Carte Bleue, JCB. 2Checkout supports local Brazilian cards.
  • PayPal and PayPal Express
  • Purchase Order
  • Wire
  • Check
  • WeChat Pay
  • iDEAL
  • Alipay
  • Trustly
  • TEST orders
  • Free orders (no payment information required)
  • Previous order references - In addition to the payment methods enumerated above, 2Checkout also supports 1-click purchase flows in which you use valid previous order references belonging to returning customers to pay for new orders with their previously used cards and PayPal accounts.
  • Order with installments
  • ApplePay
  • 2Pay.js
  • Boleto/Pix
  • Google Pay

Use the PaymentDetails object to change the payment method used in the ordering process.

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.
Order Required (Object)
 

Object designed to collect all data necessary for an order, including billing, product/subscription plan and payment details.

To place an order with PayPal rather than PayPal Express, use PAYPAL as the type of the PaymentDetails object and send the shopper email and a return URL as part of the PaymentMethod object. See code sample. 

SubscriptionReference

Required (String)

2Checkout generated subscription reference number. E.q. A8C5671BFE.

Response

 
Parameters Type/Description
Order information Object

Request

<?php

require ('PATH_TO_AUTH');

$Order = new stdClass();
$Order->Currency = 'USD';
$Order->Language = "EN";
$Order->Country = 'US';
$Order->CustomerIP = '91.220.121.21';
$Order->Source = "sourceAPI.net";
$Order->LocalTime = date('Y-m-d H:i:s');
$Order->Items = array();

/**/
$Order->Items[0]->RenewalInformation = new stdClass();
$Order->Items[0]->RenewalInformation->SubscriptionReference = 'A8C5671BFE'; //subscription used in the renewal process
$Order->Items[0]->Price = new stdClass();
$Order->Items[0]->Price->Type = 'CUSTOM';
$Order->Items[0]->Price->Amount = '10';
$Order->Items[0]->PriceOptions = array('uniqscale1=4');//

$Order->MachineId = "MachineID";

$Order->BillingDetails = new stdClass();
$Order->BillingDetails->Address1 = 'Bil1ing address';
$Order->BillingDetails->Address2 = 'Billing address 2';
$Order->BillingDetails->City = 'Billing City';
$Order->BillingDetails->State = 'Billing State';
$Order->BillingDetails->CountryCode = 'US';
$Order->BillingDetails->Phone = 1231232123;
$Order->BillingDetails->Email = 'customer_details@test.com';
$Order->BillingDetails->FirstName = 'First';
$Order->BillingDetails->LastName = 'Customer';
$Order->BillingDetails->Company = 'Billing Company';
$Order->BillingDetails->Zip = '55104';

$Order->DeliveryDetails = new stdClass();
$Order->DeliveryDetails->Address1 = 'Bil1ing address';
$Order->DeliveryDetails->Address2 = 'Billing address 2';
$Order->DeliveryDetails->City = 'Billing City';
$Order->DeliveryDetails->State = 'Billing State';
$Order->DeliveryDetails->CountryCode = 'US';
$Order->DeliveryDetails->Phone = '12345';
$Order->DeliveryDetails->Email = 'customer_details@test.com';
$Order->DeliveryDetails->FirstName = 'First';
$Order->DeliveryDetails->LastName = 'Customer';
$Order->DeliveryDetails->Zip = "55104";

$Order->PaymentDetails = new stdClass();
$Order->PaymentDetails->Type = "CC";
$Order->PaymentDetails->Currency = $currency;

$Order->PaymentDetails->PaymentMethod = new stdClass();
/**/
$Order->PaymentDetails->PaymentMethod->CardNumber = "4111111111111111";
$Order->PaymentDetails->PaymentMethod->CardType = "VISA";
$Order->PaymentDetails->PaymentMethod->ExpirationYear = "2019";
$Order->PaymentDetails->PaymentMethod->ExpirationMonth = "12";
$Order->PaymentDetails->PaymentMethod->CCID = "123";
$Order->PaymentDetails->PaymentMethod->HolderName = "John Doe";
$Order->PaymentDetails->PaymentMethod->RecurringEnabled = TRUE;
$Order->PaymentDetails->PaymentMethod->HolderNameTime = 1;
$Order->PaymentDetails->PaymentMethod->CardNumberTime = 1;
/**/


$jsonRpcRequest = new stdClass();
$jsonRpcRequest->jsonrpc = '2.0';
$jsonRpcRequest->method = 'placeOrder';
$jsonRpcRequest->params = array($sessionID, $Order);
$jsonRpcRequest->id = $i++;

$placeOrder = callRPC($jsonRpcRequest, $host);

var_dump ($placeOrder);
 

Pricing configuration

Overview

Use this object to add/create and update/edit pricing configurations for your account. You can assign one or multiple price option groups to pricing configurations.

You identify a pricing configuration using its unique identifier: Code.

Parameters

Parameters Type/Description

Name

Required. String

 

Pricing configuration name.

Default

Boolean

 

True for the default pricing configuration

BillingCountries

Array of strings

 

ISO codes of the countries assigned to the pricing configuration.

Empty unless a pricing configuration has specific countries assigned.

PricingSchema

String

 

DYNAMIC – With a base price

FLAT – Without a base price

PriceType

String

 

Possible values:

• NET

• GROSS

DefaultCurrency

String

 

The ISO code of the default currency for the pricing configuration

Prices

Object

 

Details below.

 

Regular

Array of objects

 

 

Details below.

 

 

Amount

Int

 

 

 

The price of the product. Use -1 to delete it.

 

 

Currency

String

 

 

 

ISO code of the currency for the product price.

 

 

MinQuantity

Int

 

 

 

The minimum quantity of volume discounts. Default is 1.

 

 

MaxQuantity

Int

 

 

 

The maximum quantity of volume discounts. Default is 99999.

 

 

OptionCodes

Array of objects

 

 

 

Details below.

 

 

 

Code

String

 

 

 

 

System generated pricing options group code (you can also configure it) that the 2Checkout system uses to calculate product prices for pricing configurations without a base price.

 

 

 

Options

StringArray

 

 

 

 

The pricing options group option code you configured that the 2Checkout system uses to calculate product prices for pricing configurations without a base price.

 

Renewal

Array of objects

 

 

Details below.

 

 

Amount

Int

 

 

 

The price of the product. Use -1 to delete it.

 

 

Currency

String

 

 

 

ISO code of the currency for the product price.

 

 

MinQuantity

Int

 

 

 

The minimum quantity of volume discounts. Default is 1.

 

 

MaxQuantity

Int

 

 

 

The maximum quantity of volume discounts. Default is 99999.

 

 

OptionCodes

Array of objects

 

 

 

Details below.

PriceOptions

Array of objects

 

Details below.

 

Code

String

 

 

System generated pricing options group code (you can also configure it) that the 2Checkout system uses to calculate product prices for pricing configurations without a base price.

 

Required

Boolean

 

 

true – you set the price options group as required during the purchase process.

false - you did not set the price options group as required during the purchase process.

 

 

ConvertPlus Cart Editor

Overview

You are now able to customize the payment experience of your customers by adding your own vision to the display of the shopping cart pages. The new ConvertPlus Cart Editor module gives you control over shopping cart elements, by providing an easy-to-use visual interface for your customizations. Cart Editor allows you to define new styles for texts displayed in the shopping cart, add new designs for buttons, select new colors for different cart elements, and many others.

 

Related links

Availability

Cart Editor is available on all accounts that have ConvertPlus enabled. Contact 2Checkout for more details on ConvertPlus activation.

Cart themes

You can edit the following themes using ConvertPlus Cart Editor. Make a copy of the theme you want to edit, and add your own style and vision to the future shopping cart pages.

One column with payment buttons

This template can be used by all companies looking to increase their conversion rates by using a smart display of the billing and payment information fields in the cart. The short form helps you increase conversion rates, as only mandatory billing fields are displayed. Billing details and card information are presented in one column, making the payment experience smoother for your shoppers.

The display order of the payment methods in the cart reflects their popularity based on the selected billing country.

The input of card information is easier and clearer as the cart auto-detects the card type after typing the first digits of the card. The theme has a responsive design on devices such as desktop, tablet, and smartphone.

ConvertPlus default

The ConvertPlus default template is designed to help you increase conversion rates by embedding the industry’s best practices. Billing details and card information are displayed inline, offering customers a fast and secure checkout. To improve the payment experience for your shoppers, the cart contains a short billing form, having only the mandatory fields displayed.

Shopper’s country/state is detected and pre-filled based on geo-location. The input of card information is easier and clearer as the cart auto-detects the card type after typing the first digits of the card. The display order of the payment methods in the cart reflects their popularity based on the selected billing country.

We're building and adding new features continually, check out the full list of supported functionalities and the current limitations.

Edit a cart theme

Follow the steps below to edit and publish a customized theme:

  1. Log in to the 2Checkout Merchant Control Panel.
  2. Go to Setup -> Interface templates.
  3. Click on ConvertPlus located right near the Default flows tab.
  4. Select the theme you want to edit and click Make a copy.
  5. Once redirected in the editing visual interface, use the menu from the left side to customize the theme selected. You can apply general customizations on the cart template by changing the properties of different elements, such as links, buttons, panels, messages, logos from the Branding drop-down list. You can also edit specific sections of the cart by using the Cart items, Billing details, Payment details, and Footer drop-down sections.
  6. Rename your customized theme by clicking on the current theme title and by adding a new text in the edit box. Save the changes by clicking on the save icon.
  7. You can preview and apply any customization made to the cart by using the Preview and Apply buttons from the menu.
  8. From the drop-down list located in the top right corner, you can change the page you are customizing (checkout or landing page/retry page/finish page). Add consistency to your work by editing all the pages.
  9. Check how your customized theme would look on different devices, by switching between the different device icons displayed in the top right corner.
  10. After you apply the changes, click on Save changes to save your customization.
  11. Click Close to return to the Interface templates page, or Publish, to make your customization available for creating links in the Generate Links area.

General customizations

ConvertPlus Cart Editor allows you to customize different elements of the shopping cart pages, leading to a personalized payment experience for your shoppers. You can apply general styling to your cart pages by editing the following elements:

  • Body - Personalize the properties from the page body by adding your own styling to the font and colors used. Go to Branding > Body to make the desired changes on body attributes.
  • Logo - You can easily add your own logo to the shopping cart page, while also reserving the option of hiding the logo image. Click on Branding > Logo drop-down list to control the display of your logo.
  • Fields - You have advanced control over the fields display, with the ability to customize the field properties such as background color, border type, label and input colors. You can also control the display of the error messages that might be triggered on cart fields, by adding style to error background/border and label. Click on Branding > Fields to customize your fields.
  • Links - You can personalize the display of the links from your shopping cart pages. Select a new color, or choose a different text-decoration for the cart links from Branding > Links.
  • Panels - Customize the display of the shopping cart panels from Branding > Panels. You have total control over the text properties, while also being able to make advanced customizations on the padding, color and border attributes of your panels.
  • Buttons -  You can change how buttons are displayed in the cart from Branding > Buttons. You have access to a variety of properties for buttons customization, such as: setting default/primary/success colors, adding new border types or setting new text properties.
  • Messages - Change the font properties of the messages displayed in the shopping cart pages, both success and error-related, from Branding > Messages.
  • Trust logo - Select a display type for the trust logo shown in the cart page by clicking on Branding > Trust logo.

Advanced customizations

In case you want to apply advanced customizations to a cart theme, you can add a different styling to each shopping cart section. ConvertPlus Cart Editor allows you to customize each segment of the cart in a different way, as part of your goal of giving customers a personalized payment experience.

Advanced customizations have priority over the changes made from the Branding menu. For instance, if you edit the color of the links from the Branding menu to red, all the links from the page you are editing will be red. However, by setting the link color from the Cart items section to blue, you are overwriting the customization for this section, and the links color from the Cart items segment will be blue.

Cart Items

Add a different styling to the cart items section from the shopping cart page, by clicking on the Cart items drop-down list. Customize the display of product title, image, quantity and price in the cart by editing the properties of these elements. You are able to add a detailed styling to the coupon box by clicking on Promotion, and you can do advanced customizations to the Delete button, Cart total, and Taxes elements.

Billing details

You can customize the second section of the checkout page by clicking on the Billing details drop-down list. Add your own design to the text properties, background color and border types that compose the environment into which shoppers enter their billing information.

Payment details

You can apply different styling to the payment details section by editing the properties from the Payment details drop-down list. Add a different design to this section by customizing properties such as border type, background color, font size and type to give shoppers a unique experience when they are adding their payment information.

Footer

Click on the Footer drop-down list to start customizing the footer element. You can apply different styling to properties such as border, text and background color.

Search SKU codes

Overview

Use the searchSku method to perform product SKU search calls with the below parameters.

Request Parameters

Parameters Required Type Description
ProductCode Required String The product code that you can define for each of your offerings. Needs to be unique.
PricingConfigurations Required Array of objects  

Code

Required String  

Currencies

Required Array of Objects ISO currency code.

Code

Required String  

PurchaseTypes

Required Array of objects Purchase type identifier. Possible values:
  • NEW_PRODUCT
  • RENEWAL
  • UPGRADE

Code

Required String  

QuantityIntervals

Required Object Numeric identifier of product quantity.

MinQuantity

Required Int  

MaxQuantity

Required Int  

PriceOptionGroups

Required Array of objects  

Code

Required String  

Options

Required Array of objects  

OptionValue

Required String  
Pagination Required Object  

Page

Required Int  

Limit

Required Int  

Request Example

<?php

require ('PATH_TO_AUTH');

$inputSchema = new \stdClass();
$inputSchema->ProductCode= '6B3CB17DDA_COPY1';

$pricingConfiguration = new \stdClass();
$pricingConfiguration->Code = 'E684EC99B0';

$currency = new \stdClass();
$currency->Code = 'EUR';
$pricingConfiguration->Currencies = [$currency];

$purchaseType = new \stdClass();
$purchaseType->Code = 'RENEWAL';
$pricingConfiguration->PurchaseTypes = [$purchaseType];

$quantityIntervals = new \stdClass();
$quantityIntervals->MinQuantity= 1;
$quantityIntervals->MaxQuantity= 10;
$pricingConfiguration->QuantityIntervals = [$quantityIntervals];

$pagination = new \stdClass();
$pagination->Page = 1;
$pagination->Limit = 10;

$inputSchema->PricingConfigurations = [$pricingConfiguration];
$inputSchema->Pagination = $pagination;


try {
    $skuData = $client->searchSku($sessionID, $inputSchema);
} catch (SoapFault $e) {
    echo "searchSku: " . $e->getMessage();
    exit;
}

var_dump("searchSku", $skuData);

Response Parameters

Parameters Type/Description
Items Object

{ProductCode}

Object. This element will be replaced by the code of the product.

SkuPricingOptions

Array of strings

Code

String

Details

Array

ProductSKU

String

Currency

String

FromQty

Int

ToQty

Int

PurchaseTypes

String

Groups

Array

GroupCode

String

Options

Array

               Name

String
                                                                                Value String

Errors

Array
Pagination Object

Limit

Int

Page

Int

Count

Int

Response Example

object(stdClass)#22 (2) {
    public $Items" =>
    object(stdClass)#21 (1) {
      public $6B3CB17DDA_COPY1 =>
      object(stdClass)#4 (2) {
        public $ProductCode =>
        string(18) "6B3CB17DDA_COPY1"
        public $SkuPricingOptions =>
        array(1) {
          [0]=>
          object(stdClass)#5 (3) {
            public $Code =>
            string(10) "E684EC99B0"
            public $Details =>
            array(5) {
              [0]=>
              object(stdClass)#6 (7) {
                public $ProductSKU =>
                string(4) "Product_Test_SKU_008899"
                public $Currency =>
                string(4) "EUR"
                public $FromQty =>
                int(1)
                public $ToQty =>
                int(10)
                public $PurchaseType =>
                string(11) "RENEWAL"
                public $Groups =>
                array(1) {
                  [0]=>
                  object(stdClass)#7 (2) {
                    public $GroupCode =>
                    string(7) "GRUP_2"
                    public $Options =>
                    array(1) {
                      [0]=>
                      object(stdClass)#8 (2) {
                        public $Name =>
                        string(7) "grup 2"
                        public $Value =>
                        string(4) "option_code_4"
                      }
                    }
                  }
                }
                public $Options =>
                string(32) "a:1:{i:16885;a:1:{i:0;i:78164;}}"
              }
              [1]=>
              object(stdClass)#9 (7) {
                public $ProductSKU =>
                string(4) "Product_Test_SKU_008902"
                public $Currency =>
                string(4) "EUR"
                public $FromQty =>
                int(1)
                public $ToQty =>
                int(10)
                public $PurchaseType =>
                string(11) "RENEWAL"
                public $Groups =>
                array(1) {
                  [0]=>
                  object(stdClass)#10 (2) {
                    public $GroupCode =>
                    string(7) "GRUP_2"
                    public $Options =>
                    array(1) {
                      [0]=>
                      object(stdClass)#11 (2) {
                        public $Name =>
                        string(6) "grup 2"
                        public $Value =>
                        string(13) "option_code_4"
                      }
                    }
                  }
                }
                public $Options =>
                string(6) "a:0:{}"
              }
            public $Errors =>
            array(0) {
            }
          }
        }
      }
    }
    public $Pagination =>
    object(stdClass)#23 (3) {
      public $Limit =>
      int(10)
      public $Page =>
      int(1)
      public $Count =>
      int(5)
    }

Next renewal price

Overview

The object below is returned directly or within a successful response from the following API requests:

Retrieve next renewal price

Next renewal price object

Parameters Type/Description

NetPrice

Double

 

Price without taxes

NetCurrency

String

 

Currency for the price without taxes. The currency ISO code used for the payment - ISO 4217.

FinalPrice

Double

 

Price with taxes

FinalCurrency

String

 

Currency used for prices with taxes. The currency ISO code used for the payment - ISO 4217.

SEPA Direct Debit

Overview

A type of payment that the bank makes by accessing funds from an account when the holder instructs it to do so. Money can be drawn either at the time of sale but also when a bill is due, and the transactions can be preauthorized, which is why Direct Debit is also referred to as pre-authorized debit (PAD) or pre-authorized payment (PAP).

Approximately 20% of online payments in Germany in 2010 were made using ELV (Direct Debit), with the number decreasing from 33% in 2009. ELV's share of online transactions has continued to decrease, and is now at under 10% in Germany. 24% of non-cash transactions in Europe in 2010 involved Direct Debit.

Introduction

SEPA stands for Single Euro Payment Area, a European regulatory initiative that creates a standard format for processing transactions in 33 markets across Europe. SEPA Direct Debit blur the lines between cross-border and domestic payments.

Compliance requirements

  • The deadline for the migration was February 1st, 2014 - extended until  August 1st.
  • The deadline for non-EU countries was February 1st 2016.

Countries impacted by SEPA

SEPA covers the existing 28 EU member states of the European Union, together with Iceland, Lichtenstein, Monaco, Norway and Switzerland):

Austria, Belgium, Bulgaria, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Monaco, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Switzerland, United Kingdom.

Countries covered by 2Checkout

Germany, the Netherlands, Spain, Belgium, France and Austria for Direct Debit.

Impact at 2Checkout

  • Direct Debit, and iDeal
  • Local wire transfers you receive from 2Checkout if you're company is headquartered in a market covered by SEPA.

IBAN and BIC

IBAN (International Bank Account Number) and BIC (Business Identifier Code) need to be used exclusively as account and bank identifiers for SEPA transactions. Pre-SEPA they were required only for cross-border payments and moving forward they will also apply to domestic payments.

  • 2Checkout will require IBAN and BIC information from shoppers paying with Direct Debit from Germany, the Netherlands, Spain, Belgium, France and Austria (instead of national sort codes and account number).
  • 2Checkout will provide IBAN and BIC details for its own account and bank to shoppers using wire transfers.
  • 2Checkout will pay vendors using IBAN and BIC info for their accounts and banks.
  • 2Checkout will update bank and account information for existing customers/subscribers, using the data for automatic subscription renewal charges.

Mandates and E-mandates

Shoppers authorize 2Checkout to collect a payments and instruct the their bank to pay those collections with SEPA mandates.

  • 2Checkout uses e-mandates and does not require shoppers to fill in and submit paperwork.
  • Mandates expire within 36 months after the last initiated collection.
  • 2Checkout stores mandates at least for 14 months after the last collection of funds.

Process changes

Pre-SEPA new purchase process

SEPA compliant new purchase process

1. Shoppers in Germany, the Netherlands, Spain, Belgium, France and Austria select Direct Debit as a payment method, provide their bank sort code and account number and place the order.

2. Order status: PENDING.

3. 2Checkout validates the Direct Debit details provided by shoppers and starts the process of funds collection.

4. 2Checkout Risk analysts approve orders using Direct Debit manually.

5. 2Checkout triggers the money transfer that usually takes a few days.

6. Order status: In progress / Processing.

7. Following fulfillment order status moves to COMPLETE.

 

1. Shoppers in Germany, the Netherlands, Spain, Belgium, France and Austria select Direct Debit as a payment method, provide their bank SWIFT code(BIC) and IBANinformation and place the order.

2. Order status: PENDING.

3. 2Checkout crates mandates (profiles) for payments

4. 2Checkout risk analysts approve orders using Direct Debit manually.

5. 2Checkout validates the signed mandate and stores mandates for at least 14 months.

6. 2Checkout will use mandates for future actions such as refunds and the renewal of subscriptions generated from the initial orders.

7. 2Checkout triggers the money transfer that usually takes a few days.

8. Order status: In progress / Processing.

9. Following fulfillment order status moves to COMPLETE.

 

Pre-SEPA auto-renewal process

SEPA compliant auto-renewal process

1. 2Checkout system creates orders to renew expiring subscriptions which are approved automatically.

2. 2Checkout triggers the money transfer that usually takes a few days.

3. Order status: In progress / Processing.

4. Following fulfillment order status moves to COMPLETE.

 

1. 2Checkout system creates an order to renew expiring subscriptions based in the mandate token for the initial order, and triggers the money transfer.

2. Order is approved automatically. Status: In progress / Processing.

3. Following fulfillment order status moves to COMPLETE.

Workflow

  1. Shoppers in the Netherlands, Germany, Spain, Belgium, France and Austria select Direct Debit as their preferred payment method.
  2. One the next page, they need to fill in their bank account information.

3. They'll be redirected to the Thank You page when the purchase is finalized.

Cart design changes

IBAN and SWIFT code will be collected during the purchase process.

Emails

Emails already communicate the due dates and billing amounts to customers (renewal notifications), along with 2Checkout's IBAN and SWIFT code (for follow-ups).

F.A.Q.

  1. What type of payments does SEPA govern?
    • Both single (one-off) and recurring Direct Debit collections. There's no limit on amounts transferred.
  2. What currency is used for money transfers?
    • While existing local currencies can still be used in the purchase process by consumers, money transfers will be done exclusively in Euro.
  3. What are the rules for refunds?
    • Payers can ask for a "no-questions-asked" refund right during the eight weeks (56 days) following the debiting of a payer's account. This period is extended to 13 months for unauthorized Direct Debit collections.

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