Skip to main content

Subscription end user update

Overview

Use the updateSubscriptionEndUser method to update the details of a subscription’s end user. This method changes per-subscription end user data and not customer details.

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.

SubscriptionReference

Required (string)

 

Unique, system-generated subscription identifier.

EndUser

Required (Object)

  Use this object to update end user information.

Response

Parameter Type/Description

Boolean

true or false depending on whether the changes were successful or not.

Request


<?php
 
require('PATH_TO_AUTH');

$subscriptionReference = '8F749B63E7';
$EndUser = new stdClass ();
$EndUser->Address1 = 'Address line 1';
$EndUser->Address2 = 'Address line 2';
$EndUser->City = 'LA';
$EndUser->Company = 'Company Name';
$EndUser->CountryCode = "US";
$EndUser->Email = 'customerAPI@avangate.com';
$EndUser->FirstName = 'New Customer 2.0';
$EndUser->Language = 'en';
$EndUser->LastName = 'Avangate';
$EndUser->Phone = '1234567890';
$EndUser->State = 'California';
$EndUser->Zip = '90210';
$EndUser->Fax = null;

try {
    $newEndUser = $client->updateSubscriptionEndUser($sessionID, $subscriptionreference, $EndUser);
}
catch (SoapFault $e) {
    echo "newEndUser: " . $e->getMessage();
    exit;
}
var_dump("newEndUser", $newEndUser);

Generate SKU schema

 

 

Request Example 

<?php

require ('PATH_TO_AUTH');

$inputSchema = new \stdClass();
$inputSchema->Products = [];
$inputSchema->Products[0] = new \stdClass();
$inputSchema->Products[0]->Code = '6B3CB17DDA_COPY1';
$inputSchema->Products[0]->Currencies = ['USD', 'EUR', 'GBP', 'BGN'];
$inputSchema->Products[0]->PurchaseTypes = ['NEW_PRODUCT', 'RENEWAL'];
$inputSchema->Products[0]->PricingConfigurationCodes = [];
$inputSchema->Products[0]->PricingConfigurationCodes[0] = new \stdClass();
$inputSchema->Products[0]->PricingConfigurationCodes[0]->Code = 'E684EC99B0';
$inputSchema->Products[0]->PricingConfigurationCodes[0]->VolumeDiscounts = [[1, 3], [4, 7]];
$inputSchema->Products[0]->PricingConfigurationCodes[0]->OptionGroups = [];
$inputSchema->Products[0]->PricingConfigurationCodes[0]->OptionGroups[0] = new \stdClass();
$inputSchema->Products[0]->PricingConfigurationCodes[0]->OptionGroups[0]->Code = 'GRUP_1';

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

var_dump("getSchema", $generatedSchema);

Response Example

array(1) {
  [0] =>
  class stdClass#7 (2) {
    public $ProductCode =>
    string(16) "6B3CB17DDA_COPY1"
    public $SkuPricingOptions =>
    array(1) {
      [0] =>
      class stdClass#8 (3) {
        public $Code =>
        string(10) "E684EC99B0"
        public $Details =>
        array(64) {
          [0] =>
          class stdClass#9 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#10 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#11 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [1] =>
          class stdClass#12 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#13 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#14 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [2] =>
          class stdClass#15 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#16 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#17 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [3] =>
          class stdClass#18 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#19 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#20 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [4] =>
          class stdClass#21 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#22 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#23 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [5] =>
          class stdClass#24 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#25 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#26 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [6] =>
          class stdClass#27 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#28 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#29 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [7] =>
          class stdClass#30 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#31 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#32 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [8] =>
          class stdClass#33 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#34 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#35 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [9] =>
          class stdClass#36 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#37 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#38 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [10] =>
          class stdClass#39 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#40 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#41 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [11] =>
          class stdClass#42 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#43 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#44 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [12] =>
          class stdClass#45 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#46 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#47 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [13] =>
          class stdClass#48 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#49 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#50 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [14] =>
          class stdClass#51 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#52 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#53 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [15] =>
          class stdClass#54 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "USD"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#55 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#56 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [16] =>
          class stdClass#57 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#58 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#59 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [17] =>
          class stdClass#60 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#61 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#62 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [18] =>
          class stdClass#63 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#64 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#65 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [19] =>
          class stdClass#66 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#67 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#68 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [20] =>
          class stdClass#69 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#70 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#71 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [21] =>
          class stdClass#72 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#73 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#74 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [22] =>
          class stdClass#75 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#76 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#77 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [23] =>
          class stdClass#78 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#79 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#80 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [24] =>
          class stdClass#81 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#82 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#83 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [25] =>
          class stdClass#84 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#85 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#86 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [26] =>
          class stdClass#87 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#88 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#89 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [27] =>
          class stdClass#90 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#91 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#92 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [28] =>
          class stdClass#93 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#94 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#95 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [29] =>
          class stdClass#96 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#97 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#98 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [30] =>
          class stdClass#99 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#100 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#101 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [31] =>
          class stdClass#102 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "EUR"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#103 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#104 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [32] =>
          class stdClass#105 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#106 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#107 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [33] =>
          class stdClass#108 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#109 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#110 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [34] =>
          class stdClass#111 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#112 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#113 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [35] =>
          class stdClass#114 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#115 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#116 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [36] =>
          class stdClass#117 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#118 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#119 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [37] =>
          class stdClass#120 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#121 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#122 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [38] =>
          class stdClass#123 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#124 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#125 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [39] =>
          class stdClass#126 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#127 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#128 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [40] =>
          class stdClass#129 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#130 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#131 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [41] =>
          class stdClass#132 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#133 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#134 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [42] =>
          class stdClass#135 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#136 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#137 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [43] =>
          class stdClass#138 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#139 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#140 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [44] =>
          class stdClass#141 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#142 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#143 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [45] =>
          class stdClass#144 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#145 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#146 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [46] =>
          class stdClass#147 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#148 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#149 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [47] =>
          class stdClass#150 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "GBP"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#151 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#152 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [48] =>
          class stdClass#153 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#154 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#155 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [49] =>
          class stdClass#156 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#157 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#158 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [50] =>
          class stdClass#159 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#160 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#161 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [51] =>
          class stdClass#162 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#163 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#164 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [52] =>
          class stdClass#165 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#166 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#167 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [53] =>
          class stdClass#168 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#169 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#170 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [54] =>
          class stdClass#171 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#172 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#173 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [55] =>
          class stdClass#174 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(1)
            public $ToQty =>
            int(3)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#175 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#176 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [56] =>
          class stdClass#177 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#178 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#179 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [57] =>
          class stdClass#180 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#181 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#182 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [58] =>
          class stdClass#183 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#184 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#185 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [59] =>
          class stdClass#186 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(11) "NEW_PRODUCT"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#187 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#188 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
          [60] =>
          class stdClass#189 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#190 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#191 (2) {
                    public $Name =>
                    string(13) "option name 1"
                    public $Value =>
                    string(13) "option_code_1"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrlXauuZOojh8cww=="
          }
          [61] =>
          class stdClass#192 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#193 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#194 (2) {
                    public $Name =>
                    string(13) "option name 2"
                    public $Value =>
                    string(13) "option_code_2"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrmXauuZOojjccxw=="
          }
          [62] =>
          class stdClass#195 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#196 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#197 (2) {
                    public $Name =>
                    string(13) "option name 3"
                    public $Value =>
                    string(13) "option_code_3"
                  }
                }
              }
            }
            public $Options =>
            string(76) "eJwBLADT/6G10uOW07exk6mNk7KvrpaSc4l1lbXToqi5sriTcbOXseWu3ZGrnXauuZOojk8cyw=="
          }
          [63] =>
          class stdClass#198 (7) {
            public $ProductSKU =>
            string(0) ""
            public $Currency =>
            string(3) "BGN"
            public $FromQty =>
            int(4)
            public $ToQty =>
            int(7)
            public $PurchaseType =>
            string(7) "RENEWAL"
            public $Groups =>
            array(1) {
              [0] =>
              class stdClass#199 (2) {
                public $GroupCode =>
                string(6) "GRUP_1"
                public $Options =>
                array(1) {
                  [0] =>
                  class stdClass#200 (2) {
                    public $Name =>
                    string(4) "NONE"
                    public $Value =>
                    string(4) "NONE"
                  }
                }
              }
            }
            public $Options =>
            string(0) ""
          }
        }
        public $Errors =>
        array(0) {
        }
      }
    }
  }
}

