Skip to main content

Partner

Overview

Use the Partner object to search and retrieve partner information.

Structure

Partner Object
PartnerCode String
  Unique identifier that you need to specify when creating a partner in the Control Panel. You can find it under the General Information area when editing partner details.
CompanyName String
  The name of your partner company.
Email String
  The partner email address specified in the Contact Information area.
CommunicationLanguage String
 

ISO 639-1 two-letter language code set for the communication language under Contact information.

Case sensitive: 'en' instead of 'EN'.

 

Possible values:

  • en
  • fr
  • de
Currency String
  The ISO code of the currency set for the partner - ISO 4217. This currency governs transactions between you and the partner. You can configure it in the Commercial settings section, under Payment information.
CreditLimit double
  The credit limit set for the partner. Can be NULL when no credit is offered.
AvailableCreditLimit double
  The credit still available to the partner, after the value of orders already placed but not paid was deducted from the total credit limit configured. Can be NULL when no credit limit is defined.

 

Account Payouts

Overview

Retrieve the account balance from your current payout period, detailed for each billing currency.

You can also search for the historical transfers issued by 2Checkout for your account, and filter the results based on payment date, method or invoice paid.

 

 

Order search options

Overview

Use the OrderSearchOptions object to configure your search order options via JSON-RPC API 6.0.

Object parameters

Parameter name Type Required/Optional Description

ApproveStatus

String

Optional

The desired approved status. Available values: WAITING, OK, FRAUD, INVALIDDATA.

Newer

String

Optional

Needed timestamp. If not provided, will return by default the data for the last 7 days.

Status

String

Optional

Order status. Some of the available options are COMPLETE, PENDING, CANCELED, REFUND.

StartDate

String

Optional

Start date in format Y-m-d. Will overwrite Newer if provided.

EndDate

String

Optional

End date in format Y-m-d.

PartnerOrders

Boolean

Optional

Decide if it will also include partner orders.

ExternalRefNo

String

Optional

The external reference number of the order.

IncludeTestOrders String Optional

Should test orders be included in the result:

Values:

  • YES -  test orders are included
  • NO - test orders are not included
  • ONLY - only the test orders are included
Pagination

Object

Optional

Existing shipping class object with the structure detailed below.

Limit

Int Optional The number of results to be returned

Page

Int Optional The page number

 

 

2Checkout Payment Methods Datasheet

Use local payment methods in conjunction with localization best practices to simplify payments for your international shoppers. But do so keeping in mind the full customer journey from acquisition and conversion through to activation and ultimately retention.

Domestic payment methods are a critical resource to optimize the key stages of transactional processes across the entire customer lifecycle. They fit in the complex puzzle of challenges that includes language and cultural differences, multiple currencies, taxation, user behavior particularities, device and form factor preferences, risk mitigation, legal and regulatory compliance, etc.



Just keep in mind that those so-called “alternative payment methods” can make international customers feel sufficiently “at home” in your shopping cart to result in successful purchases. 

avangate-payment-methods-thumbnail.png

Remove coupon

Overview

Use the deletePromotionCoupon method to remove single or multiple coupons from a promotion.

Parameters

Parameter Type/Description

promotionCode

Required (string)

 

The code corresponding to the promotion that you want to remove coupons from.

promotionCoupon

Required (object)

 

type

Required (string)

 

 

Coupon type. Available values:

  • SINGLE, use in conjunction with Code
  • MULTIPLE, use in conjunction with Codes

 

Code/Codes

Required (string / array of strings)

 

 

Coupon code (for SINGLE) or array of coupon codes (for MULTIPLE).

Response

Parameter Type/Description
promotionCoupon Object

Request

<?php

require ('PATH_TO_AUTH');

// Promotion code corresponding to the promotion you want to remove coupons from
$promotionCode = '';

// Define single coupon object
$promotionCoupon = new stdClass;
$promotionCoupon->Type = 'SINGLE';
$promotionCoupon->Code = 'YOUR_CODE_HERE';

