Overview

The Accounting area of the Partner Control Panel centralizes order payment data and enables partners to manage their invoices and refunds. Both you (merchant) and your partner can request refunds for paid partner invoices logged by the system. In case you request a refund, your partner will get an automatic notification of the approved reimbursement, along with the costs of the transaction.

Availability

Partners can request refunds for a period of up to one (1) year from the moment when an order was paid and the product delivered. Refunding a payment is only possible for up to one (1) year after the order was finished/delivered, older orders being considered final, reimbursements are no longer available.

Refunds management

The Partner Control Panel offers your partners refund management capabilities, including searching for reimbursements and viewing details. Under Accounting → Refunds, your partners can search for refunds based on partner number, refund number, or payment reference number, and setting a number of filters such as status, date of placement, and amount. This area displays all partner invoices for which a refund was requested. Partners can see the status of the refund, the amount granted during the refund operation. They can also access the details of a refund by clicking either on the refund number or on the View link and review the partner invoice info by selecting the partner number.

Refund new licenses

Partners can also request refunds on their own by accessing the paid partner invoice for which they want the costs of a transaction reimbursed.

Partner invoices are available either under Orders → All orders for a specific order or through Accounting → Partner Invoices. The latter path is recommended, since the partner invoice list also shows additional information including Status, a key piece of data, considering that only orders for which the payment was already transferred can be refunded.

In the Partner Invoices area, once the partner ran a search and identified the item for which they're requesting a refund, they can click on the partner number. In the area at the top of the screen under Partner status, they can select Request refund.

On the New Refund Request screen, partners can review the details of the original partner invoice and add comments. The request for a refund will be placed once the Place Refund Request button is clicked.

The status of the partner invoice will change from Paid to Pending approval. Following the automatic notification received from the system, you (merchant) can approve or reject the refund request. Refunds can be provided for the full costs of the transaction, as well as only for a partial amount. In either situation, partners will receive an email notification with your resolution.

Once the request refund is generated, the partner invoice will also be featured under Accounting - Refunds. The status of a refund will be updated to Complete for reimbursements that were approved and repaid.

All payment/invoice reference information necessary for the refund to be processed is automatically "pulled" into the refund module. A Credit Note for the approved refunded amount will be associated with the invoice that the refund was requested for. Each credit note has a corresponding negative payment record.

If the payment was done via 2Checkout eCommerce platform, by any payment methods available, the refunded amount will come from 2Checkout. If the payment was collected directly by you (merchant), via any payment method, then you are the one providing the refund.

Refund renewals

In addition to the transaction costs of new licenses, partners can also be reimbursed for renewals.

For this, partners can navigate to Accounting - Partner Invoice and search for the partner invoice of the renewal order that they want to be refunded. As long as the partner invoice was already paid, with the payment also reflected by its status, they can click on the partner number and then follow the same steps as when asking for a refund for a non-subscription license. As a result of the refunding process, all future renewal licenses will be canceled.

FAQs

1. Does 2Checkout send notifications for refunds?

   Yes. Both the merchant and the partner will receive notification emails with information on the evolution of the refund, regardless of whether it was approved or rejected, and also have the option of viewing the details of orders for which a refund was issued.

2. How is the refund reflected in the order status?

   After Total or Partial refunds are approved and the transaction sums reimbursed, the status of the orders changes to Complete.

3. How much time does it take for a transaction to be refunded?

   Once a refund was approved, reimbursement occurs in up to eight (8) business hours, if the initial payment was done through Visa/MasterCard/Eurocard, American Express. The refund amount will be available in the partner's bank account after the refund is processed, depending on the issuing bank.

   In scenarios in which the transaction was done through direct Bank/Wire transfer, 2Checkout will refund the money in several days after the partner provides all necessary financial details.

   Note: The merchant is solely responsible for reimbursing the payments the partner made through direct Bank/Wire transfer.

4. Can more than one refund be provided for the same order?

   No. Only a single refund can be issued per order. Once the transaction for an order has been refunded, either in part or the full amount, no additional refunds can be requested or provided. Note: Since the details of a refund are final, these should be correct before requesting reimbursement.

5. Can refunds be requested directly from 2Checkout?

   Yes. 2Checkout evaluates refund requests from both merchants and their partners. In case the partner contacts 2Checkout directly, the merchant will be notified via email and needs to reply as soon as possible.