ConvertPlus URL parameters

Overview

Use 2Checkout ConvertPlus to provide your customers with a swift and safe payment experience. Depending on your desired workflow, you can either create ordering interface links using our dedicated interface (ConvertPlus) or generate the parameters dynamically, in your own system.

2Checkout enables you to use ConvertPlus with both catalog products and with products generated dynamically via buy-link parameters.

 

Availability 

Eligible 2Checkout accounts. Contact 2Checkout to inquire about ConvertPlus. 

Requirements 

To use ConvertPlus dynamic ordering, pass the dynamic parameter with TRUE or 1 value. When creating orders with catalog products, the prod parameter should contain the product code of your catalog item. For dynamic ordering, the prod parameter should contain the name of your dynamic product.  

How to create dynamic ConvertPlus buy-links

  1. Start from the base ConvertPlus buy-link:

     https://secure.2checkout.com/checkout/buy/?
    
  2. Add your merchant code to the buy-link, so that 2Checkout links the sale to your account. Your merchant code can be found in your Control Panel, in the Account Information area. Example: merchant=2COLRNC.

  3. Set the dynamic parameter to TRUE or 1.

  4. Add product information such as product typename, price, and quantity.

  5. Include additional product information, such as recurring options or customer redirect URL.

Sample ConvertPlus buy-link for dynamic product information

The following buy-link reproduces a dynamic ordering experience:

https://secure.2checkout.com/checkout/buy/?merchant=2COLRNC&dynamic=1&prod=2CheckoutSubscription&type=PRODUCT&qty=1&price=10&test=1

Buy-link parameters

When you generate a checkout link, 2Checkout automatically includes some of the parameters in the list below in the URL, depending on a number of variables, such as the products, discounts, currency, and more. You can use these query parameters to generate checkout links in your own system, without having to rely on the functionality in your account. 

Parameter Required/Optional Description

Billing information

 

Use these parameters to control the billing information displayed in the shopping cart. By adding these parameters in the buy-link, you can pre-fill the customer information and minimize the customer effort in the ordering process.

email Optional Send customer email
name Optional Send full customer name. Ex: "John Steward Doe".
phone Optional Send customer phone number
country Optional Send customer country code. Two-digits code. Ex: "UK".
state Optional Send customer state code. Two-digits code. Ex: "CA".
city Optional Send customer city.
address Optional Send customer address
address2 Optional Send customer additional address information
zip Optional Send customer zip code
company-name Optional

Send Company name.

When sending the Company name, the Company checkout flow will be triggered. Otherwise, the default checkout flow for ConvertPlus is the individual flow.

fiscal-code Optional

Send company Fiscal code.

When sending the Fiscal code, the Company checkout flow will be triggered only if also another company flow relevant parameter will be also sent (Company name and/or Tax office). Otherwise, the default checkout flow for ConvertPlus is the individual flow.

tax-office Optional

Send company Tax office.

When sending the Tax office, the Company checkout flow will be triggered. Otherwise, the default checkout flow for ConvertPlus is the individual flow.

Delivery information

Use these parameters to control the billing information displayed in the shopping cart. By adding this parameters in the buy-link, you can pre-fill the customer information and minimize the customer effort in the ordering process.