// Define multiple coupon object
$promotionCoupon = new stdClass;
$promotionCoupon->Type = 'MULTIPLE';
$promotionCoupon->Codes = ['YOUR_CODE_1', 'YOUR_CODE_2'];

try {
    $updatedPromotion = $client->addPromotionCoupon ($sessionID, $promotionCode, $promotionCoupon);
}

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

var_dump("UpdatedPromotion", $updatedPromotion);

US ZIP+4 codes

Overview

2Checkout offers support for both standard and ZIP+4 ZIP codes.

Standard US ZIP codes

The standard ZIP code notation used by the United States Postal service uses five digits to identify a delivery area.

An example of a standard US ZIP code is 90210.

ZIP+4 codes

In addition to the classic five-digit ZIP codes used in the United States, 2Checkout also supports the use of ZIP+4 add-on ZIP codes, important when shipping physical goods.

The ZIP+4 system uses the basic five-digit code together with four additional digits to identify a geographic segment located within a five-digit delivery area. The segment can be a city block, a group of apartments or other mail receiving units that could benefit from the use of an additional identifier.

An example of a ZIP+4 ZIP code is 99577-0727.

Payment failed (Direct Debit)

Overview

Use the variables in the list below to customize the Payment failed (Direct Debit) shopper email notifications according to your needs.

Check the 'Mandatory' column to see the variables that are required in your customized version of the e-mail.

Variable name Description Test value Mandatory
BANKACCOUNT Avangate bank account [NLXXABNAXXXXXXXXXX (IBAN)] No
BANKIBAN Avangate bank IBAN ABNANL2XXX No
BANKNAME Avangate bank name  ABN AMRO Bank Amsterdam No
BANKROUTINGNUMBER Avangate bank routing number 0 No
BANKSWIFT Avangate bank swift code ABNANL2XXX No
BUSINESS_COMPANY Avangate company name Avangate Yes
BUSINESS_HOTLINE Avangate support phone +31 88 0000008 No
BUSINESS_HOTLINEUS Avangate US hotline number +1 (650) 963-5701 / (888) 247-1614 No
BUSINESS_OPEMAIL Avangate operational email address support@avangate.com No
BUSINESS_SUPEMAIL Avangate support email address support@avangate.com No
BUY_NOW_NEW_LINK * Prefilled buy link https://secure.avangate.com/ No
COMMERCIALNAME Merchant's commercial name 0 No
CURRENCY Order billing currency USD] Yes
CURRENCY_ORIGINAL Original order currency (applicable to refunds) 0 No
ENCRYPTED_MERCHANT_CODE Encrypted merchant code 0 No
FIRSTNAME Shopper's first name used on the delivery information [John No
GATEWAY_ERROR_CODE Gateway error code GW_PROCESSING_ERROR