6. Are there any costs associated with a refund?

   In case the refund is done through wire/bank transfer, the partner will need to cover the costs of the transaction - 2Checkout does not charge anything when refunding payments. Note: The order processing commissions paid by the merchant and received by 2Checkout will not be returned.

7. Can keycodes for a refunded product be reused?

   Keycodes for electronic delivery can be re-used, but 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.

8. What happens to refunded subscriptions?

   The transaction amount considered for reimbursement for subscriptions can be just the last payment or all payments 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 for which a partner invoice was already issued and paid associated with orders with a Complete status. Orders with one of the following status labels cannot be refunded: Pending approval, Refunded, Canceled, Payment under review, Rejected, Awaiting Payment, and Delivery needs more info.

Use the 2Checkout Channel Manager API to manage partner and reseller orders.

Availability 

The partner API methods are available only in tandem with the Channel Manager module.

Requirements 

Contact 2Checkout to start using the Channel manager API.

Overview

2Checkout added a new product attribute in the Merchant Control Panel, the Product Tax Category, to increase the accuracy of the tax determination and reporting process.

Availability

Available by default for all 2Checkout merchants. Read here how to apply the Product Tax category from your Merchant Control Panel.

Product Tax Category rules

Taxes differ according to the various product tax categories. Tax deduction takes into account the product tax category added at product level for more accurate tax determination (for example, there are certain states  in USA where SaaS products are charged an 8% sales tax, others where the sales tax is 0%).

Default Tax category assignment

• For the 2Monetize accounts: Products that don't have a tax category assigned will be automatically considered as "Electronically-delivered software".
• For 2Sell & 2Subscribe accounts: Products that don't have a tax category assigned will be automatically considered as “Physical Goods”.

For all new products, the selection of the Product Tax category is mandatory.

1. Use the following URL: https://api.avangate.com/channel-manager/2.1/soap/
2. Authenticate using the login method and create a session (connection).
3. Set partner
4. Throughout the lifetime of the session (max 10 minutes), you can invoke all 2Checkout API methods. To invoke methods you need to send a request to 2Checkout. Read more on the request object below.
5. The 2Checkout system provides responses to all requests. Read more on the response object below. 

Overview

After signing up for an account by filling in the form on the 2Checkout website, you will be able to access the Merchant Control Panel.

Before you can start selling with 2Checkout, you need to finalize a few more steps.

The steps below apply to all accounts, including those using third-party services to connect to the 2Checkout platform. 

Customer journey

1. Add your first product or plan

To be able to use your 2Checkout account to sell your goods and services, you need to request the activation of your live account. In order to do this, you must first:

1. Add a product/plan
2. Generate a buy-link and place a test order

Product catalog management is one of the most important aspects of your online store. This guide will show you how to add the first product within your 2Checkout Merchant Control Panel. Our platform supports the creation of both electronic and physical products. Adding shipping methods will give you more control over your costs and income from tangible products.

You can add your products one by one, or do a batch import via XML files. 

You can also receive payments from customers worldwide without the need of adding catalog products. ConvertPlus enables you to pass the product information dynamically to the checkout page, either by using URL parameters or via your 2Checkout Merchant Control Panel.

2. Generate your first buy-link and place a test order

Link your website to the 2Checkout ordering process

2Checkout offers different options for linking your website to your secure hosted 2Checkout order flows. The ConvertPlus buy-links trigger different order flows designed to suit a variety of business needs.

To see the different options available, go to Setup → Generate links. To link your website to your 2Checkout ordering page, copy and paste the checkout links you’ve generated into the web page that will host the purchase button/link.

If you’re aiming to integrate other shopping cart applications with your 2Checkout account and take advantage of an integrated solution in order to provide a superior buying experience and receive worldwide payments, you can check the available options here. Integrations with other shopping cart applications are available only for 2Checkout accounts that handle their own tax and invoice management. 

Place Test Orders

No matter what option you choose when setting up your products or subscription plans, or integrating the checkout process within your website, it is important to run tests to make sure the selected settings work flawlessly. Testing is the best way to make sure that the actual user experience is the one you want. It is also a way to test how 2Checkout notifies you about the different types of transactions.

Using the 2Checkout testing system you can replicate new acquisitions and trial purchase scenarios, as well as automatic renewals, trial conversions, manual renewals, and upgrades.

To generate a test link and place a test order using the test billing information, click here.

3. Request the activation of your live account

When you log into your account (until your application is approved), you will see a blue banner at the top of your account that says, “Your account is currently in demo mode”. Even though your account is in demo mode, everything is completely functional. You can set up products, renewals, and fulfillment or delivery information, as well as test and use all the other available features. This mode allows you to test your setup to make sure everything works as expected, prior to launching your 2Checkout store.