ship-name Optional Send customer delivery name. Ex: "John Steward Doe".
ship-country Optional Send customer delivery country code. Two-digits code. Ex: "UK".
ship-state Optional Send customer delivery state code. Two-digits code. Ex: "CA".
ship-address Optional Send customer delivery address
ship-address2 Optional Send customer additional delivery address information
ship-zip Optional Send customer delivery zip code

Product information

Use the parameters to create products with dynamic information, skipping the need of handling a product catalog in your 2Checkout Control Panel

dynamic Required for dynamic products Boolean. Set TRUE for dynamic products.
prod For catalog products Product codes added to checkout, separated by a semicolon.

Do not use spaces or blanks. Example: prod=46CC15F39;7488E17CC0. Product codes are assigned by you at the moment you are adding new products.

In the Control Panel, click to edit a product, and select the Information tab. The Product code of the item you're editing is available at the top of the General area under Information.

Warning: Changing a product code already used in active buy-links will completely break the checkout flow for those links. If you change a product code, make sure all your buy-links for that product are replaced with new links generated with your current product code. 

For buy-links with on-the-fly and trial pricing, this parameter is mandatory and has to be included in the signature.

prod For dynamic products

Set the dynamic parameter TRUE to use dynamic products in the ordering process.

When using dynamic products, the prod parameter contains as value the name of the dynamic product. For multiple products, send them separated by a semicolon.

Example: name1;name2;name3.

item-ext-ref For dynamic products Set product identifier for your dynamic products. When included, the parameter needs to be signed.
type Required for dynamic products

The type of the dynamic product. Possible values:

  • PRODUCT
  • SHIPPING
  • TAX

For multiple dynamic items, send the values separated by a semicolon.

qty Required 

The number of units (quantity) for each product in checkout, separated by a semicolon ;. Do not use spaces or blanks. Example: qty=2;1.

qty works in conjunction with prod, based on their respective order. The first value of the qty parameter controls the number of units for the products whose identifier is in the first position of the prod parameter. 

Example: https://secure.2checkout.com/checkou...rchant=2COLNC&prod=6FD08E61B5;E2932D0DE2&qty=4;3

  • For buy-links with on-the-fly pricing, this parameter is required and has to be included in the signature.
  • For trials, qty parameter can only be 1 and it is not required.
price Required for catalog products with on-the-fly pricing

For catalog products with on-the-fly pricing, custom price and currency must be included in the buy-link.

For multiple products with on-the-fly pricing, send the values separated by a semicolon.

Example: price=currency1:val1;currency2:val2;currency3:val3.

For buy-links with multiple prices per each product in a catalog product with on-the-fly pricing scenario, there are multiple use cases:

  1. The values of separate products (qty=1;2;3) are separated by a semicolon. This means that the first product will have quantity 1, the second product will have quantity 2, and the third product will have quantity 3.
  2. The pair values for different products: price=EUR:10;EUR:11;EUR:12. Each pair of currency-price is separated by a semicolon and the pairs of products itself are separated by a colon. This means that the first product will have a custom price of 10EUR, the second product will have a custom price of 11EUR, and the third product will have a price of 12EUR.
  3. The pair values for the same product: price=EUR:10,USD:11,RON:12. Each pair of currency-price is separated by a comma, while the values inside each pair are separated by a colon. This means that this price definition is for a single product with custom prices of 10EUR, 11USD and 12RON.
  4. The pair values for multiple products: price=EUR:10,USD:11,RON:12,EUR:20,USD:21,RON:22. Use a colon to separate the custom prices for multiple products. Each pair of currency-price is separated by a comma and the values of each pair are separated by a colon. This means that the price definition for the first product will be 10EUR, 11USD and 12RON and the price definition for the second product will be 20EUR, 21USD, and 22RON.

For buy-links with on-the-fly pricing, this parameter is mandatory and has to be included in the signature.

Note:

  • Values of parameters that relate to separate products are separated with a semicolon.
  • Parameters that are configured to support multiple values, like price or opt, should have their values separated by a comma if those values refer to the same product.
  • Pair values should be separated by a colon.
price Required for dynamic products

For dynamic products, enter the product price.

For multiple dynamic items, send the values separated by a semicolon.

Example: price1;price2;price3.

tprices Required for catalog product with trial pricing

For catalog products with trial pricing, the currency must be included in the buy-link.

Multiple products not supported:

 

  • The pair values for the same product: price=EUR:10,USD:11,RON:12. Each pair of currency-price is separated by a comma, while the values inside each pair are separated by a colon. This means that this price definition is for a single product with custom prices of 10EUR, 11USD and 12RON.

For buy-links with trial pricing, this parameter is mandatory and must be included in the signature.

 

Note:

  • Parameters that are configured to support multiple values, like opt, should have their values separated by a comma if those values refer to the same product.
  • Pair values should be separated by a colon.

Note: tprices and tperiod are incompatible with custom price, as tprices and tperiod go hand in hand. 

tperiod Required for catalog product with trial pricing The minimum tperiod number is 7 days. 
currency

Required for catalog product with trial pricing

E.g.,: currency=USD
tangible Required for dynamic products

Boolean.

Send TRUE or 1 for products that require physical delivery.

opt Optional Defines the product pricing options.

URL formating rules:

":" is considered a pair separator

  • 1 product with 1 price option with 1 value (includes scale option type)
    • prod=code1&opt=gr1:val1
  • 1 product with 1 price option with multiple values
    • prod=code1&opt=gr1:val1:val2

 

"," is considered a value separator

  • 1 product with 2 price options with 1 value each
    • prod=code1&opt=gr1:val1,gr2:val2
  • 1 product with 2 price options with multiple values each
    • prod=code1&opt=gr1:val1:val2,gr2:val3:val4

 