See the full
list of Possible Values
No
GATEWAY_ERROR_MESSAGE Reason why the transaction failed. (e.g. Invalid card, insufficient funds) Error processing the card transaction. The card account has not been debited. Card data is invalid or incomplete. No
GENERALTOTAL Total order price [56.50 Yes
HAS_RENEWAL_PRODUCTS Flag that indicates whether at least one product has renewal settings 0 No
IS_RENEWAL Flag that indicates whether at least one product has renewal settings 0 No
LASTNAME Shopper's last name used on the delivery information Doe] No
MYACCOUNT_URL_UPDATE_CC URL for updating credit card information in myAccount 0 No
MY_ACCOUNT_URL_UPDATE_CC URL for updating credit card information in myAccount 0 No
NAMES_OF_PRODUCTS Names of all products in the order, comma separated 0 No
ORDERDATE Order placement date [2017-05-26] Yes
ORDER_AMOUNT_ORIGINAL Original order value (applicable to refunds) 0 No
ORDER_DATE_STANDARD_FORMAT Standard format used for the order placement date 0 No
ORDER_FLOW Purchase flow used to place the order 0 No
ORDER_STATUS Order status 0 No
PAYMENT_TYPE_INFO English payment method name. Includes last four card digits (if applicable). 0 No
PRODUCTS 0 0 No
PRODUCTS[index1].BILLING_CYCLE Indicates how many renewals have been successfully performed so far (on the subscription) 11 No
PRODUCTS[index1].DISCOUNT Product discount value per product line [2.00 No
PRODUCTS[index1].INFO Additional product information defined by merchant when generating buy links [Product info 1] No
PRODUCTS[index1].LICENSE_TYPE Type of purchased subscription 0 No
PRODUCTS[index1].PCODE Product code. [P_CODE_1] No
PRODUCTS[index1].PID Product ID number 1001 No
PRODUCTS[index1].PNAME Product name [Test product name 1] No
PRODUCTS[index1].PRICE Product unit price [20.00 No
PRODUCTS[index1].PRODUCT_OPTIONS[index2] 0 0 No
PRODUCTS[index1].PRODUCT_OPTIONS[index2].OptionText Ignore internal var. 0 No
PRODUCTS[index1].PROMONAME Name of the promotion applied to the product [Some promotion] No
PRODUCTS[index1].QUANTITY Purchased product quantity [2] No
PRODUCTS[index1].SHORT_DESCRIPTION Short product description 0 No
PRODUCTS[index1].TOTAL Total gross price per product line (before applying discounts) [45.60 No
PRODUCTS[index1].VAT VAT/Sales tax value per product line [3.80 No
PRODUCTS_DATA[index1].IdProduct Product ID number 0 No
PRODUCTS_DATA[index1].PRODUCT_SHORT_DESCRIPTION Short product description 0 No
PRODUCTS_NO Number of products in cart 0 No
REFNO Order reference number [9xxxxx] Yes
RETRYLINK Payment retry link 0 No
RETRY_LINK Payment retry link 0 No
SELLERCOMPANY Merchant's company name [Software Company Name] Yes
TOTALEQUIV The order amount converted to all the merchant's currencies 0 No
UNSUBSCRIBE_LINK Shopper unsubscribe link 0 No
UPLOADLINK File upload link 0 No
UPLOAD_LINK File upload link 0 No
WEBSITE Website where the shopper placed the order http://www.software-company-website.com Yes

Copy payment info

Overview

Copy card-on-file data available in the 2Checkout system from a source subscription to an imported target subscription. 2Checkout uses the existing payment information to charge customers as a part of the recurring billing (renewal) process.

Use the copyPaymentInfo method.

Requirements

The imported target subscription and the source subscription must belong to the same customer. The 2Checkout system checks to make sure that the 2Checkout Customer Reference (an internal identifier) coincides for the customer accounts associated to the target and source subscriptions.

Availability

Please contact 2Checkout directly if you wish to take advantage of this feature.

How does this method work?

  1. Customer A purchases Subscription A using a VISA credit card and you import Subscription B for the same customer with no data or with an AMEX card.
  2. When 2Checkout renews Subscription A, it charges Customer A using the VISA, while using the AMEX (if the data was provided) for Subscription B charges.
  3. When you copy the payment data from Subscription A to Subscription B, the 2Checkout system uses the VISA credit card to renew both subscriptions according to with their respective recurring billing cycles. 2Checkout charges customers during the recurring billing process for the imported target subscription using the payment method they used to purchase the source subscription.

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.

TargetSubscriptionReference

Required (string)

 

The 2Checkout Subscription Reference of the imported target subscription, to which 2Checkout copies the payment on file data associated with the source subscription.

SubscriptionReference

Required (string)

 

The 2Checkout Subscription Reference of the source subscription whose attached payment on file data 2Checkout copies to the target subscription.

Response

Parameter Type/Description

Boolean

true or false depending on whether or not the operation succeeded.

Request

<?php

require ('PATH_TO_AUTH');

var_dump($sessionID);
$TargetSubscription = 'FFAE3C9429';
$SourceSubscription = '9F4154733C';

$jsonRpcRequest = array (
'method' => 'copyPaymentInfo',
'params' => array($sessionID, $TargetSubscription, $SourceSubscription),
'id' => $i++,
'jsonrpc' => '2.0');

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

?>

 

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