To finalize your account setup, so that your 2Checkout live transactions can be processed, you must submit your application for approval, as explained here.

The 2Checkout's underwriting team will review your application right away and will get in touch with you to either request additional information, if required, or notify you about the resolution.

Once your application is approved, your 2Checkout account is live and you can start using it to process real orders. Your Dashboard will continue to display sample data until you register your first real transaction.

Discover the 2Checkout platform

These are the main areas you'll navigate to set up your account, run your business, get support, and more:

• Merchant Control Panel: The 2Checkout Merchant Control Panel helps you manage your store and all your day-to-day operations, from customizing your checkout experience to updating product information and reviewing orders and customers.
• Knowledge Center: Find how-to articles, videos, guides, and troubleshooting resources. You can also find expert guidance and best practices on how to increase conversion and retention rates while expanding your business globally.
• Support: 2Checkout has dedicated teams that can help you with your financial, technical, or order-related questions via email or Live Chat. Check here the full list of teams that are ready to provide support to your inquiries.
• 2Checkout Customer myAccount: Your customers will be automatically registered into 2Checkout myAccount when they first place an order on your website. They can use 2Checkout myAccount to view their order status and evolution, products or subscription details and history, as well as change their personal customer information, or request a refund.

How to get help

If you are having any difficulty with the three steps above, our support teams can help you.

In the upper-right side of your Control Panel, you’ll find a permanent link to our Knowledge Center.

If you are still having trouble finding the right answers to your questions, the 2Checkout support team is always ready to assist. You can submit tickets or chat with members of the support team regarding your specific questions.

FAQ

1. How do I know if 2Checkout is available in my country?

2Checkout is available in most countries, but there are a number of territories and countries that are restricted from doing business with 2Checkout. If you and/or your business are from one of these countries, you cannot use the 2Checkout products and services.