";" is considered a parameter separator between products

  • 2 products with 1 price option containing 1 value
    • prod=code1;code2&opt=gr1:val1;gr2:val2
  • 2 products with 1 price option containing multiple values
    • prod=code1;code2&opt=gr1:val1:val2;gr2:val3:val4
  • 2 products with 2 price options containing 1 value each
    • prod=code1;code2&opt=gr1:val1,gr2:val2;gr3:val3,gr4:val4
  • 2 products with 2 price options containing multiple values each
    • prod=code1;code2&opt=gr1:val1:val2,gr2:val3:val4;gr3:val5:val6,gr4:val7:val8

For buy-links with on-the-fly and trial pricing, this parameter is mandatory and has to be included in the signature.

description Optional for dynamic products For dynamic products, set a description that is displayed in the checkout page. The description field is displayed only for the 'One column with payment buttons' template. The description will not be visible in the default template.
recurrence Required for dynamic products

For dynamic products, set product recurring options.

Send multiple dynamic items separated by a semicolon.

Example: period1:unit1;period2:unit2;

 

Possible values for units:

  • DAY
  • WEEK
  • MONTH
  • YEAR
  • FOREVER

*This parameter is conditioned by two other parameters: duration and renewal-price.

duration Required for dynamic products

For dynamic products, set the duration of the recurrence.

Send multiple dynamic items separated by a semicolon.

Example: period1:unit1;period2:unit2;

 

Possible values for units:

  • DAY
  • WEEK
  • MONTH
  • YEAR
  • FOREVER

*This parameter is conditioned by two other parameters: recurrence and renewal-price.

renewal-price Required for dynamic products For dynamic products, set the price that should be applied to the renewal order.
product-additional-fields Optional (only for new acquisitions, manual renewal, and custom prices) For LISTBOX additional fields the value must be a valid value from the dropdown.

Cart behavior

Use the parameters below to control the purchasing flow. You can add a success URL for your finalized orders, change the cart template, add a source parameter or choose to place test orders.

merchant Required Your merchant identification code. The merchant code is available in Settings > Edit system settings, under the System settings tab.

subscription

Required for the manual renewal of catalog products 

Unique system-generated identifier of your subscriptions. The subscription reference is available on Orders and customers à Subscriptions à Edit subscription details.

expiration Optional Buy-link expiry date. The link becomes invalid after the date from this parameter. Send as a UTC timestamp. Example: 

1537549421 

return-url Optional URL to which customers are redirected after their finalized purchase. Learn more about Redirect URL on this article.
return-type Optional

The return method used for redirecting your customers after a successful sale. Possible values:

  • Link 
  • Redirect

Read more about redirect URL.

coupon

Optional

Promotion coupon code discounting the price of a product added to checkout. You can send multiple values separated by semicolon when standalone coupons discount different products added to checkout. 
For example: [...]&coupon=voucher1;voucher2[...]

If this parameter is added to the buy-link, it has to be included in the signature.

src Optional

Use this parameter to identify the source of your sales (which links are performing better).  For instance, if there are two buy-links on your website, one in the product page and another one in the download page, you can track the source page by entering the following parameters: src=prodpage for the product page or src=dldpage for the link on the download page.

tpl Optional

Cart template used for the checkout experience.

Possible values:

  • default
  • one-column

Use the style parameter to send ConvertPlus cart themes customized via Cart Editor.

currency Optional Preselected billing currency 2Checkout uses to charge your customers.
empty-cart Optional Boolean. Use for resetting cart contents.
back-url Optional Use this parameter behind the 'Back to Shopping' link in the shopping cart to redirect your customers to a website of your choice.
order-ext-ref Optional Use this parameter to set an external reference to the order.
language Optional

Defines the language for the order interface. English is the default language.

Available values for language codes are displayed in this article.

origin-url Optional Set an origin URL for the purchase.
style Optional

Use style for setting a customized cart template for the checkout experience.

The parameter can be populated with the styling code assigned to each of your customized ConvertPlus cart themes. Contact 2Checkout to learn how to retrieve the styling code for your customized themes.

test Optional Use test=1 to place test orders. Exclude for regular order. Dummy credit card details are provided so you can test the entire order placing process. Guidance on the 2Checkout test ordering system is available here.
customer-ref Optional The 2Checkout system generates default customer numerical (integer) IDs automatically for all orders of products that feature subscriptions. Can be used for new acquisitions aggregating new subscriptions under an existing Customer account.
customer-ext-ref Optional The external customer reference
lock Optional (only for catalog products)

You can define customized packages or products for your shoppers and increase consistency and reconciliation between internal reporting, considering the details available at checkout and the ones valid when placing the order.

This action can be done by using the 'lock' buy-link parameter which must be included in the signature along with other parameters that could impact the price: coupon, currency, lock, prod, qty, opt.

When the cart is locked, the coupon field will not be visible anymore and the shoppers will not be able to add coupons to the cart.

To enable, add the lock parameter to the generated buy-link, set it to 1 (lock = '1') and sign it.

order-additional-fields Optional (only for new acquisitions and manual renewal)

For LISTBOX additional fields the value must be a valid value from the dropdown.

Example: product-additional-fields=field_identifier:value1;field_identifier2:value2

ConvertPlus parameters to be included in the signature 

  1. General parameters included in the signature, regardless of the type of checkout (catalog products, dynamic products, renewal, unfinished payment): return-urlreturn-typeback-url, expirationorder-ext-refcustomer-refcustomer-ext-ref.
  2. Parameters to be included in the signature for dynamic products buy-links: currencyprod, priceqtytangibletypeoptdescriptionrecurrencedurationrenewal-price, item-ext-ref.
  3. Parameters to be included in the signature for manual renewal buy-links: prodqtyopt.
  4. Parameters to be included for on-the-fly pricing for catalog products: prodpriceqtyopt, coupon, currency.
  5. Parameters to be included for trial pricing for catalog products: prod, tprices, tperiod, opt, currency.
  6. Parameters to be included in order to lock the cart for catalog products: lock.
  7. Parameters to be included when an approved URL is set: in this case, all parameters will be included in the signature, when redirected after successful completion of a sale.

