How to configure auto-renewal enrollment campaigns
Overview
2Checkout offers an easy way to increase your revenue by giving your shoppers the option to enroll into auto-renewal campaigns in their myAccount.
Important: 2Checkout triggers auto-renewal campaigns only for products/subscriptions that have been paid with online payment methods.
You can find the retention tools in the Marketing tools menu.
Here you can configure auto-renewal enrollment campaigns for your shoppers and offer them discounts for enrolling.
Setting up auto-renewal campaigns
- Click Add new campaign
- Fill in the details of the campaign: name, running interval and discount percentage. You can also set the discount to apply to all the following billing cycles or define a custom number of billing cycles to apply it to.
- Choose whether or not to apply this campaign to subscriptions with custom price by checking or un-checking the Apply for subscriptions that are using product catalog pricing only option.
- Select the products that you want the campaign to be applied to from the Available products list and add them to the Selected products list.
- Click Save campaign when you're done.
The campaign is now created and displayed as Ready. Click Start campaign to start it.
You can see the status of your campaign in the Retention tools page. An auto-renewal enrollment campaign can have the following statuses:
- Scheduled = a campaign that didn't reach Running status yet. You can edit or stop it from running in the future.
- Ready = a campaign that you have not started or one that you've stopped before its end date. You can edit it.
- Running = a campaign that is currently running. You can stop it or view its settings. You can add products to a running campaign.
- Finished = a campaign that passed its end date. You can view its settings but you cannot edit it.
If the campaign is Scheduled, you can click Edit if you want to modify its settings.
Important: You can only edit Ready campaigns and Scheduled ones. You cannot edit Running campaigns.
How to search for auto-renewal campaigns
Use the Auto-renewal enrollment search filters to find specific campaigns that you have previously set. You can search campaigns by:
- Name
- Status
- Starting date
- Product applied to
Important: Searching campaigns by the starting date returns all the campaigns that had started in the specified time interval.
Click Search when you're done configuring the filters.
You'll see the search results in the table at the bottom of the page along with possible actions that you can take on the campaigns. You can only edit Ready campaigns and Scheduled ones. You cannot edit Running campaigns. You can view the details of Running and Finished campaigns.
How to run auto-renewal campaign reports
You can find the Auto-renewal campaigns reports in the Main reports section of the Reports center menu.
- Open the Reports center menu and click Main reports
- Click the Enrollment statistics category to access the reports page.
- Use the filters in the Report settings section to define the campaigns that you want to include in the report. Click Build report when you're done.
The report shows the top 10 auto-renewal enrollment campaigns. The rest of the campaigns are aggregated in the Other entry. The data included in the report comes from campaigns that ran in the selected interval.
You can also export the full report as CSV by clicking Export as CSV. The exported report contains details about all of your campaigns.
How do shoppers enroll in auto-renewal campaigns?
Your shoppers can enroll in the auto-renewal campaigns by visiting 2Checkout myAccount and clicking the enrollment link.
Enable recurring billing
Overview
Use the enableRecurringBilling method to switch on the automatic renewal system for a subscription that's manually renewable.
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. |
subscriptionReference |
Required (string) |
Unique, system-generated subscription identifier. |
Response
Parameters | Type/Description |
---|---|
Boolean |
true or false depending on whether the changes were successful or not. |
Request
<?php
require ('PATH_TO_AUTH');
$subscriptionReference = 'YOUR_SUBSCRIPTION_REFERENCE';
$jsonRpcRequest = array (
'method' => 'enableRecurringBilling',
'params' => array($sessionID, $subscriptionReference),
'id' => $i++,
'jsonrpc' => '2.0');
var_dump (callRPC((Object)$jsonRpcRequest, $host, true));
Retrieve SKU details
Overview
Use the getSkuDetails method to retrieve SKU details based on its ID.
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. | |
skuCode | Required (string) |
Unique identifier of the SKU. |
Response
{
"PricingConfigurationCode":"{PricingConfigurationCode}",
"ProductCode":"{ProductCode}",
"Currency":"{Currency}",
"PriceOptions":[{PriceOption1},{PriceOption2}],
"PurchaseType":"{PurchaseType}",
"FromQuantity":"{FromQuantity}",
"ToQuantity":"{ToQuantity}"
}
Request
<?php
require ('PATH_TO_AUTH');
$sku = 'YOUR_SKU_CODE';
try {
$getSkuDetails = $client->getSkuDetails($sessionID, $sku);
} catch (SoapFault $e) {
echo $e->getMessage();
}
var_dump($getSkuDetails);
Retrieve an order
Overview
Use the getOrder method to retrieve details on a specific order using its unique, system-generated reference.
Parameters
Parameters |
Type/Description |
sessionID |
Required (string) |
|
Session identifier, the output of the Login method. Include sessionID into all your requests. A2Checkout throws an exception if the values are incorrect. The sessionID expires in 10 minutes. |
orderReference |
Required (string) |
|
Order reference number of an older order, which is already approved/paid. |
Response
Object |
Request
<?php
$host = "https://api.avangate.com";
$client = new SoapClient($host . "/soap/3.0/?wsdl", array(
'location' => $host . "/soap/3.0/",
"stream_context" => stream_context_create(array(
'ssl' => array(
'verify_peer' => false,
'verify_peer_name' => false
)
))
));
function hmac($key, $data)
{
$b = 64; // byte length for md5
if (strlen($key) > $b) {
$key = pack("H*", md5($key));
}
$key = str_pad($key, $b, chr(0x00));
$ipad = str_pad('', $b, chr(0x36));
$opad = str_pad('', $b, chr(0x5c));
$k_ipad = $key ^ $ipad;
$k_opad = $key ^ $opad;
return md5($k_opad . pack("H*", md5($k_ipad . $data)));
}
$merchantCode = "YOUR_MERCHANT_CODE";// your account's merchant code available in the 'System settings' area of the cPanel: https://secure.2checkout.com/cpanel/account_settings.php
$key = "YOUR_SECRET_KEY";// your account's secret key available in the 'System settings' area of the cPanel: https://secure.2checkout.com/cpanel/account_settings.php
$now = gmdate('Y-m-d H:i:s'); //date_default_timezone_set('UTC')
$string = strlen($merchantCode) . $merchantCode . strlen($now) . $now;
$hash = hmac($key, $string);
try {
$sessionID = $client->login($merchantCode, $now, $hash);
}
catch (SoapFault $e) {
echo "Authentication: " . $e->getMessage();
exit;
}
$orderReference = '43403739';
try {
$fullOrderDetails = $client->getOrder ($sessionID, $orderReference);
}
catch (SoapFault $e) {
echo "fullOrderDetails: " . $e->getMessage();
exit;
}
var_dump("fullOrderDetails", $fullOrderDetails);
?>
Place orders with catalog products
Overview
Use this object to create new orders and collect payments from shoppers using catalog products defined in your Control Panel.
For orders that require physical delivery, if no shipping methods are provided, 2Checkout will add to cart your account's default shipping configuration.
For more details about how to be PCI compliant before accepting CC payments, see this page.
Supported payment methods/flows
- Credit/Debit cards: Visa, Visa Electron, MasterCard, Maestro, Amex, Discover, Dankort, Carte Bleue, JCB. 2Checkout supports local Brazilian cards.
- PayPal and PayPal Express
- Purchase Order
- Wire
- Check
- WeChat Pay
- iDEAL
- TEST orders
- Free orders (no payment information required)
- Previous order references - In addition to the payment methods enumerated above, 2Checkout also supports 1-click purchase flows in which you use valid previous order references belonging to returning customers to pay for new orders with their previously used cards and PayPal accounts.
Requirements
For credit card orders placed using 2Checkout API 5.0 or a more recent version, you need to pass through additional parameters that support the 3D Secure flow. 3D Secure works by redirecting customers to pages provided by their banks, where they need to enter additional security tokens or password to trigger the completion of the charge. By using 3D Secure, you get additional protection from liability for fraudulent card payments, with customers having to go through an extra layer of authentication.
Send the following parameters in the placeOrder call, as part of the PaymentDetails object:
Parameters | Description |
---|---|
Vendor3DSReturnURL | Required (string) |
URL address to which customers are redirected after the 3DS details get validated by the bank and the order is successfully authorized. | |
Vendor3DSCancelURL | Required (string) |
URL address to which customers are redirected if the 3DS details were not validated or the order could not be authorized. |
Response
Parameters | Type/Description |
---|---|
Object |
|
Object containing order information. |
Parameters
Parameters | Type/Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Currency |
String / Optional |
||||||||||
|
The currency ISO code for the payment - ISO 4217. Example: “usd.” |
||||||||||
Country |
String / Optional | ||||||||||
|
Shopper country. ISO 3166 two-letter code. Example: “us.” |
||||||||||
Language |
String / Optional | ||||||||||
|
ISO 639-1 two-letter code. The language used for the purchase process. Example: “en.” |
||||||||||
ExternalReference |
String / Optional | ||||||||||
|
Set external reference identifiers for orders. Enables you to replicate the functionality of the REF parameter included into Buy Links. Maximum 100 characters. If there is a need for longer references, you can apply an md5 hash for any string value, resulting in a 32 characters string. You can verify the hash after the order notification, on the client side. |
||||||||||
Source |
String / Optional | ||||||||||
|
The link source for the sales. Enables you to replicate the functionality of the SRC (separate link identifier) parameter when included into Buy Links. Use the SRC parameter to track sale sources.
Maximum length 255 characters. |
||||||||||
CustomerReference |
Integer / Optional | ||||||||||
|
Set an external customer ID, attached to the customer. |
||||||||||
Items |
Array of object / Required |
||||||||||
|
Details below. |
||||||||||
|
OrderItem |
Object |
|||||||||
|
|
|
Details below. |
||||||||
|
|
Code |
String / Optional | ||||||||
|
|
|
Unique product identifier your control. Max length 256 characters. Only for catalog products. |
||||||||
|
|
Quantity |
Integer / Optional | ||||||||
|
|
|
Number of units |
||||||||
|
|
PriceOptions |
Array of strings / Optional |
||||||||
|
|
|
Array of price option codes. |
||||||||
|
|
SKU |
String / Optional | ||||||||
|
|
|
SKU identifier. |
||||||||
|
|
Price |
Object - Can be NULL. If Price Type is set to 'CUSTOM', dynamic pricing can be added to the order via the Amount parameter. |
||||||||
|
|
CrossSell |
Object – Can be NULL |
||||||||
|
|
|
|
Details below. |
|||||||
|
|
|
ParentCode |
String | |||||||
|
|
|
|
The product code of the master product you set to trigger the campaign. |
|||||||
|
|
|
CampaignCode |
String | |||||||
|
|
|
|
Unique, system-generated identifier for cross-sell campaigns. |
|||||||
|
|
Trial |
Object – Can be NULL |
||||||||
|
|
|
|
Details below. |
|||||||
|
|
|
Period |
Integer |
|||||||
|
|
|
|
The length of the trial subscription lifetime in days. |
|||||||
|
|
|
Price |
Double / Optional |
|||||||
|
|
|
|
Total trial price in the payment currency before 2Checkout deducts any taxes, discounts, etc. |
|||||||
|
|
AdditionalFields |
Array of objects – Can be NULL |
||||||||
|
|
|
AdditionalFieldSet |
Object – Can be NULL |
|||||||
|
|
|
|
Code |
String |
||||||
|
|
|
|
|
The alpha-numeric characters, underscores and dashes that are set as the field identifier. |
||||||
|
|
|
|
Value |
String | ||||||
|
|
|
|
|
Selected field value. |
||||||
SubscriptionStartDate | String | ||||||||||
Specify the date time stamp when the subscription becomes active. Format 2016-07-02 22:22:22 (YYYY-MM-DD HH:mm:ss). Available for JSON-RPC and REST. Send empty or NULL to activate subscriptions on the same date when customers purchase them. You can exclude HH:mm:ss when sending the date and include only YYYY-MM-DD. In this case, 2Checkout uses 00:00:01. Default time zone GMT+02:00. |
|||||||||||
BillingDetails |
Object / Required |
||||||||||
|
|
Details below. |
|||||||||
|
|
FirstName |
String / Required |
||||||||
|
|
|
Shopper name. |
||||||||
|
|
LastName |
String / Required | ||||||||
|
|
|
Shopper surname. |
||||||||
|
|
CountryCode |
String / Required | ||||||||
|
|
|
Shopper country. ISO 3166 two-letter code. |
||||||||
|
|
State |
String / Optional – Required for US, Turkey, India and Romania |
||||||||
|
|
|
The state in the shopper's country. Mandatory when you set the Billing Country to US, Turkey, India and Romania. Use case insensitive utf8 strings for the full name, or just the two letter code. |
||||||||
|
|
City |
String / Optional | ||||||||
|
|
|
Shopper city. |
||||||||
|
|
Address1 |
String / Optional | ||||||||
|
|
|
Shopper address. |
||||||||
|
|
Address2 |
String / Optional | ||||||||
|
|
|
Shopper address. |
||||||||
|
|
Zip |
String / Optional | ||||||||
|
|
|
ZIP/ Postal code. |
||||||||
|
|
|
String / Optional | ||||||||
|
|
|
Shopper email address. |
||||||||
|
|
Phone |
String / Optional | ||||||||
|
|
|
Shopper phone number. Mandatory when you set Brazil as the Billing Country. Can be NULL. |
||||||||
|
|
Company |
String / Optional | ||||||||
|
|
|
Company name. Can be null for end users. When present, you also need to provide the FiscalCode. |
||||||||
|
FiscalCode |
String / Optional– Required for Brazil |
|||||||||
|
|
• For companies, it needs to be the VAT ID. 2Checkout will validate the value provided and throw an error if the VAT ID is invalid/incorrect when calling setPaymentDetails. When present, you also need to provide the Company name. • Mandatory when you set Brazil as the Billing Country. For Brazilian customers it represents the Fiscal Code (CPF/CNPJ). • Mandatory when you set India as the Billing Country, and purchase is made by a Company. • Can be NULL for end users. |
|||||||||
DeliveryDetails |
Object / Required |
||||||||||
|
|
Details below. |
|||||||||
|
|
FirstName |
String / Required |
||||||||
|
|
|
Shopper name from the delivery details. |
||||||||
|
|
LastName |
String / Required | ||||||||
|
|
|
Shopper surname from the delivery details. |
||||||||
|
|
CountryCode |
String / Required | ||||||||
|
|
|
Shopper country. ISO 3166 two-letter code from the delivery details. |
||||||||
|
|
State |
String / Optional – Required for US, Brazil and Romania |
||||||||
|
|
|
The state in the shopper's country from the delivery details. Mandatory when you set the Billing Country to US, Brazil and Romania. Use case insensitive utf8 strings for the full name, or just the two letter code. |
||||||||
|
|
City |
String / Optional | ||||||||
|
|
|
Shopper city from the delivery details. |
||||||||
|
|
Address1 |
String / Optional | ||||||||
|
|
|
Shopper address from the delivery details. |
||||||||
|
|
Address2 |
String / Optional | ||||||||
|
|
|
Shopper address from the delivery details. |
||||||||
|
|
Zip |
String / Optional | ||||||||
|
|
|
ZIP/ Postal code from the delivery details. |
||||||||
|
|
|
String / Optional | ||||||||
|
|
|
Shopper email address from the delivery details. |
||||||||
|
|
Phone |
String / Optional | ||||||||
|
|
|
Shopper phone number from the delivery details. Mandatory when you set Brazil as the Billing Country. Can be NULL. |
||||||||
|
|
Company |
String / Optional | ||||||||
|
|
|
Company name from the delivery details. Can be null for end users. When present, you also need to provide the FiscalCode. |
||||||||
DeliveryInformation |
Object / Optional For products that require physical delivery, use this object to send the shipping method. |
||||||||||
ShippingMethod |
Object Details below |
||||||||||
Code | String | ||||||||||
System-generated identified for your shipping method configuration | |||||||||||
PaymentDetails |
Object / Required |
||||||||||
|
Adapt this object to the desired payment method. |
||||||||||
|
Type |
Required (string) |
|||||||||
|
|
The payment method:
|
|||||||||
|
Currency |
Optional (string) |
|||||||||
|
|
The currency ISO code for the payment - ISO 4217. Example: “usd.” |
|||||||||
|
PaymentMethod |
Optional (object) |
|||||||||
|
|
Object structure and parameters differ according to payment method selected and API method (placing orders (POST) vs. retrieving order data (GET)).
NULL for 0 value orders for which you’re not requiring customers to enter payment details. |
|||||||||
RecurringEnabled | Optional (boolean)Optional (boolean) | ||||||||||
true – shopper checks the auto renewal checkbox and 2Checkout charges subscription renewals using a recurring billing process. false – shopper doesn’t check the auto renewal checkbox. |
|||||||||||
|
|
|
CardPayment |
Optional (object) |
|||||||
|
|
|
|
|
Details below. |
||||||
|
|
|
|
CardNumber |
Required (string) |
||||||
|
|
|
|
|
The credit/debit card number. |
||||||
|
|
|
|
CardType |
Required (string) |
||||||
|
|
|
|
|
visa, visaelectron, mastercard, maestro, amex, discover, dankort, cartebleue, jcb, hipercard, elo |
||||||
|
|
|
|
ExpirationYear |
Required (string) |
||||||
|
|
|
|
|
The year in which the card expires. |
||||||
|
|
|
|
ExpirationMonth |
Required (string) |
||||||
|
|
|
|
|
The month in which the card expires. |
||||||
|
|
|
|
HolderName |
Required (string) |
||||||
|
|
|
|
|
Card holder name. |
||||||
|
|
|
|
CCID |
Required (string) |
||||||
|
|
|
|
|
Credit Card Identification - an extra ID printed on the card, usually a 3-4 digit number, the CVC2/CVV2. |
||||||
Vendor3DSReturnURL | Required (string) | ||||||||||
URL address to which customers are redirected after the 3DS details get validated by the bank and the order is successfully authorized. | |||||||||||
Vendor3DSCancelURL | Required (string) | ||||||||||
URL address to which customers are redirected if the 3DS details were not validated or the order could not be authorized. | |||||||||||
HolderNameTime | Optional (float) | ||||||||||
The interval of time in seconds in which shoppers enter their name in the HolderName field. An abnormally short interval is usually a red flag for fraud attempts. Can be NULL, but not a negative number. |
|||||||||||
CardNumberTime | Optional (float) | ||||||||||
The interval of time in seconds in which shopper enter their card number in the CardNumber field. An abnormally short interval is usually a red flag for fraud attempts. Can be NULL, but not a negative number. |
|||||||||||
|
|
|
|
InstallmentsNumber |
Optional (Int) |
||||||
|
|
|
|
|
Number of installments. Available only when customers un Brazil pay with Visa or MasterCard using Brazilian Real as the order currency. Use 1 or exclude the parameter for full payments. |
||||||
|
|
|
PayPalExpress |
Optional (object) |
|||||||
|
|
|
|
|
Details below. |
||||||
|
|
|
|
|
Optional (string) |
||||||
|
|
|
|
|
Email address customers use for their PayPal account. |
||||||
|
|
|
|
ReturnURL |
Optional (string) |
||||||
|
|
|
|
|
The PayPal Express Checkout redirect URL returned by calling the getPayPalExpressCheckoutRedirectURL method. The return URL is the page on your website to which PayPal redirects yourbuyer's browser after the buyer logs into PayPal and approves the payment. Typically, this is a secure page (https://...) on your site. |
||||||
|
|
|
|
CancelURL |
Optional (string) |
||||||
|
|
|
|
|
The cancel URL is the page on your website to which PayPal redirects your buyer's browser if the buyer does not approve the payment. Typically, this is the secure page (https://...) on your site from which you redirected the buyer to PayPal. |
||||||
|
|
|
PreviousOrder |
Optional (Object) |
|||||||
|
|
|
|
|
Details below. |
||||||
|
|
|
|
RefNo |
Optional (string) |
||||||
|
|
|
|
|
Order reference a previous purchase which reached the Approved/Complete status. You can use order for which customers paid with credit/debit cards or with PayPal. The status of order should be AUTHRECEIVED or COMPLETE.
Check the validity of references with the isValidOrderReference method.
The 2Checkout system blocks you from using references for fraudulent or potentially fraudulent orders. |
||||||
|
|
|
PurchaseOrderPaymentDetails |
Optional (Object) |
|||||||
|
|
|
|
|
Details below. |
||||||
|
|
|
|
InternalPONumber |
Optional (string) |
||||||
|
|
|
|
|
Identifier that business customers use internally in their organization to track and manage Purchase Orders (PO). Can be NULL. |
||||||
|
|
|
|
AutoApprove |
Optional (boolean) |
||||||
|
|
|
|
|
TRUE - requires activation of the PO AutoApprove package (If the package is inactive 2Checkout returns an error). Please contact 2Checkout. When AutoApprove is TRUE, 2Checkout no longer requires that business customers upload a PO document. As such, PO orders are automatically approved for your account, without a PO doc. 2Checkout sets the PURCHASE_PENDING status for auto-approved PO orders. FALSE - Default. Send this if the PO AUtoApprove package is not available for your account. 2Checkout uses the same flow as cart purchases with Purchase Orders for business customers placing orders with POs via API. This means that customers receive the same emails as if they made the purchase using the cart and need to update the PO document, which is reviewed by 2Checkout and that you need to approve. 2Checkout sets the AVAITING_UPLOAD status for POs andUnfinished for their orders.
Can be NULL. |
||||||
WE_CHAT_PAY | Optional (string) | ||||||||||
Details below | |||||||||||
ReturnURL | Optional (string) | ||||||||||
The return URL is the page to which your customers are redirected after their successful payment. | |||||||||||
CancelURL | Optional (string) | ||||||||||
The cancel URL is the page to which your customers are redirected after their failed payment attempt. | |||||||||||
IDEAL | Optional (string) | ||||||||||
Details below | |||||||||||
ReturnURL | Optional (string) | ||||||||||
The return URL is the page to which your customers are redirected after their successful payment. | |||||||||||
CancelURL | Optional (string) | ||||||||||
The cancel URL is the page to which your customers are redirected after their failed payment attempt. | |||||||||||
BankCode | Required (string) | ||||||||||
String contains the SWIFT code of the bank, the plus sign "+", and the first 3 characters from the bank name. E.q.: in the case of Rabobank, code parameter is "RABONL2U+RAB". | |||||||||||
|
|
|
EXISTING_PAYMENT_DATA |
Optional (Object) |
|||||||
|
|
|
|
By using EXISTING_PAYMENT_DAT you no longer require shoppers to enter any payment details. |
|||||||
|
|
|
|
TransientToken |
Optional (string) |
||||||
|
|
|
|
|
Returned as a part of the process of retrieving customer information by SSOToken. |
||||||
|
CustomerIP |
Required (string) |
|||||||||
|
|
Shopper IP. |
|||||||||
Promotions |
Optional (Array of strings) |
||||||||||
|
Array of promotion codes. |
||||||||||
AdditionalFields |
Object / Optional |
||||||||||
|
|
Details below. |
|||||||||
|
Code |
Optional (string) |
|||||||||
|
|
The alpha-numeric characters, underscores and dashes that are set as the field identifier. |
|||||||||
|
Text |
Optional (string) |
|||||||||
|
|
Field text visible to shoppers in the cart. |
|||||||||
|
Value |
Optional (string) |
|||||||||
|
|
Selected field value. |
|||||||||
LocalTime |
Optional (string) |
||||||||||
|
Local shopper time in the following format: Y-m-d H:i:s. This parameter can impact the fraud score of an order when it's missing, NULL or incorrectly formatted. |
||||||||||
GiftDetails |
Optional (object) |
||||||||||
|
Contains contact details for the recipient of a gift purchase. |
||||||||||
|
FirstName |
Optional (string) |
|||||||||
|
|
First name of gift recipient. |
|||||||||
|
LastName |
Optional (string) |
|||||||||
|
|
Last name of gift recipient. |
|||||||||
|
|
Optional (string) |
|||||||||
|
|
Email of gift recipient. 2Checkout uses this email for the delivery/fulfillment process. |
|||||||||
|
GiftNote |
Optional (string) |
|||||||||
|
|
Custom text shoppers provide as a message to the gift recipient. |
Retrieve campaign texts
Overview
Use the getCrossSellTexts method to extract information on all cross-sell campaigns texts.
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. |
LanguageCode |
Required (string) |
|
ISO language code. (ISO 639-1 two-letter code). |
Response
Parameters | Type/Description |
---|---|
Title |
String |
|
Cross-selling message title. Set here. |
Description |
String |
|
Cross-selling message description. Set here. |
Language |
String |
Request
<?php
require ('PATH_TO_AUTH');
$LanguageCode = 'de'; //returns title and description texts you set under https://secure.2checkout.com/cpanel/network_cross_selling_settings.php
$jsonRpcRequest = new stdClass();
$jsonRpcRequest->jsonrpc = '2.0';
$jsonRpcRequest->method = 'getCrossSellTexts';
$jsonRpcRequest->params = array(
$sessionID,
$LanguageCode
);
$jsonRpcRequest->id = $i++;
var_dump(" \n Cross-sell campaigns: \n", callRPC($jsonRpcRequest, $host));
Subscription additional information fields
Overview
Use this object to assign, update, retrieve and delete additional information fields from your subscriptions.
Parameters
Parameters | Type/Description |
---|---|
fieldName |
String |
The name of the additional information field. Used for identifying additional information fields. |
|
fieldValue |
String |
|
The value of the additional information field. |
Add order/product additional fields
Overview
Use the addAdditionalField method to create new additional fields for your account.
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. |
Object |
|
|
Additional field object. |
Request
<?php
require ('PATH_TO_AUTH');
$AdditionalField = new stdClass();
$AdditionalField->Label = 'Do you agree with the new newsletter policy 2015?';
$AdditionalField->Type = 'LISTBOX';
$AdditionalField->Code = 'NewsletterPolicy1234576';
$AdditionalField->ApplyTo = 'ORDER';
$AdditionalField->Values = array();
$AdditionalField->Values[0] = 'YES';
$AdditionalField->Values[1] = 'NO';
$AdditionalField->ValidationRule = null;
$AdditionalField->Translations = array();
$AdditionalField->Translations[0] = new stdClass();
$AdditionalField->Translations[0]->Label = "Êtes-vous d'accord avec la politique de la newsletter?";
$AdditionalField->Translations[0]->Values = array();
$AdditionalField->Translations[0]->Values[0] = 'Oui';
$AdditionalField->Translations[0]->Values[1] = 'Non';
$AdditionalField->Translations[0]->Language = 'fr';
$AdditionalField->Translations[1] = new stdClass();
$AdditionalField->Translations[1]->Label = 'Haben Sie mit dem Newsletter Politik zu?';
$AdditionalField->Translations[1]->Values = array();
$AdditionalField->Translations[1]->Values[0] = 'Ja';
$AdditionalField->Translations[1]->Values[1] = 'Nein';
$AdditionalField->Translations[1]->Language = 'de';
$jsonRpcRequest = array(
'jsonrpc' => '2.0',
'id' => $i++,
'method' => 'addAdditionalField',
'params' => array(
$sessionID,
$AdditionalField
)
);
var_dump(callRPC((Object) $jsonRpcRequest, $host));
?>
Response
bool(true)
Retrieve price option groups
Overview
Use the searchPriceOptionGroups to extract information on the price option groups you configured.
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. |
PriceOptionGroupSearch |
Optional (object) |
|
Details below |
PriceOptionGroupSearch |
Object Details below |
Name |
Optional (string) |
|
The name of the pricing options groups configured in the 2Checkout system. Can be NULL. |
Types |
Optional (array) |
|
Possible values:
Can be NULL. |
Limit |
Optional (int) |
|
Number of results displayed per page. Default maximum value is 10. Can be NULL. |
Page |
Optional (int) |
|
A specific page of search results. Default value is 1. Can be NULL. |
Response
Parameters | Type/Description |
---|---|
Array of objects |
Request
<?php
require ('PATH_TO_AUTH');
try {
$existentPriceOptions = $client->searchPriceOptionGroups($sessionID, $SearchOptions);
}
catch (SoapFault $e) {
echo "existentPriceOptions: " . $e->getMessage();
exit;
}
var_dump("existentPriceOptionst", $existentPriceOptions);
?>