Also, 2Checkout does not accept PSP merchants or businesses (2Sell and 2Subscribe accounts) from several countries (Afghanistan, Algeria, American Samoa, Antigua and Barbuda, Bahamas, Benin, Botswana, Brunei Darussalam, Cambodia, Cameroon, Cote d'Ivoire, Faroe Islands, French Guiana, Gabon, Georgia, Ghana, Greenland, Guadeloupe, Guinea, Guinea-Bissau, Iraq, Jamaica, Lybia, Maldives, Mali, Mozambique, Myanmar, Namibia, New Caledonia, Nicaragua, Northern Mariana Islands, Qatar, Reunion, Rwanda, Senegal, Seychelles, Eswatini, Tajikistan, Tanzania, United Republic of Timor-Leste, Tunisia, Turkmenistan, Uganda, United States Minor Outlying Islands, Venezuela, Yemen). Shopper transactions from these countries are allowed based on internal risk assessment. 

2. What tax identification documents do I need to create an account?

Read here about all the documents and details you need to provide to 2Checkout to create an account.

3. Can I add a second website to the 2Checkout account to get the same payment information?

If you have a 2Sell or 2Subscribe account, you can have more than 1 associated URL. The request to add a new URL on the account requires risk review and approval, and you can submit it to compliance@2checkout.com.

If you have a 2Monetize account, this is limited to pointing towards 1 URL for the process of generating sales. Any new website that generates traffic needs to have its own account, and all accounts operated by the same entity can be grouped under one multi-account. Requests for new URLs can be sent to csmsupport@2checkout.com or info@2checkout.com.

4. How can I change the website URL or business name in my account?

You cannot perform these updates on your own from your account, but you can reach out to us as additional documentation might be required.

If you have a 2Sell or 2Subscribe account, you can send your request to change the website URL/business name to compliance@2checkout.com, and our Underwriting team will help you out.

If you have a 2Monetize account, you can request the update to our CSM team's email addresses: csmsupport@2checkout.com or info@2checkout.com. 

5. Can I create a 2Checkout account as an individual, without a company?

Yes, this option is currently available in the application form for any type of account you may choose to apply for.

6. How can I cancel/delete my 2Checkout account?

If you want to delete your account, contact us from the same email address on which your account is registered and our dedicated teams will help you settle and close your account.

Overview

The fulfillment process depends on the type of options you selected when configuring fulfillment for your products in your Merchant Control Panel.

Availability

Available for all 2Checkout accounts.

Fulfillment/delivery

Static lists

2Checkout handles fulfillment on your behalf using Static lists. 2Checkout does not provide links to actual product download files or valid activation keys for test orders, even if you configured/uploaded them into the platform. Instead, testers receive this default activation key: ___TEST___CODE___.In addition, testers receive a dummy file for download, test_file.zip, and not the actual product file.

Dynamic lists

You deal with fulfillment using Dynamic lists and need to confirm the completion of the process through IDN or in the Fulfillment Confirmations area. In scenarios in which you generate activation codes/binary keys using a key generator that you host in your system, 2Checkout strongly recommends that you adapt it to deliver test keys/codes. 2Checkout does not provide links to actual product download files for test orders, even if you configured/uploaded them into the platform. Testers receive a dummy file for download, dubbed test_file.zip, and not the actual product file.

2Checkout sends a collection of parameters to your server within HTTP POST to the URL that generates the code/key. The TESTORDER parameter will help you differentiate between test and 'real' orders. Use this parameter to restrict code/key delivery only for 'real' orders. Note: Unless you prepare your system accordingly, you will deliver valid codes/keys for test orders.

Read the guidance provided in the 2Checkout delivery (fulfillment) article to understand what kind of information is supplied by 2Checkout to your system using HTTP POST.

Fulfillment confirmation is automatic and does not require confirmation. Note: 2Checkout does not deliver files or keys in this scenario.

IDN (Instant Delivery Notification)

If your setup requires fulfillment confirmation through IDN, then you also need to confirm fulfillment for test orders in order for their status to advance to Finished.

IRN (Instant Refund Notification)

You can use IRN to issue refunds for the test orders you placed.

ISE (Instant Search Order Export)

You can control the inclusion or exclusion of test order data in ISE file output by using the EXPORT_TEST_ORDERS parameter:

Email notifications

1. The 2Checkout system will send out payment receipts and fulfillment/delivery notifications for test orders, per your account's configuration.
2. Provided that you set up manual and automatic renewal notifications, the 2Checkout system will deliver the renewal emails for test subscriptions according to your account's configuration.

Overview

Use the login method for the authentication process in the 2Checkout system.

Parameters

Response

Request

<?php

/**
 * @throws JsonException
 */
function callRPC($Request, $host) {
    $curl = curl_init($host);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 1);
    curl_setopt($curl, CURLOPT_VERBOSE, true);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2);
    curl_setopt($curl, CURLOPT_SSLVERSION, 0);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'Accept: application/json'));
    $RequestString = json_encode($Request, JSON_THROW_ON_ERROR);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $RequestString);

    $ResponseString = curl_exec($curl);

    if (!empty($ResponseString)) {
        echo($ResponseString);
        $Response = json_decode($ResponseString, false, 512, JSON_THROW_ON_ERROR);
        if (isset($Response->result)) {
            return $Response->result;
        }
        if (!is_null($Response->error)) {
            echo("Method: {$Request->method}" . PHP_EOL);
            echo("Error: {$Request->error}" . PHP_EOL);
        }
    } else {
        return null;
    }
    return null;
}

$host = 'https://api.2checkout.com/rpc/6.0/';

$merchantCode = "YOUR_MERCHANT_CODE"; // your account's merchant code available in the 'System settings' area of the cPanel: https://secure.2checkout.com/cpanel/account_settings.php
$key = "YOUR_SECRET_KEY"; // your account's secret key available in the 'System settings' area of the cPanel: https://secure.2checkout.com/cpanel/account_settings.php

$string = strlen($merchantCode) . $merchantCode . strlen(gmdate('Y-m-d H:i:s')) . gmdate('Y-m-d H:i:s');
$algo = "sha256";
$hash = hash_hmac($algo, $string, $key);

$i = 1;

$jsonRpcRequest = new stdClass();
$jsonRpcRequest->jsonrpc = '2.0';
$jsonRpcRequest->method = 'login';
$jsonRpcRequest->params = array($merchantCode, gmdate('Y-m-d H:i:s'), $hash, $algo);
$jsonRpcRequest->id = $i++;

try {
    $sessionID = callRPC($jsonRpcRequest, $host);
    echo("Auth token: {$sessionID}" . PHP_EOL);
} catch (JsonException $e) {
    echo("Error: {$e->getMessage()}" . PHP_EOL);
}

Overview

The object includes information related to the upsell campaigns, including product information and discount settings.

UpSell Object

The object below is returned as a successful response for the following SOAP API 6.0 methods:

• Create an upsell campaign