Retrieve a customer

Overview

Use the getCustomerInformation method to retrieve the details of a customer entity from the Avangate system.

Parameters

Parameters Type/Description

sessionID

Required (string)

 

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

AvangateCustomerReference

Required (int)

 

System-generated customer reference. Required unless you prefer to use ExternalCustomerReference.

ExternalCustomerReference

Optional (string)

 

External customer reference that you control. Optional when you use AvangateCustomerReference. If you include it, it needs to belong to the same customer as the AvangateCustomerReference.

Request

<?php

require ('PATH_TO_AUTH');

$customerReference = CUSTOMER_REFERENCE;
$externalCustomerReference = 'EXT_CUSTOMER_REFERENCE'; //Optional, but if you include it it needs to belong to the same customer as the internal Avangate customer reference

$jsonRpcRequest = array (
'method' => 'getCustomerInformation',
'params' => array($sessionID, $customerReference, $externalCustomerReference),
'id' => $i++,
'jsonrpc' => '2.0');

var_dump (callRPC((Object)$jsonRpcRequest, $host, true));

Response

Parameters Type/Description

Customer

Object

Payment methods management in 2Checkout myAccount

Overview

2Checkout myAccount enables customers to add, update, and manage their payment information on demand by connecting their recurring subscriptions to new payment methods.

Availability

Payment methods management capabilities are available to all customers using 2Checkout myAccount.

However, the payment method management functionality can be used only for active, ongoing subscriptions, or those that are in the grace period, i.e. past their renewal deadline, but not expired. Adding or updating payment data will not function for lifetimecanceled, and expired subscriptions.

Contact 2Checkout to make sure your account's payment setup enables your customers to update or add payment data.

myAccount supported payment methods

The following payment methods will be displayed to customers when attempting to add/update their payment information:

Supported payment method Add/Update to credit/debit card Add/Update to PayPal

Credit/debit cards

  • VISA (and VISA Electron)
  • MasterCard
  • Maestro
  • American Express
  • Discover
Yes Yes
No payment method available (for subscriptions imported without payment info) Yes Yes
PayPal Yes Yes
DirectDebit Yes Yes
Bank wire transfer Yes Yes
Once replaced on a subscription by credit/debit card data and PayPal, payment methods such DirectDebit and bank wire transfer cannot be switched back.
 

However, customers can add/update additional credit/debit cards and PayPal accounts, as long as your account's payment setup supports them.

Add a new credit/debit card flow

Shoppers can add, delete, update their payment methods details by clicking on the Payment Methods tab in the 2Checkout myAccount.

Payment methods

This is the first scenario designed to enable your customers to add and update their payment options:

  1. Customers navigate to the Payment Methods area.
  2. They click the Add a new card button.
  3. In the Add new card area, customers can introduce new credit/debit card details and click Save.
  4.  The 2Checkout system performs credit/debit card validation checks, to ensure that the data supplied indeed fits the right format.
  5. 2Checkout does not pre-authorize new payment information, since the credit/debit card is not assigned to a subscription and is not be used to charge the customer.
  6. Once the data is saved the new credit/debit card will be featured in the customer's myAccount.

Credit/debit cards associated with an account can:

1. Be assigned to specific, active subscriptions and used for future charges as a part of the recurring billing (subscription renewal) process.

2. Be used to support payment tokenization for returning customers. Available credit/debit cards can be displayed in the shopping cart for existing customers, allowing them only to select the desired card rather than re-entering billing and payment information.

Add credit/debit card data for a subscription flow

When they log into their myAccount, customers will be able to add credit/debit card data for:

  • Imported subscriptions
  • Subscriptions that were purchased using payment methods such as PayPal, DirectDebit, and bank wire transfer

Customers can see all their subscriptions by accessing the My Products section.

  1. Go to My Products section. 

  2. Click on Add Payment method from the targeted subscription.

Subscription Add Payment method

 3.  A  pop-up window such as the one below will open.

Update payment method myAccount

 4.  Choose a payment method you want to associate to the selected subscription and click the Update payment method button. 

The 2Checkout system performs an authorization check for each card added. If the authorization is performed successfully, the card is associated with the subscription and used to charge customers as a part of the automatic renewal / recurring billing process. Details about the authorization process are available below.

If the Enable automatic subscription renewal option is checked, then the 2Checkout system automatically charges customers for the renewal of their subscriptions each recurring billing cycle.

The same card can be assigned to and used for multiple subscriptions.

Pass 3DS verification flow when associating subscriptions to existing cards

Shoppers need to pass 3DS verification when associating subscriptions to existing cards in MyAccount.

  1. Log in to the 2Checkout myAccount platform.
  2. Navigate to Payment methods tab.
  3. Identify your card payment method in the list and press "Associated subscriptions" button. A pop-up window containing all the associated and eligible for association subscriptions will show up in the page.

Payment methods - associated subscriptions save

4. Check one of the eligible subscriptions in the list in order to associate it to the actual payment method.

  • Fill in the CVV in the editable field.
  • Press the "Save" button.

Subscriptions Payment Method

 

5. In the 3DS verification page, fill in the password and press the "Submit" button.

visa card details

As a final verification, you can reopen the pop-up with the subscriptions associated to the payment method for which you made the association and check that the subscription is now in the "Associated subscriptions" list.

The subscription is now successfully associated to the payment method and it can be found in the "Associated subscriptions" list.

Delete a card

  1. Log in to the 2Checkout myAccount platform.
  2. Navigate to Payment methods.
  3. Select the card you want to delete and click on Remove.

Payment methods - Delete a card

  4. Before removing a card, make sure that this is not associated with any subscriptions; if it is, you need to deactivate all the subscriptions associated with the card that you wish to delete.

Payment methods - associated subscriptions

 5. Click on Confirm removal to delete the card.

Payment methods - Delete Credit Card

Update a card 

2Checkout lists credit/debit cards used to pay for a subscription at the top of the New Credit Card information pop-p window. The credit/debit card currently used to charge customers for the automatic renewal / recurring billing process is highlighted.

Customers can select one of the existing cards to be charged as a part of the automatic renewal / recurring billing process, replacing the one previously in use. The last added card will be displayed at the top of the list.

At the same time, they have the option of adding new payment information. The 2Checkout system performs an authorization check for each card added. If the authorization is performed successfully, the card will be associated with the subscription and will be used to charge customers as a part of the automatic renewal / recurring billing process. Details about the authorization process are available below.

If the Enable automatic subscription renewal option is unchecked, then the automatic renewal system will be disabled for the subscription. As a result, the 2Checkout system will no longer automatically charge customers for the renewal of their subscriptions each recurring billing cycle. Customers can still renew their subscriptions manually.

Update credit/debit card info

  1. Customers navigate to the Payment Methods area.
  2. They need to click the Edit button and they'll be able to enter new expiration information and click Save.
  3. They can click Remove and delete the card-on-file data from the 2Checkout platform. 

Card pre-authorization

  1. The customer assigns a card to an active or past due subscription.
  2. 2Checkout issues a pre-authorization charge using the minimum value set for the process, in accordance with the payment method used by the customer and the currency selected for the order. The pre-authorization charge is handled by a payment gateway that attempts to validate the card with its issuing bank.

For credit /debit cards the temporary charge (pre-authorization) put on hold is usually $1/1EUR or the rough equivalent of this amount converted in the currency used for the ordering process.

  1. The Credit / Debit card is:
  • Instantaneously authorized by the issuing bank (2Checkout receives validation from payment gateway) and will be associated with the subscription. The Credit / Debit card is validated and the unique order reference generated by 2Checkout is stored so the system can charge customers in the future for trial conversions or the automatic renewal of subscriptions.
  • Not authorized by the issuing bank (payment gateway informs 2Checkout that validation has failed). An error message will be presented to customers, asking them to try again.

All pre-authorized charges are reversed automatically. The pre-authorization cancelation process takes a maximum of one (1) hour. Depending on the customer's bank, pre-authorization charges may or may not appear on credit/debit card statements or online account activity logs.

Add/delete PayPal flow

Regardless of the myAccount layout, shoppers can add and or delete PayPal to/from multiple recurring subscriptions. They can also change the payment method associated with their subscriptions from any payment method to PayPal, from PayPal to card, or from one PayPal account to a different one at any point.

Add a PayPal account

To add a PayPal account, follow these steps:

  1. Log in to your 2Checkout myAccount.
  2. Navigate to Payment Methods
  3. Click on Add a new PayPal account

Payment methods - Add a PayPal account

4. In the Update payment method window, fill in your PayPal accountand click the Save button.

Payment methods - Add a PayPal account modal.

5. You'll be redirected to the PayPal page to input your email address and password for login.

2-paypal-redirect-email.png 

2-paypal-redirect-password.png

6. You can see the newly saved PayPal account displayed in the Payment methods section.

Delete a PayPal account

  1. Log in to your 2Checkout myAccount.
  2. Click on the Payment methods tab.
  3. Click on Remove next to the PayPal payment method.

Payment methods - delete PayPal

4. Before removing a PayPal account, make sure that this is not associated with subscriptions that have automatic renewal enabled; if it is, disable automatic renewal for each of the subscriptions associated with the PayPal account that you wish to delete.

Payment methods - delete paypal modal

5. After disabling automatic renewal for all subscriptions associated with the PayPal account, click on Confirm removal to delete it.

Associate multiple subscriptions to a card/wire/PayPal account

You can now associate multiple subscriptions to a card/wire/PayPal account in one step instead of having to link them one by one. 

Follow these steps to associate multiple subscriptions to a card/wire/PayPal account:

  1. Log in to your 2Checkout myAccount.
  2. Navigate to Payment Methods.
  3. Select the payment method you wish to associate with multiple subscriptions and click on the Associated subscription link.

Payment methods - associated subscriptions snip

4. In the Associate subscriptions window, you can see the subscriptions already associated with the payment method and you can also select other subscriptions that you would like to add to the same payment method.

5. After selecting the subscriptions, click on Save.

Payment methods - associated subscriptions save

FAQ

1. What happens when credit cards expire? Will such items still be listed?

Expired credit/debit cards can no longer be used to charge customers. However, expired cards that were associated with a subscription will continue to be displayed.

For more FAQ topics, please visit the Support section from myAccount.

Create promotion

Overview

Use the addPromotion method to create a new promotion.

Parameters 

Parameter Type/Description
sessionID Required (string)
  Output of the Login method.
Promotion Required (object)
  Promotion object that you want to create.

Response

Parameters Type/Description
Promotion

Object

Contains promotion configuration.

Request

<?php

require ('PATH_TO_AUTH');

$promotionObject = new stdClass;
$promotionObject->Name = 'YOUR_PROMOTION_TITLE';
$promotionObject->Description = 'YOUR_PROMOTION_DESCRIPTION';
$promotionObject->StartDate = date('Y-m-d', strtotime('1 month ago'));
$promotionObject->EndDate = date('Y-m-d', strtotime('+1 month'));
$promotionObject->Type = 'REGULAR';
$promotionObject->Enabled = 1;
$promotionObject->MaximumOrdersNumber = 0;
$promotionObject->MaximumQuantity = 0;
$promotionObject->InstantDiscount = false;
$promotionObject->ChannelType = 'ECOMMERCE';
$promotionObject->ApplyRecurring = 'NONE';
$promotionObject->RecurringChargesNumber = 3;
$promotionObject->PublishToAffiliatesNetwork = 0;
$promotionObject->InstantDiscount = 0;

$couponObject = new stdClass;
$couponObject->Type = 'SINGLE';
$couponObject->Code = 'single_code';
$promotionObject->Coupon = $couponObject;

$discountObj = new stdClass;
$discountObj->Type = 'PERCENT';
$discountObj->Value = 30;
$promotionObject->Discount = $discountObj;
$promotionObject->Products = [$productsObj1, $productsObj2, $productsObj3];
//$promotionObject->Translations = [$translation1, $translation2];


try {
    $newPromotion = $client->addPromotion($sessionID, $promotionObject);
}

catch (SoapFault $e) {
    echo "NewPromotion: " . $e->getMessage();
    exit;
}

var_dump("Promotion", $newPromotion);

Password and login

Overview

You can change your login details, including password and email from your 2Checkout Merchant Control Panel. 

2Checkout assigns your email address to a single account. To use the same email address for multiple accounts, contact 2Checkout. 

Login Settings

To set or edit your login details, follow these steps:

  1. Log in to your Merchant Control Panel.
  2. Navigate to the Settings cogwheel in the top right corner.
  3. Click on My details.

change password_1.png

4. On the Login information page, you can edit your login details: First name, Last name, Username, and Email.

5. After editing your login details, click on the Update button to save them.

change password_2.png

Password Settings

Password requirements

2Checkout requires you to set a strong password:

  • Must have at least 8 characters.
  • Must have at least 3 out of the following 4 sets of characters: small letters, capital letters, numbers, and special characters.
  • Must be different from the last 4 passwords.
  • The password will never expire.

Set up your password

To set a password for your 2Checkout account, follow the steps below.

  1. Log in to your Merchant Control Panel.
  2. Navigate to the Settings cogwheel in the top right corner.
  3. Click on My details.
  4. On the Login information page, you can set up the password for your account.
  5. Input your old password.
  6. Input the new password. You can click on the Generate button to make sure you use a strong password.
  7. Confirm the new password.
  8. Select the password lifetime. For security reasons, we recommend setting up a password expiration date. Master account users can set passwords to never expire. Contact the master user of your account to perform this change on your user account.
  9. Click on the Save button to update the password.
  10. In case you forgot your account password, use the password recovery functionality and a link for generating a new password will be sent to the e-mail address you use to log in to the Merchant Control Panel.

change password_3.png

Search upsell campaigns

Overview

Use the searchUpsellCampaigns method via SOAP API 6.0 to find and filter specific upsell campaigns.

Request Parameters

Parameter Name Type Required/Optional Description

SessionId

String

Required

Unique 2Checkout session ID code.

Name

String

String

Title of the campaign.

PrimaryProductCodes

Array of Strings

Optional

Array of product codes used as primary products you want to filter by.

 PrimaryProductCode

String

Optional

Unique product code.

RecommendedProductCodes

Array of Strings

Optional

Array of product codes used as recommended products you want to filter by.

 RecommendedProductCode

String

Optional

Unique product code.

Statuses

Array of Strings

Optional

Array of statuses you want to filter by.

 Status

String

Optional

Status of the upsell campaign. Can be one of:

 

  • Enabled
  • Disabled
  • Expired

StartsAfter

String

Optional

Date in ‘Y-m-d’ format after which campaigns start.

StartsBefore

String

Optional

Date in ‘Y-m-d’ before campaigns start.

EndsAfter

String

Optional

Date in ‘Y-m-d’ after which campaigns are ending.

EndsBefore

String

Optional

Date in ‘Y-m-d’ before campaigns end.

EnabledForRenewals

Boolean

Optional

Filter campaigns enabled for renewal.

CampaignCodes

Array of Strings

Optional

Array of campaign codes to filter by.

 CampaignCode

String

 

Unique code for an upsell campaign.

Page

Integer

Optional

Page you want to retrieve.

Limit

Integer

Optional

Maximum number of campaigns per page.

Request Example

<?php
 
require ('PATH_TO_AUTH');
 
$filters = new \stdClass();
$filters->Name = 'op_2';
$filters->PrimaryProductCodes = ['A59VUKFMA2', 'JN2GSQ184L'];
$filters->RecommendedProductCodes = ['XI2MNQ41MNH'];
$filters->Statuses = ['DISABLED', 'EXPIRED'];
$filters->StartsBefore = '2020-10-01';
$filters->StartsAfter = '2019-11-05';
$filters->EndsBefore = '2022-11-10';
$filters->EndsAfter = '2020-10-02';
//$filters->EnabledForRenewals = true;
//$filters->CampaignCodes = ['8050a1b7-338e-45bd-9936-17f98b01349e'];
$filters->Page = 1;
$filters->Limit = 10;
 
try {
    $results = $soapClient-> searchUpsellCampaigns ($sessionID, $ filters);
    echo "Search results: </br>",
    var_dump($results);
}
catch (SoapFault $e) {
    echo "Could not search upsell campaigns: " . $e->getMessage();
    exit;
}

Response

Parameter Name Type Required/Optional Description

Page

Integer

Required

The Search page you are on.

Limit

Integer

Required

Maximum number of campaigns per page.

Upsells

Array of Strings

Required

Array of Upsell Campaigns.

   UpsellCampaign

Object

Required

 

UpsellsCount

Integer

Required

Total number of Upsells that fit your search criteria.

PagesCount

Integer

Required

Total number of pages with Upsells that fit your criteria.

 

Create a lead

Overview

The lead management functionality that exists for the ConvertPlus cart can be also integrated with a self-hosted cart.

Use the addLead method to create a lead when a customer abandons the cart before placing an order.

Request Parameters

Parameters Required Type/Description
ProductCode Required String. For catalog products.
ProductName Required String. For dynamic products.
Price Required Number.
BillingDetails Required Array of strings.
DeliveryDetails Required Array of strings.

Request Example

<?php

require ('PATH_TO_AUTH');

$Lead = new stdClass();

$Lead->CartId = "CartIdValue";
$Lead->Currency = "EUR";
$Lead->Language = "EN";
$Lead->ExternalReference = "REST_API_2CHECKOUT";
$Lead->Source = "testAPI.com";
$Lead->CustomerReference = "asdf1";
$Lead->MachineId = "123asd";

$Lead->Items = [];

$Item = new stdClass();
$Item->Code = "04C26C50F8";
$Item->Quantity = 2;
$Item->IsDynamic = false;
$Item->Tangible = true;
$Item->PurchaseType = "PRODUCT";
$Item->PriceOptions = [];

$priceOption = new stdClass();
$priceOption->Name = "group name 1";
$priceOption->Required = false;
$option = new stdClass();
$option->Name = 'add25';
$option->Value = 'add25';
$option->Surcharge = 100;
$priceOption->Options[] = $option;

$Item->PriceOptions[] = $priceOption;

$recurringOptions = new stdClass();
$recurringOptions->CycleLength = 6;
$recurringOptions->CycleUnit = 'MONTH';
$recurringOptions->CycleAmount = 100;
$recurringOptions->ContractLength = 2;
$recurringOptions->ContractUnit = 'YEAR';
$Item->RecurringOptions = $recurringOptions;

$marketingCampaigns = new stdClass();
$marketingCampaigns->Type = 23;
$marketingCampaigns->ParentCode = "m";
$marketingCampaigns->CampaignCode = 23;
$Item->MarketingCampaigns = $marketingCampaigns;

$Item->Price = new stdClass();
$Item->Price->Amount = 20;
$Item->Price->Type = "CUSTOM";

$additionalFields = [];

$additionalField = new stdClass();
$additionalField->Code = "TestFieldOne";
$additionalField->Text = "test text";
$additionalField->Value = "test value";
$additionalFields[] = $additionalField;
$Item->AdditionalFields = $additionalFields;

$Item->SubscriptionStartDate = date("Y-m-d H:i:s");

$Lead->Items[] = $Item;

$billingDetails = new stdClass();
$billingDetails->FirstName = "Customer";
$billingDetails->LastName = "2Checkout";
$billingDetails->Phone = null;
$billingDetails->Company = null;
$billingDetails->FiscalCode = "32423423";
$billingDetails->Email = "customer@2checkout.com";
$billingDetails->Address1 = "Test Address";
$billingDetails->Address2 = null;
$billingDetails->City = "LA";
$billingDetails->Zip = "12345";
$billingDetails->CountryCode = "RO";
$billingDetails->State = "CA";

$Lead->BillingDetails = $billingDetails;
$Lead->DeliveryDetails = clone($billingDetails);

$Lead->DeliveryInformation = new stdClass();
$Lead->DeliveryInformation->ShippingMethod = new stdClass();
$Lead->DeliveryInformation->ShippingMethod->Code = "sdfsd";

$Lead->PaymentDetails = new stdClass();
$Lead->PaymentDetails->Type = "CC";
$Lead->PaymentDetails->Currency = "EUR";
$Lead->PaymentDetails->PaymentMethod = new stdClass();
$Lead->PaymentDetails->PaymentMethod->RecurringEnabled = false;
$Lead->PaymentDetails->PaymentMethod->CardPayment = new stdClass();
$Lead->PaymentDetails->PaymentMethod->CardPayment->InstallmentsNumber = 23;
$Lead->PaymentDetails->CustomerIP = "1.2.3.4";

$Lead->LocalTime = date("Y-m-d H:i:s");

$jsonRpcRequest = array (
    'method' => 'addLead',
    'params' => array($sessionID, $Lead),
    'id' => $i++,
    'jsonrpc' => '2.0'
);

var_dump (callRPC((Object)$jsonRpcRequest, $host, true));

Response Example

class stdClass#18 (3) {
  public $LeadCode =>
  string(10) "60E6C4B574"
  public $CreatedAt =>
  string(19) "2019-11-05T16:39:36"
  public $Errors =>
  array(0) {
  }
}

 

Add translations

Overview

Use the addPromotionTranslations method to add localized texts to existing promotions.

Parameters

Parameter Type/Description

sessionID

Required (string)

 

Output of the Login method.

promotionCode

Required (string)

 

The code corresponding to the promotion that you want to add translations to.

promotions

Required (array of PromotionTranslations objects)

PromotionTranslations  Object

 

language

Required (string)

 

 

ISO country code corresponding to the country you want to set the translation for.

 

name

Required (string)

 

 

Localized promotion name applicable to the selected country.

Response

Parameters Type/Description

promotionTranslation

Object

Request

<?php

require ('PATH_TO_AUTH');

// Promotion code corresponding to the promotion you want to add translations to
$promotionCode = '';

// Defining a translation for German shoppers
$promotionTranslation1 = new stdClass;
$promotionTranslation1->Language = 'de'; 
$promotionTranslation1->Name = 'YOUR_GERMAN_PROMOTION_NAME';

// Defining a translation for Bulgarian shoppers
$promotionTranslation2 = new stdClass;
$promotionTranslation2->Language = 'bg'; 
$promotionTranslation2->Name = 'YOUR_BULGARIAN_PROMOTION_NAME';

$translations = [$promotionTranslation1, $promotionTranslation2];

try {
    $updatedPromotion = $client->addPromotionTranslations($promotionCode, $translations);
}

catch (SoapFault $e) {
    echo "UpdatedPromotion: " . $e->getMessage();
    exit;
}

var_dump("UpdatedPromotion", $updatedPromotion);

 

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