RecurringBilling Class

Properties   Methods   Events   Config Settings   Errors  

The RecurringBilling class is used to authorize and set up recurring transactions with any of the supported Internet Payment Gateways.

Syntax

RecurringBilling

Remarks

The RecurringBilling class allows you to use multiple Internet Payment Gateways through one interface and one class. This allows for easy migration from one gateway to another, as well as quick integration into applications or web services.

RecurringBilling Gateway Setup and Required Properties

The RecurringBilling class allows your website to securely perform and setup recurring transactions without the need to redirect to a separate website. All transactions are accomplished through a secure HTTPS Post to any supported gateway. The secure response is received and then stored in the class's response properties. Any website or any stand-alone application can process transactions without the need for a secure server or third-party intervention.

Gateway Setup

The first thing you must do is select one of the many gateways supported by the RecurringBilling class, and set up an account with that gateway. Once you have an account set up with a valid (or test) login Id and password, you can use the RecurringBilling class.

To begin, set the Gateway property to the gateway you wish to use. If this gateway supports an alternate URL to send test transactions to, set the GatewayURL at this time.

Next, set the MerchantLogin (and for some gateways the MerchantPassword). These are supplied by your gateway vendor when you set up an account.

Many gateways have different setup requirements. See RecurringBilling Gateway Setup and Required Properties for details about each gateway's requirements.

Now you are ready to process transactions. For each transaction, you must set either Card or Bank. Most gateways will also require additional properties, such as CustomerAddress, CustomerFirstName, CustomerLastName, InvoiceNumber, etc.

Subscription Management

Once all required properties are set, you may create a recurring payment using the specified card or bank data by calling the CreateSubscription method. If the Gateway supports it, you may also Cancel recurring payments with the CancelSubscription method. Recurring payments that need to be changed may be updated with the UpdateSubscription method.

The following gateways are supported by the RecurringBilling class:

Property List

The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the class with short descriptions. Click on the links for further details.

CardType Property (RecurringBilling Class)

Type of credit card being used in this transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardType();
int SetCardType(int iCardType);

Unicode (Windows)
INT GetCardType();
INT SetCardType(INT iCardType);

CT_UNKNOWN(0), 
CT_VISA(1), 
CT_MASTER_CARD(2), 
CT_AMEX(3), 
CT_DISCOVER(4), 
CT_DINERS(5), 
CT_JCB(6), 
CT_VISA_ELECTRON(7), 
CT_MAESTRO(8), 
CT_LASER(10)

int inpay_recurringbilling_getcardtype(void* lpObj);
int inpay_recurringbilling_setcardtype(void* lpObj, int iCardType);

int GetCardType();
int SetCardType(int iCardType);

Default Value

0

Remarks

Type of credit card being used in this transaction. This property contains the customer's credit card type. This is automatically computed after the CardNumber is set, but it can also be changed manually. A list of valid card types is included below.

This property is not available at design time.

Data Type

Integer

CardCVVData Property (RecurringBilling Class)

Three digit security code on back of card (optional).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCardCVVData();
int SetCardCVVData(const char* lpszCardCVVData);

Unicode (Windows)
LPWSTR GetCardCVVData();
INT SetCardCVVData(LPCWSTR lpszCardCVVData);

char* inpay_recurringbilling_getcardcvvdata(void* lpObj);
int inpay_recurringbilling_setcardcvvdata(void* lpObj, const char* lpszCardCVVData);

QString GetCardCVVData();
int SetCardCVVData(QString qsCardCVVData);

Default Value

""

Remarks

Three digit security code on back of card (optional).

This alphanumeric property contains the three digit Visa "Card Verification Value" (CVV), MasterCard "Card Verification Code" (CVC), or four-digit American Express "Card Identification Number" (CID). This value appears as additional characters embossed on the card signature line following the credit card account number on the back of the credit card. This is an optional property which can be used to determine if the customer is actually in possession of the credit card.

Even if the CardCVVData is incorrect, the transaction may still be authorized. It is up to the merchant to examine the ResponseCVVResult property and decide whether to honor the transaction or not.

Note: When set to a non-empty value, CardCVVPresence will be automatically set to cvpProvided. If set to empty string (""), CardCVVPresence will be automatically set to cvpNotProvided.

This property is not available at design time.

Data Type

String

CardCVVPresence Property (RecurringBilling Class)

Indicates the presence of the card verification value.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardCVVPresence();
int SetCardCVVPresence(int iCardCVVPresence);

Unicode (Windows)
INT GetCardCVVPresence();
INT SetCardCVVPresence(INT iCardCVVPresence);

CVP_NOT_PROVIDED(0), 
CVP_PROVIDED(1), 
CVP_ILLEGIBLE(2), 
CVP_NOT_ON_CARD(3)

int inpay_recurringbilling_getcardcvvpresence(void* lpObj);
int inpay_recurringbilling_setcardcvvpresence(void* lpObj, int iCardCVVPresence);

int GetCardCVVPresence();
int SetCardCVVPresence(int iCardCVVPresence);

Default Value

0

Remarks

Indicates the presence of the card verification value.

This property is used to indicate the presence of CardCVVData.

The class will automatically set this value to cvpProvided when a CardCVVData value is specified. You can explicitly specify the CardCVVPresence indicator by setting this property.

Available values are:

• cvpNotProvided (0)
• cvpProvided (1)
• cvpIllegible (2)
• cvpNotOnCard (3)

This property is not available at design time.

Data Type

Integer

CardEntryDataSource Property (RecurringBilling Class)

This property contains a 1-character code identifying the source of the customer data.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardEntryDataSource();
int SetCardEntryDataSource(int iCardEntryDataSource);

Unicode (Windows)
INT GetCardEntryDataSource();
INT SetCardEntryDataSource(INT iCardEntryDataSource);

EDS_TRACK_1(0), 
EDS_TRACK_2(1), 
EDS_MANUAL_ENTRY_TRACK_1CAPABLE(2), 
EDS_MANUAL_ENTRY_TRACK_2CAPABLE(3), 
EDS_MANUAL_ENTRY_NO_CARD_READER(4), 
EDS_TRACK_1CONTACTLESS(5), 
EDS_TRACK_2CONTACTLESS(6), 
EDS_MANUAL_ENTRY_CONTACTLESS_CAPABLE(7), 
EDS_IVR(8), 
EDS_KIOSK(9)

int inpay_recurringbilling_getcardentrydatasource(void* lpObj);
int inpay_recurringbilling_setcardentrydatasource(void* lpObj, int iCardEntryDataSource);

int GetCardEntryDataSource();
int SetCardEntryDataSource(int iCardEntryDataSource);

Default Value

0

Remarks

This property contains a 1-character code identifying the source of the customer data. The table below shows all supported values for this property.

This property is not available at design time.

Data Type

Integer

CardExpMonth Property (RecurringBilling Class)

Expiration month of the credit card specified in Number .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardExpMonth();
int SetCardExpMonth(int iCardExpMonth);

Unicode (Windows)
INT GetCardExpMonth();
INT SetCardExpMonth(INT iCardExpMonth);

int inpay_recurringbilling_getcardexpmonth(void* lpObj);
int inpay_recurringbilling_setcardexpmonth(void* lpObj, int iCardExpMonth);

int GetCardExpMonth();
int SetCardExpMonth(int iCardExpMonth);

Default Value

1

Remarks

Expiration month of the credit card specified in CardNumber.

This property contains the expiration date of the customer's credit card, and must be in the range 1 - 12.

This property is not available at design time.

Data Type

Integer

CardExpYear Property (RecurringBilling Class)

Expiration year of the credit card specified in Number .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardExpYear();
int SetCardExpYear(int iCardExpYear);

Unicode (Windows)
INT GetCardExpYear();
INT SetCardExpYear(INT iCardExpYear);

int inpay_recurringbilling_getcardexpyear(void* lpObj);
int inpay_recurringbilling_setcardexpyear(void* lpObj, int iCardExpYear);

int GetCardExpYear();
int SetCardExpYear(int iCardExpYear);

Default Value

2000

Remarks

Expiration year of the credit card specified in CardNumber.

This property contains the expiration date of the customer's credit card. This property must be in the range 0 - 99, or 2000 - 2099. Any date before the year 2000 or after 2099 cannot be specified.

This property is not available at design time.

Data Type

Integer

CardIsEncrypted Property (RecurringBilling Class)

Determines whether data set to the Number or MagneticStripe properties is validated.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetCardIsEncrypted();
int SetCardIsEncrypted(int bCardIsEncrypted);

Unicode (Windows)
BOOL GetCardIsEncrypted();
INT SetCardIsEncrypted(BOOL bCardIsEncrypted);

int inpay_recurringbilling_getcardisencrypted(void* lpObj);
int inpay_recurringbilling_setcardisencrypted(void* lpObj, int bCardIsEncrypted);

bool GetCardIsEncrypted();
int SetCardIsEncrypted(bool bCardIsEncrypted);

Default Value

FALSE

Remarks

Determines whether data set to the CardNumber or CardMagneticStripe fields is validated.

By default, when the CardNumber or CardMagneticStripe fields are set, the value will be validated and normalized. For instance, "4444-33332222 1111" will be normalized as "4444333322221111" and CardMagneticStripe data will be parsed for the track specified by CardEntryDataSource. However, any other non-numerical data entered will cause an exception to be thrown. It may be useful in some gateways to send other data in the CardNumber or CardMagneticStripe fields, and this can be accomplished by setting IsEncrypted to true. However, please note that in doing so automatic calculation of the CardType may be affected, and the card number will not be verified.

This property is not available at design time.

Data Type

Boolean

CardMagneticStripe Property (RecurringBilling Class)

Track data read off of the card's magnetic stripe.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCardMagneticStripe();
int SetCardMagneticStripe(const char* lpszCardMagneticStripe);

Unicode (Windows)
LPWSTR GetCardMagneticStripe();
INT SetCardMagneticStripe(LPCWSTR lpszCardMagneticStripe);

char* inpay_recurringbilling_getcardmagneticstripe(void* lpObj);
int inpay_recurringbilling_setcardmagneticstripe(void* lpObj, const char* lpszCardMagneticStripe);

QString GetCardMagneticStripe();
int SetCardMagneticStripe(QString qsCardMagneticStripe);

Default Value

""

Remarks

Track data read off of the card's magnetic stripe.

If CardEntryDataSource is not one of the manually entered enumerations, then this property must be set with the track1 or track2 data from the magnetic stripe on the back of the customer's credit card. This includes everything after but not including the start sentinel (% or ;) and up to but not including the end sentinel (?) and LRC check character. You may only set this property with track 1 or track 2 data, and may not pass both. Use the CardEntryDataSource property to indicate which track you are sending.

The following example shows how to set the CardMagneticStripe and CardEntryDataSource properties if the data read off the card is "%B4788250000028291^TSYS^05121015432112345678?;4788250000028291=05121015432112345678?"

class.CardMagneticStripe = "B4788250000028291^TSYS^05121015432112345678" class.CardEntryDataSource = edsTrack1 or class.CardMagneticStripe = "4788250000028291=05121015432112345678" class.CardEntryDataSource = edsTrack2

Industry regulations do not allow merchants or processors to store track data in any form of persistent storage. Failure to abide by this regulation can result in significant fines and other penalties.

This property is not available at design time.

Data Type

String

CardNumber Property (RecurringBilling Class)

Customer's credit card number for the transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCardNumber();
int SetCardNumber(const char* lpszCardNumber);

Unicode (Windows)
LPWSTR GetCardNumber();
INT SetCardNumber(LPCWSTR lpszCardNumber);

char* inpay_recurringbilling_getcardnumber(void* lpObj);
int inpay_recurringbilling_setcardnumber(void* lpObj, const char* lpszCardNumber);

QString GetCardNumber();
int SetCardNumber(QString qsCardNumber);

Default Value

""

Remarks

Customer's credit card number for the transaction.

If you're sending the transaction with CardMagneticStripe data, this property should be left empty.

This property is not available at design time.

Data Type

String

CustomerAddress Property (RecurringBilling Class)

Customer's street address.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerAddress();
int SetCustomerAddress(const char* lpszCustomerAddress);

Unicode (Windows)
LPWSTR GetCustomerAddress();
INT SetCustomerAddress(LPCWSTR lpszCustomerAddress);

char* inpay_recurringbilling_getcustomeraddress(void* lpObj);
int inpay_recurringbilling_setcustomeraddress(void* lpObj, const char* lpszCustomerAddress);

QString GetCustomerAddress();
int SetCustomerAddress(QString qsCustomerAddress);

Default Value

""

Remarks

Customer's street address. This property is used as part of the Address Verification Service (AVS) and contains the customer's street address as it appears on their monthly statement. Only the street number, street name, and apartment number are required in This property. City, state, and zip code are set in the CustomerCity, CustomerState, and CustomerZip properties.

The length of this property varies by gateway. If the customer's address is very long, it is admissible to include only the street number in This property.

NOTE: For the Moneris gateway, this property should contain only the customer's street number. The street name should be added via the AddSpecialField method. For example:

class.CustomerAddress = "123" class.AddSpecialField("avs_street_name", "Nowhere Ln")

This property is not available at design time.

Data Type

String

CustomerAddress2 Property (RecurringBilling Class)

A specific detail on the customer's shipping address (such as building, suite, apartment, floor number etc.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerAddress2();
int SetCustomerAddress2(const char* lpszCustomerAddress2);

Unicode (Windows)
LPWSTR GetCustomerAddress2();
INT SetCustomerAddress2(LPCWSTR lpszCustomerAddress2);

char* inpay_recurringbilling_getcustomeraddress2(void* lpObj);
int inpay_recurringbilling_setcustomeraddress2(void* lpObj, const char* lpszCustomerAddress2);

QString GetCustomerAddress2();
int SetCustomerAddress2(QString qsCustomerAddress2);

Default Value

""

Remarks

A specific detail on the customer's shipping address (such as building, suite, apartment, floor number etc.).

This property is not available at design time.

Data Type

String

CustomerAggregate Property (RecurringBilling Class)

This property allows you to get or set an XML aggregate built from all of the Customer properties.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerAggregate();
int SetCustomerAggregate(const char* lpszCustomerAggregate);

Unicode (Windows)
LPWSTR GetCustomerAggregate();
INT SetCustomerAggregate(LPCWSTR lpszCustomerAggregate);

char* inpay_recurringbilling_getcustomeraggregate(void* lpObj);
int inpay_recurringbilling_setcustomeraggregate(void* lpObj, const char* lpszCustomerAggregate);

QString GetCustomerAggregate();
int SetCustomerAggregate(QString qsCustomerAggregate);

Default Value

""

Remarks

This property allows you to get or set an XML aggregate built from all of the Customer properties. "EPCustomer" is the root element. The Customer properties make up the tags under the root, but without the beginning "Customer". For instance: <EPCustomer> <Address>123 Nowhere Ln.</Address> <Address2>Apt 3B.</Address2> <City>Beverly Hills</City> ... </EPCustomer>

This property is not available at design time.

Data Type

String

CustomerCity Property (RecurringBilling Class)

Customer's city.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerCity();
int SetCustomerCity(const char* lpszCustomerCity);

Unicode (Windows)
LPWSTR GetCustomerCity();
INT SetCustomerCity(LPCWSTR lpszCustomerCity);

char* inpay_recurringbilling_getcustomercity(void* lpObj);
int inpay_recurringbilling_setcustomercity(void* lpObj, const char* lpszCustomerCity);

QString GetCustomerCity();
int SetCustomerCity(QString qsCustomerCity);

Default Value

""

Remarks

Customer's city. This property is used as part of the Address Verification Service (AVS) and contains the customer's city as it appears on their monthly statement. Other AVS properties include CustomerAddress, CustomerState, and CustomerZip.

This property is not available at design time.

Data Type

String

CustomerCountry Property (RecurringBilling Class)

Customer's country.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerCountry();
int SetCustomerCountry(const char* lpszCustomerCountry);

Unicode (Windows)
LPWSTR GetCustomerCountry();
INT SetCustomerCountry(LPCWSTR lpszCustomerCountry);

char* inpay_recurringbilling_getcustomercountry(void* lpObj);
int inpay_recurringbilling_setcustomercountry(void* lpObj, const char* lpszCustomerCountry);

QString GetCustomerCountry();
int SetCustomerCountry(QString qsCustomerCountry);

Default Value

""

Remarks

Customer's country. This property contains the country in which the customer is located. Most gateways use a two-letter country code, specified in ISO-3166.

Note: If using this property with the PayFuse gateway, this property should contain the ISO-3166 numeric code instead of the standard two-letter code. For example, the ISO code for the US is "840".

This property is not available at design time.

Data Type

String

CustomerEmail Property (RecurringBilling Class)

Customer's email address.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerEmail();
int SetCustomerEmail(const char* lpszCustomerEmail);

Unicode (Windows)
LPWSTR GetCustomerEmail();
INT SetCustomerEmail(LPCWSTR lpszCustomerEmail);

char* inpay_recurringbilling_getcustomeremail(void* lpObj);
int inpay_recurringbilling_setcustomeremail(void* lpObj, const char* lpszCustomerEmail);

QString GetCustomerEmail();
int SetCustomerEmail(QString qsCustomerEmail);

Default Value

""

Remarks

Customer's email address. This optional property contains the customer's email address.

This property is not available at design time.

Data Type

String

CustomerFax Property (RecurringBilling Class)

Customer's fax number.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerFax();
int SetCustomerFax(const char* lpszCustomerFax);

Unicode (Windows)
LPWSTR GetCustomerFax();
INT SetCustomerFax(LPCWSTR lpszCustomerFax);

char* inpay_recurringbilling_getcustomerfax(void* lpObj);
int inpay_recurringbilling_setcustomerfax(void* lpObj, const char* lpszCustomerFax);

QString GetCustomerFax();
int SetCustomerFax(QString qsCustomerFax);

Default Value

""

Remarks

Customer's fax number. This optional property contains the customer's fax number.

This property is not available at design time.

Data Type

String

CustomerFirstName Property (RecurringBilling Class)

Customer's first name.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerFirstName();
int SetCustomerFirstName(const char* lpszCustomerFirstName);

Unicode (Windows)
LPWSTR GetCustomerFirstName();
INT SetCustomerFirstName(LPCWSTR lpszCustomerFirstName);

char* inpay_recurringbilling_getcustomerfirstname(void* lpObj);
int inpay_recurringbilling_setcustomerfirstname(void* lpObj, const char* lpszCustomerFirstName);

QString GetCustomerFirstName();
int SetCustomerFirstName(QString qsCustomerFirstName);

Default Value

""

Remarks

Customer's first name. This property contains the customer's first name.

This property is not available at design time.

Data Type

String

CustomerFullName Property (RecurringBilling Class)

Customer's full name.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerFullName();
int SetCustomerFullName(const char* lpszCustomerFullName);

Unicode (Windows)
LPWSTR GetCustomerFullName();
INT SetCustomerFullName(LPCWSTR lpszCustomerFullName);

char* inpay_recurringbilling_getcustomerfullname(void* lpObj);
int inpay_recurringbilling_setcustomerfullname(void* lpObj, const char* lpszCustomerFullName);

QString GetCustomerFullName();
int SetCustomerFullName(QString qsCustomerFullName);

Default Value

""

Remarks

Customer's full name. This property contains the customer's full name as it appears on the credit card or bank account. Many gateways use this property in addition to, or instead of, the CustomerFirstName and CustomerLastName properties. If a gateway requires a CustomerFullName and the property is empty, CustomerFullName will be constructed using the contents of CustomerFirstName and CustomerLastName.

This property is not available at design time.

Data Type

String

CustomerId Property (RecurringBilling Class)

Merchant-generated customer Id.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerId();
int SetCustomerId(const char* lpszCustomerId);

Unicode (Windows)
LPWSTR GetCustomerId();
INT SetCustomerId(LPCWSTR lpszCustomerId);

char* inpay_recurringbilling_getcustomerid(void* lpObj);
int inpay_recurringbilling_setcustomerid(void* lpObj, const char* lpszCustomerId);

QString GetCustomerId();
int SetCustomerId(QString qsCustomerId);

Default Value

""

Remarks

Merchant-generated customer Id. This property contains a merchant-generated customer identification number. This number should be unique for each different customer that places an order with the merchant.

This property is not available at design time.

Data Type

String

CustomerLastName Property (RecurringBilling Class)

Customer's last name.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerLastName();
int SetCustomerLastName(const char* lpszCustomerLastName);

Unicode (Windows)
LPWSTR GetCustomerLastName();
INT SetCustomerLastName(LPCWSTR lpszCustomerLastName);

char* inpay_recurringbilling_getcustomerlastname(void* lpObj);
int inpay_recurringbilling_setcustomerlastname(void* lpObj, const char* lpszCustomerLastName);

QString GetCustomerLastName();
int SetCustomerLastName(QString qsCustomerLastName);

Default Value

""

Remarks

Customer's last name. This property contains the customer's last name as it appears on their credit card.

This property is not available at design time.

Data Type

String

CustomerPhone Property (RecurringBilling Class)

Customer's phone number.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerPhone();
int SetCustomerPhone(const char* lpszCustomerPhone);

Unicode (Windows)
LPWSTR GetCustomerPhone();
INT SetCustomerPhone(LPCWSTR lpszCustomerPhone);

char* inpay_recurringbilling_getcustomerphone(void* lpObj);
int inpay_recurringbilling_setcustomerphone(void* lpObj, const char* lpszCustomerPhone);

QString GetCustomerPhone();
int SetCustomerPhone(QString qsCustomerPhone);

Default Value

""

Remarks

Customer's phone number. This optional property contains the customer's phone number.

This property is not available at design time.

Data Type

String

CustomerState Property (RecurringBilling Class)

Customer's state.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerState();
int SetCustomerState(const char* lpszCustomerState);

Unicode (Windows)
LPWSTR GetCustomerState();
INT SetCustomerState(LPCWSTR lpszCustomerState);

char* inpay_recurringbilling_getcustomerstate(void* lpObj);
int inpay_recurringbilling_setcustomerstate(void* lpObj, const char* lpszCustomerState);

QString GetCustomerState();
int SetCustomerState(QString qsCustomerState);

Default Value

""

Remarks

Customer's state. This property is used as part of the Address Verification Service (AVS) and contains the two character postal abbreviation of the customer's state as it appears on their monthly statement. Other AVS properties include CustomerAddress, CustomerCity, and CustomerZip.

This property is not available at design time.

Data Type

String

CustomerZip Property (RecurringBilling Class)

Customer's zip code (or postal code if outside of the USA).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetCustomerZip();
int SetCustomerZip(const char* lpszCustomerZip);

Unicode (Windows)
LPWSTR GetCustomerZip();
INT SetCustomerZip(LPCWSTR lpszCustomerZip);

char* inpay_recurringbilling_getcustomerzip(void* lpObj);
int inpay_recurringbilling_setcustomerzip(void* lpObj, const char* lpszCustomerZip);

QString GetCustomerZip();
int SetCustomerZip(QString qsCustomerZip);

Default Value

""

Remarks

Customer's zip code (or postal code if outside of the USA). This property is used as part of the Address Verification Service (AVS), and contains the customer's zip code as it appears on their monthly statement. Other AVS properties include CustomerAddress, CustomerCity, and CustomerState.

This property is not available at design time.

Data Type

String

BankAccountClass Property (RecurringBilling Class)

Indicates whether a personal or business account is used for this transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetBankAccountClass();
int SetBankAccountClass(int iBankAccountClass);

Unicode (Windows)
INT GetBankAccountClass();
INT SetBankAccountClass(INT iBankAccountClass);

AC_PERSONAL(0), 
AC_BUSINESS(1)

int inpay_recurringbilling_getbankaccountclass(void* lpObj);
int inpay_recurringbilling_setbankaccountclass(void* lpObj, int iBankAccountClass);

int GetBankAccountClass();
int SetBankAccountClass(int iBankAccountClass);

Default Value

0

Remarks

Indicates whether a personal or business account is used for this transaction.

Available values:

This property is not available at design time.

Data Type

Integer

BankAccountHolderName Property (RecurringBilling Class)

Account holder's name.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetBankAccountHolderName();
int SetBankAccountHolderName(const char* lpszBankAccountHolderName);

Unicode (Windows)
LPWSTR GetBankAccountHolderName();
INT SetBankAccountHolderName(LPCWSTR lpszBankAccountHolderName);

char* inpay_recurringbilling_getbankaccountholdername(void* lpObj);
int inpay_recurringbilling_setbankaccountholdername(void* lpObj, const char* lpszBankAccountHolderName);

QString GetBankAccountHolderName();
int SetBankAccountHolderName(QString qsBankAccountHolderName);

Default Value

""

Remarks

Account holder's name. This property contains the customer's name as it appears on their account. Many gateways use this property in addition to, or instead of, the Customer Firsts and Last name properties. Note that if this property is not specified, the FullName property from the EPCustomer type will be used instead.

This property is not available at design time.

Data Type

String

BankAccountNumber Property (RecurringBilling Class)

Bank account number for ACH transactions.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetBankAccountNumber();
int SetBankAccountNumber(const char* lpszBankAccountNumber);

Unicode (Windows)
LPWSTR GetBankAccountNumber();
INT SetBankAccountNumber(LPCWSTR lpszBankAccountNumber);

char* inpay_recurringbilling_getbankaccountnumber(void* lpObj);
int inpay_recurringbilling_setbankaccountnumber(void* lpObj, const char* lpszBankAccountNumber);

QString GetBankAccountNumber();
int SetBankAccountNumber(QString qsBankAccountNumber);

Default Value

""

Remarks

Bank account number for ACH transactions. This property contains the customer's bank account number, which along with the BankRoutingNumber identify the location of the account where funds are to be drawn from for ACH transactions. This property is required for all ACH transactions.

This property is not available at design time.

Data Type

String

BankAccountType Property (RecurringBilling Class)

Indicates whether a checking or savings account is used for this transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetBankAccountType();
int SetBankAccountType(int iBankAccountType);

Unicode (Windows)
INT GetBankAccountType();
INT SetBankAccountType(INT iBankAccountType);

AT_CHECKING(0), 
AT_SAVINGS(1)

int inpay_recurringbilling_getbankaccounttype(void* lpObj);
int inpay_recurringbilling_setbankaccounttype(void* lpObj, int iBankAccountType);

int GetBankAccountType();
int SetBankAccountType(int iBankAccountType);

Default Value

0

Remarks

Indicates whether a checking or savings account is used for this transaction. For gateways that support it, this property allows funds to be withdrawn (or added in the case of a Credit) from either the customer's Checking or Savings account.

Available values:

This property is not available at design time.

Data Type

Integer

BankName Property (RecurringBilling Class)

Name of the account holder's bank.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetBankName();
int SetBankName(const char* lpszBankName);

Unicode (Windows)
LPWSTR GetBankName();
INT SetBankName(LPCWSTR lpszBankName);

char* inpay_recurringbilling_getbankname(void* lpObj);
int inpay_recurringbilling_setbankname(void* lpObj, const char* lpszBankName);

QString GetBankName();
int SetBankName(QString qsBankName);

Default Value

""

Remarks

Name of the account holder's bank. For example, Citibank, Wells-Fargo, Wachovia, etc. This property contains the name of the bank associated with the BankRoutingNumber.

This property is not available at design time.

Data Type

String

BankRoutingNumber Property (RecurringBilling Class)

Routing number for ACH transactions.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetBankRoutingNumber();
int SetBankRoutingNumber(const char* lpszBankRoutingNumber);

Unicode (Windows)
LPWSTR GetBankRoutingNumber();
INT SetBankRoutingNumber(LPCWSTR lpszBankRoutingNumber);

char* inpay_recurringbilling_getbankroutingnumber(void* lpObj);
int inpay_recurringbilling_setbankroutingnumber(void* lpObj, const char* lpszBankRoutingNumber);

QString GetBankRoutingNumber();
int SetBankRoutingNumber(QString qsBankRoutingNumber);

Default Value

""

Remarks

Routing number for ACH transactions. This property contains the routing number to the customer's bank (Also known as an ABA code). This number indicates at which bank the BankAccountNumber is located, and is used to identify the location of the account where funds are to be drawn from for ACH transactions. This property is required for all ACH transactions.

Note: When using ACHPayments gateway, a leading zero must be added for Canadian bank accounts.

This property is not available at design time.

Data Type

String

ECheckPaymentType Property (RecurringBilling Class)

The type of check payment request (commonly referred to as SEC Code).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetECheckPaymentType();
int SetECheckPaymentType(int iECheckPaymentType);

Unicode (Windows)
INT GetECheckPaymentType();
INT SetECheckPaymentType(INT iECheckPaymentType);

PT_WEB(0), 
PT_PPD(1), 
PT_TEL(2), 
PT_CCD(3), 
PT_ARC(4), 
PT_BOC(5), 
PT_POP(6), 
PT_RCK(7)

int inpay_recurringbilling_getecheckpaymenttype(void* lpObj);
int inpay_recurringbilling_setecheckpaymenttype(void* lpObj, int iECheckPaymentType);

int GetECheckPaymentType();
int SetECheckPaymentType(int iECheckPaymentType);

Default Value

0

Remarks

This property is used to specify the payment type of the check transaction.

Available values:

Data Type

Integer

Gateway Property (RecurringBilling Class)

Gateway to process transactions with.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetGateway();
int SetGateway(int iGateway);

Unicode (Windows)
INT GetGateway();
INT SetGateway(INT iGateway);

RBGW_NO_GATEWAY(0), 
RBGW_AUTHORIZE_NET(1), 
RBGW_EPROCESSING(2), 
RBGW_ITRANSACT(4), 
RBGW_PAY_FLOW_PRO(6), 
RBGW_USAE_PAY(7), 
RBGW_PLUG_NPAY(8), 
RBGW_PLANET_PAYMENT(9), 
RBGW_MERCHANT_ANYWHERE(15), 
RBGW_SKIPJACK(16), 
RBGW_ORBITAL(23), 
RBGW_LINK_POINT(24), 
RBGW_MONERIS(25), 
RBGW_NETWORK_MERCHANTS(28), 
RBGW_PRIGATE(30), 
RBGW_MERCHANT_PARTNERS(31), 
RBGW_FIRST_DATA(33), 
RBGW_YOUR_PAY(34), 
RBGW_ACHPAYMENTS(35), 
RBGW_FORTE(36), 
RBGW_CYBER_SOURCE(37), 
RBGW_EWAY(38), 
RBGW_CHASE(41), 
RBGW_NEX_COMMERCE(42), 
RBGW_TRANSACTION_CENTRAL(44), 
RBGW_MY_VIRTUAL_MERCHANT(49), 
RBGW_MONERIS_USA(52), 
RBGW_BAMBORA(53), 
RBGW_VERIFI(54), 
RBGW_QBMS(61), 
RBGW_LITLE(63), 
RBGW_PAY_TRACE(70), 
RBGW_OMNI_FUND(73), 
RBGW_TRANS_NATIONAL_BANKCARD(74), 
RBGW_PAYSCAPE(83), 
RBGW_AUTHORIZE_NET_CIM(85), 
RBGW_WORLD_PAY_LINK(87), 
RBGW_PAYMENT_WORK_SUITE(88), 
RBGW_FIRST_DATA_PAY_POINT(90), 
RBGW_CONVERGE(93), 
RBGW_AUTHORIZE_NET_XML(96), 
RBGW_PHOENI_XGATE(97), 
RBGW_REPAY(98), 
RBGW_PAY_WISER(100), 
RBGW_BLUE_SNAP(104), 
RBGW_BASYS(106), 
RBGW_SQUARE(108), 
RBGW_NUVEI(110)

int inpay_recurringbilling_getgateway(void* lpObj);
int inpay_recurringbilling_setgateway(void* lpObj, int iGateway);

int GetGateway();
int SetGateway(int iGateway);

Default Value

0

Remarks

This property is used to select the gateway with which transactions will be processed. Setting the Gateway property will also fill the GatewayURL, SpecialFieldName, and SpecialFieldValue properties with default data for the selected gateway. The following table shows the currently supported gateways, as well as the corporate home page for each.

Data Type

Integer

GatewayURL Property (RecurringBilling Class)

Default URL for a specific Gateway .

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetGatewayURL();
int SetGatewayURL(const char* lpszGatewayURL);

Unicode (Windows)
LPWSTR GetGatewayURL();
INT SetGatewayURL(LPCWSTR lpszGatewayURL);

char* inpay_recurringbilling_getgatewayurl(void* lpObj);
int inpay_recurringbilling_setgatewayurl(void* lpObj, const char* lpszGatewayURL);

QString GetGatewayURL();
int SetGatewayURL(QString qsGatewayURL);

Default Value

""

Remarks

This property is used to change the default URL for a specific Gateway. This is useful for specifying a different URL for testing purposes, or to support additional gateway processors that share a protocol format (such as additional Authorize.net compatible gateways). Please note that the proper "http://" or "https://" formatting must be observed. See "Testing Information" in the Table of Contents for a list of test URLs.

Data Type

String

InvoiceNumber Property (RecurringBilling Class)

Merchant-generated invoice number.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetInvoiceNumber();
int SetInvoiceNumber(const char* lpszInvoiceNumber);

Unicode (Windows)
LPWSTR GetInvoiceNumber();
INT SetInvoiceNumber(LPCWSTR lpszInvoiceNumber);

char* inpay_recurringbilling_getinvoicenumber(void* lpObj);
int inpay_recurringbilling_setinvoicenumber(void* lpObj, const char* lpszInvoiceNumber);

QString GetInvoiceNumber();
int SetInvoiceNumber(QString qsInvoiceNumber);

Default Value

""

Remarks

This field contains a merchant-generated invoice number. This number should be unique for each transaction. This property is optional for most gateways, but it is recommended that the merchant use an invoice number to keep track of transactions. See the Gateway property to determine if this is a required or optional field for the gateway you are using.

Data Type

String

MerchantLogin Property (RecurringBilling Class)

Merchant's Gateway login.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMerchantLogin();
int SetMerchantLogin(const char* lpszMerchantLogin);

Unicode (Windows)
LPWSTR GetMerchantLogin();
INT SetMerchantLogin(LPCWSTR lpszMerchantLogin);

char* inpay_recurringbilling_getmerchantlogin(void* lpObj);
int inpay_recurringbilling_setmerchantlogin(void* lpObj, const char* lpszMerchantLogin);

QString GetMerchantLogin();
int SetMerchantLogin(QString qsMerchantLogin);

Default Value

""

Remarks

This is the login Id supplied by the Gateway you signed up with to process credit card transactions.

Data Type

String

MerchantPassword Property (RecurringBilling Class)

Merchant's Gateway password.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMerchantPassword();
int SetMerchantPassword(const char* lpszMerchantPassword);

Unicode (Windows)
LPWSTR GetMerchantPassword();
INT SetMerchantPassword(LPCWSTR lpszMerchantPassword);

char* inpay_recurringbilling_getmerchantpassword(void* lpObj);
int inpay_recurringbilling_setmerchantpassword(void* lpObj, const char* lpszMerchantPassword);

QString GetMerchantPassword();
int SetMerchantPassword(QString qsMerchantPassword);

Default Value

""

Remarks

This is the password supplied by the Gateway you signed up with to process credit card transactions. Some gateways require passwords only for Credit or Void transactions, some require it for all transactions, and some do not require this field at all.

Data Type

String

PaymentScheduleEndDate Property (RecurringBilling Class)

The end date of the subscription.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPaymentScheduleEndDate();
int SetPaymentScheduleEndDate(const char* lpszPaymentScheduleEndDate);

Unicode (Windows)
LPWSTR GetPaymentScheduleEndDate();
INT SetPaymentScheduleEndDate(LPCWSTR lpszPaymentScheduleEndDate);

char* inpay_recurringbilling_getpaymentscheduleenddate(void* lpObj);
int inpay_recurringbilling_setpaymentscheduleenddate(void* lpObj, const char* lpszPaymentScheduleEndDate);

QString GetPaymentScheduleEndDate();
int SetPaymentScheduleEndDate(QString qsPaymentScheduleEndDate);

Default Value

""

Remarks

The end date of the subscription.

The default format is "MM/dd/yyyy" and is controlled by DateFormat, or GetSubscriptionStatus.

This property is not available at design time.

Data Type

String

PaymentScheduleFrequency Property (RecurringBilling Class)

The frequency of payments.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPaymentScheduleFrequency();
int SetPaymentScheduleFrequency(const char* lpszPaymentScheduleFrequency);

Unicode (Windows)
LPWSTR GetPaymentScheduleFrequency();
INT SetPaymentScheduleFrequency(LPCWSTR lpszPaymentScheduleFrequency);

char* inpay_recurringbilling_getpaymentschedulefrequency(void* lpObj);
int inpay_recurringbilling_setpaymentschedulefrequency(void* lpObj, const char* lpszPaymentScheduleFrequency);

QString GetPaymentScheduleFrequency();
int SetPaymentScheduleFrequency(QString qsPaymentScheduleFrequency);

Default Value

""

Remarks

The frequency of payments.

Possible values are:

• "None"
• "Daily"
• "Weekly"
• "BiWeekly"
• "FourWeeks"
• "SemiMonthly"
• "Monthly"
• "BiMonthly"
• "Quarterly"
• "SemiAnnually"
• "Annually"

Gateway specific values not covered by the above values may also be set. Please refer to RecurringBilling Gateway Setup and Required Properties for more information pertaining to gateway specific values.

If PaymentScheduleFrequencyUnit is applicable to the gateway, this property specifies the length of time between charges. This is used in combination with PaymentScheduleFrequencyUnit to specify the frequency of the billing. For instance if PaymentScheduleFrequencyUnit is set to "Days" and PaymentScheduleFrequency is set to "5", payments will occur every 5 days.

This property is not available at design time.

Data Type

String

PaymentScheduleFrequencyUnit Property (RecurringBilling Class)

The unit of time to be used when calculating the frequency of payments.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPaymentScheduleFrequencyUnit();
int SetPaymentScheduleFrequencyUnit(const char* lpszPaymentScheduleFrequencyUnit);

Unicode (Windows)
LPWSTR GetPaymentScheduleFrequencyUnit();
INT SetPaymentScheduleFrequencyUnit(LPCWSTR lpszPaymentScheduleFrequencyUnit);

char* inpay_recurringbilling_getpaymentschedulefrequencyunit(void* lpObj);
int inpay_recurringbilling_setpaymentschedulefrequencyunit(void* lpObj, const char* lpszPaymentScheduleFrequencyUnit);

QString GetPaymentScheduleFrequencyUnit();
int SetPaymentScheduleFrequencyUnit(QString qsPaymentScheduleFrequencyUnit);

Default Value

""

Remarks

The unit of time to be used when calculating the frequency of payments.

Possible values are:

• "D" or "Days"
• "M" or "Months"
• "Y" or "Years"

This property is not available at design time.

Data Type

String

PaymentScheduleInitialAmount Property (RecurringBilling Class)

The initial amount to be charged (such as a trial period or setup fee).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPaymentScheduleInitialAmount();
int SetPaymentScheduleInitialAmount(const char* lpszPaymentScheduleInitialAmount);

Unicode (Windows)
LPWSTR GetPaymentScheduleInitialAmount();
INT SetPaymentScheduleInitialAmount(LPCWSTR lpszPaymentScheduleInitialAmount);

char* inpay_recurringbilling_getpaymentscheduleinitialamount(void* lpObj);
int inpay_recurringbilling_setpaymentscheduleinitialamount(void* lpObj, const char* lpszPaymentScheduleInitialAmount);

QString GetPaymentScheduleInitialAmount();
int SetPaymentScheduleInitialAmount(QString qsPaymentScheduleInitialAmount);

Default Value

""

Remarks

The initial amount to be charged (such as a trial period or setup fee). This amount can vary from PaymentScheduleRecurAmount.

This property is not available at design time.

Data Type

String

PaymentScheduleRecurAmount Property (RecurringBilling Class)

The amount to be charged on a recurring basis.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPaymentScheduleRecurAmount();
int SetPaymentScheduleRecurAmount(const char* lpszPaymentScheduleRecurAmount);

Unicode (Windows)
LPWSTR GetPaymentScheduleRecurAmount();
INT SetPaymentScheduleRecurAmount(LPCWSTR lpszPaymentScheduleRecurAmount);

char* inpay_recurringbilling_getpaymentschedulerecuramount(void* lpObj);
int inpay_recurringbilling_setpaymentschedulerecuramount(void* lpObj, const char* lpszPaymentScheduleRecurAmount);

QString GetPaymentScheduleRecurAmount();
int SetPaymentScheduleRecurAmount(QString qsPaymentScheduleRecurAmount);

Default Value

""

Remarks

The amount to be charged on a recurring basis. This amount can vary from PaymentScheduleInitialAmount.

This property is not available at design time.

Data Type

String

PaymentScheduleStartDate Property (RecurringBilling Class)

The date on which the recurring payments will start processing.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPaymentScheduleStartDate();
int SetPaymentScheduleStartDate(const char* lpszPaymentScheduleStartDate);

Unicode (Windows)
LPWSTR GetPaymentScheduleStartDate();
INT SetPaymentScheduleStartDate(LPCWSTR lpszPaymentScheduleStartDate);

char* inpay_recurringbilling_getpaymentschedulestartdate(void* lpObj);
int inpay_recurringbilling_setpaymentschedulestartdate(void* lpObj, const char* lpszPaymentScheduleStartDate);

QString GetPaymentScheduleStartDate();
int SetPaymentScheduleStartDate(QString qsPaymentScheduleStartDate);

Default Value

""

Remarks

The date on which the recurring payments will start processing.

This property specifies the start date. The default format is "MM/dd/yyyy" and is controlled by DateFormat, or GetSubscriptionStatus.

This property is not available at design time.

Data Type

String

PaymentScheduleTotalPayments Property (RecurringBilling Class)

The total number of payments.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetPaymentScheduleTotalPayments();
int SetPaymentScheduleTotalPayments(int iPaymentScheduleTotalPayments);

Unicode (Windows)
INT GetPaymentScheduleTotalPayments();
INT SetPaymentScheduleTotalPayments(INT iPaymentScheduleTotalPayments);

int inpay_recurringbilling_getpaymentscheduletotalpayments(void* lpObj);
int inpay_recurringbilling_setpaymentscheduletotalpayments(void* lpObj, int iPaymentScheduleTotalPayments);

int GetPaymentScheduleTotalPayments();
int SetPaymentScheduleTotalPayments(int iPaymentScheduleTotalPayments);

Default Value

0

Remarks

The total number of payments. Valid values differ between gateways. See RecurringBilling Gateway Setup and Required Properties for details.

This property is not available at design time.

Data Type

Integer

PaymentScheduleTrialPayments Property (RecurringBilling Class)

The total number of trial payments.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetPaymentScheduleTrialPayments();
int SetPaymentScheduleTrialPayments(int iPaymentScheduleTrialPayments);

Unicode (Windows)
INT GetPaymentScheduleTrialPayments();
INT SetPaymentScheduleTrialPayments(INT iPaymentScheduleTrialPayments);

int inpay_recurringbilling_getpaymentscheduletrialpayments(void* lpObj);
int inpay_recurringbilling_setpaymentscheduletrialpayments(void* lpObj, int iPaymentScheduleTrialPayments);

int GetPaymentScheduleTrialPayments();
int SetPaymentScheduleTrialPayments(int iPaymentScheduleTrialPayments);

Default Value

0

Remarks

The total number of trial payments.

This property is not available at design time.

Data Type

Integer

ProxyAuthScheme Property (RecurringBilling Class)

This property is used to tell the class which type of authorization to perform when connecting to the proxy.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetProxyAuthScheme();
int SetProxyAuthScheme(int iProxyAuthScheme);

Unicode (Windows)
INT GetProxyAuthScheme();
INT SetProxyAuthScheme(INT iProxyAuthScheme);

AUTH_BASIC(0), 
AUTH_DIGEST(1), 
AUTH_PROPRIETARY(2), 
AUTH_NONE(3), 
AUTH_NTLM(4), 
AUTH_NEGOTIATE(5)

int inpay_recurringbilling_getproxyauthscheme(void* lpObj);
int inpay_recurringbilling_setproxyauthscheme(void* lpObj, int iProxyAuthScheme);

int GetProxyAuthScheme();
int SetProxyAuthScheme(int iProxyAuthScheme);

Default Value

0

Remarks

This property is used to tell the class which type of authorization to perform when connecting to the proxy. This is used only when the ProxyUser and ProxyPassword properties are set.

ProxyAuthScheme should be set to authNone (3) when no authentication is expected.

By default, ProxyAuthScheme is authBasic (0), and if the ProxyUser and ProxyPassword properties are set, the component will attempt basic authentication.

If ProxyAuthScheme is set to authDigest (1), digest authentication will be attempted instead.

If ProxyAuthScheme is set to authProprietary (2), then the authorization token will not be generated by the class. Look at the configuration file for the class being used to find more information about manually setting this token.

If ProxyAuthScheme is set to authNtlm (4), NTLM authentication will be used.

For security reasons, setting this property will clear the values of ProxyUser and ProxyPassword.

Data Type

Integer

ProxyAutoDetect Property (RecurringBilling Class)

This property tells the class whether or not to automatically detect and use proxy system settings, if available.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetProxyAutoDetect();
int SetProxyAutoDetect(int bProxyAutoDetect);

Unicode (Windows)
BOOL GetProxyAutoDetect();
INT SetProxyAutoDetect(BOOL bProxyAutoDetect);

int inpay_recurringbilling_getproxyautodetect(void* lpObj);
int inpay_recurringbilling_setproxyautodetect(void* lpObj, int bProxyAutoDetect);

bool GetProxyAutoDetect();
int SetProxyAutoDetect(bool bProxyAutoDetect);

Default Value

FALSE

Remarks

This property tells the class whether or not to automatically detect and use proxy system settings, if available. The default value is false.

Data Type

Boolean

ProxyPassword Property (RecurringBilling Class)

This property contains a password if authentication is to be used for the proxy.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetProxyPassword();
int SetProxyPassword(const char* lpszProxyPassword);

Unicode (Windows)
LPWSTR GetProxyPassword();
INT SetProxyPassword(LPCWSTR lpszProxyPassword);

char* inpay_recurringbilling_getproxypassword(void* lpObj);
int inpay_recurringbilling_setproxypassword(void* lpObj, const char* lpszProxyPassword);

QString GetProxyPassword();
int SetProxyPassword(QString qsProxyPassword);

Default Value

""

Remarks

This property contains a password if authentication is to be used for the proxy.

If ProxyAuthScheme is set to Basic Authentication, the ProxyUser and ProxyPassword are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If ProxyAuthScheme is set to Digest Authentication, the ProxyUser and ProxyPassword properties are used to respond to the Digest Authentication challenge from the server.

If ProxyAuthScheme is set to NTLM Authentication, the ProxyUser and ProxyPassword properties are used to authenticate through NTLM negotiation.

Data Type

String

ProxyPort Property (RecurringBilling Class)

This property contains the Transmission Control Protocol (TCP) port for the proxy Server (default 80).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetProxyPort();
int SetProxyPort(int iProxyPort);

Unicode (Windows)
INT GetProxyPort();
INT SetProxyPort(INT iProxyPort);

int inpay_recurringbilling_getproxyport(void* lpObj);
int inpay_recurringbilling_setproxyport(void* lpObj, int iProxyPort);

int GetProxyPort();
int SetProxyPort(int iProxyPort);

Default Value

80

Remarks

This property contains the Transmission Control Protocol (TCP) port for the proxy ProxyServer (default 80). See the description of the ProxyServer property for details.

Data Type

Integer

ProxyServer Property (RecurringBilling Class)

If a proxy Server is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetProxyServer();
int SetProxyServer(const char* lpszProxyServer);

Unicode (Windows)
LPWSTR GetProxyServer();
INT SetProxyServer(LPCWSTR lpszProxyServer);

char* inpay_recurringbilling_getproxyserver(void* lpObj);
int inpay_recurringbilling_setproxyserver(void* lpObj, const char* lpszProxyServer);

QString GetProxyServer();
int SetProxyServer(QString qsProxyServer);

Default Value

""

Remarks

If a proxy ProxyServer is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

If the ProxyServer property is set to a domain name, a DNS request is initiated. Upon successful termination of the request, the ProxyServer property is set to the corresponding address. If the search is not successful, an error is returned.

Data Type

String

ProxySSL Property (RecurringBilling Class)

This property determines when to use a Secure Sockets Layer (SSL) for the connection to the proxy.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetProxySSL();
int SetProxySSL(int iProxySSL);

Unicode (Windows)
INT GetProxySSL();
INT SetProxySSL(INT iProxySSL);

PS_AUTOMATIC(0), 
PS_ALWAYS(1), 
PS_NEVER(2), 
PS_TUNNEL(3)

int inpay_recurringbilling_getproxyssl(void* lpObj);
int inpay_recurringbilling_setproxyssl(void* lpObj, int iProxySSL);

int GetProxySSL();
int SetProxySSL(int iProxySSL);

Default Value

0

Remarks

This property determines when to use a Secure Sockets Layer (SSL) for the connection to the proxy. The applicable values are as follows:

Data Type

Integer

ProxyUser Property (RecurringBilling Class)

This property contains a user name, if authentication is to be used for the proxy.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetProxyUser();
int SetProxyUser(const char* lpszProxyUser);

Unicode (Windows)
LPWSTR GetProxyUser();
INT SetProxyUser(LPCWSTR lpszProxyUser);

char* inpay_recurringbilling_getproxyuser(void* lpObj);
int inpay_recurringbilling_setproxyuser(void* lpObj, const char* lpszProxyUser);

QString GetProxyUser();
int SetProxyUser(QString qsProxyUser);

Default Value

""

Remarks

This property contains a user name, if authentication is to be used for the proxy.

If ProxyAuthScheme is set to Basic Authentication, the ProxyUser and ProxyPassword are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If ProxyAuthScheme is set to Digest Authentication, the ProxyUser and ProxyPassword properties are used to respond to the Digest Authentication challenge from the server.

If ProxyAuthScheme is set to NTLM Authentication, the ProxyUser and ProxyPassword properties are used to authenticate through NTLM negotiation.

Data Type

String

ResponseApprovalCode Property (RecurringBilling Class)

Contains an authorization code when a transaction has been approved.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseApprovalCode();

Unicode (Windows)
LPWSTR GetResponseApprovalCode();

char* inpay_recurringbilling_getresponseapprovalcode(void* lpObj);

QString GetResponseApprovalCode();

Default Value

""

Remarks

Contains an authorization code when a transaction has been approved. This property contains an authorization code when a transaction has been approved. If the ResponseCode returned indicates that the transaction is not approved, then the contents of this property should be ignored.

This property is read-only and not available at design time.

Data Type

String

ResponseApproved Property (RecurringBilling Class)

Indicates the status of the last transaction.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetResponseApproved();

Unicode (Windows)
BOOL GetResponseApproved();

int inpay_recurringbilling_getresponseapproved(void* lpObj);

bool GetResponseApproved();

Default Value

FALSE

Remarks

Indicates the status of the last transaction. This property will be True if the last transaction was approved. However, you should not rely solely on the value contained in this property. After every transaction, the ResponseCode should be inspected and evaluated according to the specifications of the Gateway in use. A list of response codes for each gateway is listed in the table of contents. However, it is recommended that the developer acquire the current list from the Gateway which is being used.

This property is read-only and not available at design time.

Data Type

Boolean

ResponseAVSResult Property (RecurringBilling Class)

Contains the Address Verification System result code.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseAVSResult();

Unicode (Windows)
LPWSTR GetResponseAVSResult();

char* inpay_recurringbilling_getresponseavsresult(void* lpObj);

QString GetResponseAVSResult();

Default Value

""

Remarks

Contains the Address Verification System result code. This one character property contains the Address Verification Service (AVS) result code. An AVS result code can provide additional information concerning the authentication of a particular transaction for which cardholder address verification was requested. An AVS result code of "0" will be returned in the response message when no address verification has been requested. The value returned should be stored for later retrieval, as it may be required when voiding or refunding a transaction. Valid AVS response codes are listed below, and are identical across all Gateway (note that some gateways do not return an AVS response).

Note: Some gateways use their own response codes instead of those in the above table; those response codes are detailed below for such gateways.

Adyen

For Adyen, this property will contain the following possible values:

American Payment Solutions

For American Payment Solutions, this property will contain the following possible values:

Barclay

For Barclay, the property will contain the following possible values:

BlueSnap

For BlueSnap, the property will contain a 3-character string (if AVS checks were done), which contains the AVS checks for the following properties:

The possible values for each result character are:

HSBC

For HSBC, the property will contain the following possible values:

PayTrace / PayTraceJSON

For PayTrace / PayTraceJSON, the property will contain the following possible values:

QBMS

For the QBMS gateway, the ResponseAVSResult property will contain the result for the street address, a comma, and then the result for the zip code. The values returned are "Pass", "Fail", and "NotAvailable". Therefore, an ResponseAVSResult of "Fail,Pass" means that the street address failed validation, but the zip code passed.

DataCash

For DataCash, the property will contain the following possible values (of which correspond to both AVS and CVV checks):

Stripe

For Stripe, the property will contain the following possible values:

Worldpay

For Worldpay, the property will contain a 4-character string, which contains the AVS checks for the following properties:

The possible values for each result character are:

Worldpay Online

For Worldpay Online, the property will contain one of the following:

This property is read-only and not available at design time.

Data Type

String

ResponseCode Property (RecurringBilling Class)

Indicates the status of the authorization request.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseCode();

Unicode (Windows)
LPWSTR GetResponseCode();

char* inpay_recurringbilling_getresponsecode(void* lpObj);

QString GetResponseCode();

Default Value

""

Remarks

Indicates the status of the authorization request. This property contains the actual response code as returned by the Gateway. Unlike the ResponseApproved property, this ResponseCode property may provide more details about why a transaction was declined. Therefore, it is recommended that developers check the ResponseCode as well as the ResponseApproved property. The Point of Sale system should evaluate this response code and NOT the ResponseText to determine nature of a response message. The current (at the time of this release) response codes for the supported Gateways are listed in the table of contents to your left.

This property is read-only and not available at design time.

Data Type

String

ResponseCVVResult Property (RecurringBilling Class)

Contains the returned CVV2 result code if it was requested.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseCVVResult();

Unicode (Windows)
LPWSTR GetResponseCVVResult();

char* inpay_recurringbilling_getresponsecvvresult(void* lpObj);

QString GetResponseCVVResult();

Default Value

""

Remarks

Contains the returned CVV2 result code if it was requested. This property contains the host returned CVV2 result code (if CVV data was sent in the request). The following is a list of current result codes:

A gateway may also support custom codes or human-readable response messages in this property. Please consult your gateway documentation to determine if CVV2 codes are supported.

Note: Some gateways use their own response codes instead of those in the above table; those response codes are detailed below for such gateways.

HSBC

For HSBC, the property will contain:

Adyen

For Adyen, the property will contain:

Barclay

For Barclay, the property will contain:

BlueSnap

For BlueSnap, the property will contain:

(Note: There are some scenarios in which the property will be empty instead, refer to BlueSnap's documentation for more details.)

DataCash

For DataCash, the property will contain the following possible values (of which correspond to both AVS and CVV checks):

Stripe

For Stripe, the property will contain the following possible values:

Worldpay Online

For Worldpay Online, the property will contain one of the following:

This property is read-only and not available at design time.

Data Type

String

ResponseData Property (RecurringBilling Class)

The entire response returned from the gateway processor.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseData();

Unicode (Windows)
LPWSTR GetResponseData();

char* inpay_recurringbilling_getresponsedata(void* lpObj);

QString GetResponseData();

Default Value

""

Remarks

The entire response returned from the gateway processor. This property contains the entire response returned from the gateway processor. You may use this to parse additional information that is not returned in the standard response properties.

This property is read-only and not available at design time.

Data Type

String

ResponseErrorCode Property (RecurringBilling Class)

Additional error code returned by some gateways.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseErrorCode();

Unicode (Windows)
LPWSTR GetResponseErrorCode();

char* inpay_recurringbilling_getresponseerrorcode(void* lpObj);

QString GetResponseErrorCode();

Default Value

""

Remarks

Additional error code returned by some gateways. If a gateway returns it, this property will contain an additional code that may explain why the transaction was declined. You may also wish to inspect ResponseErrorText for a human-readable description of this ResponseErrorCode.

This property is read-only and not available at design time.

Data Type

String

ResponseErrorText Property (RecurringBilling Class)

Additional error description returned by some gateways.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseErrorText();

Unicode (Windows)
LPWSTR GetResponseErrorText();

char* inpay_recurringbilling_getresponseerrortext(void* lpObj);

QString GetResponseErrorText();

Default Value

""

Remarks

Additional error description returned by some gateways. If a gateway returns it, this property will contain a human-readable description of the error which occurred (if any). You may also wish to inspect ResponseErrorCode for an accompanying code which may be parsed and used by your application.

This property is read-only and not available at design time.

Data Type

String

ResponseInvoiceNumber Property (RecurringBilling Class)

Invoice number submitted in authorization request (if applicable).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseInvoiceNumber();

Unicode (Windows)
LPWSTR GetResponseInvoiceNumber();

char* inpay_recurringbilling_getresponseinvoicenumber(void* lpObj);

QString GetResponseInvoiceNumber();

Default Value

""

Remarks

Invoice number submitted in authorization request (if applicable). This property contains the Invoice Number submitted in the original transaction, echoed back by the Gateway host.

This property is read-only and not available at design time.

Data Type

String

ResponseProcessorCode Property (RecurringBilling Class)

Response code from the underlying processor.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseProcessorCode();

Unicode (Windows)
LPWSTR GetResponseProcessorCode();

char* inpay_recurringbilling_getresponseprocessorcode(void* lpObj);

QString GetResponseProcessorCode();

Default Value

""

Remarks

Response code from the underlying processor. Often times a Gateway will return a ResponseCode that indicates only whether the transaction is approved or declined. Many of these also include a secondary code that provides more details as to why the transaction was declined.

Note, for the PayFlowPro Gateway this property will contain a "1" if the transaction was a duplicate, a "-1" if duplicate checking service is unavailable, and will be blank for a successfully authorized transaction.

This property is read-only and not available at design time.

Data Type

String

ResponseSubscriptionId Property (RecurringBilling Class)

Contains the Subscription or Profile Identifier for the recurring payment.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseSubscriptionId();

Unicode (Windows)
LPWSTR GetResponseSubscriptionId();

char* inpay_recurringbilling_getresponsesubscriptionid(void* lpObj);

QString GetResponseSubscriptionId();

Default Value

""

Remarks

Contains the Subscription or Profile Identifier for the recurring payment. This property contains a subscription identifier or profile number used to reference a recurring payment. This property is used when performing subsequent actions on a recurring payment.

This property is read-only and not available at design time.

Data Type

String

ResponseText Property (RecurringBilling Class)

Text information that describes each response code.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseText();

Unicode (Windows)
LPWSTR GetResponseText();

char* inpay_recurringbilling_getresponsetext(void* lpObj);

QString GetResponseText();

Default Value

""

Remarks

Text information that describes each response code. This property contains a response or display text message. This message can be used by the terminal to display the authorization result. The display text must not be used to determine the nature of a response message. A Gateway may translate the response according to the language indicated in the merchant account setup (if applicable).

This property is read-only and not available at design time.

Data Type

String

ResponseTransactionId Property (RecurringBilling Class)

Contains the Visa Transaction Identifier or MasterCard Reference Number.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetResponseTransactionId();

Unicode (Windows)
LPWSTR GetResponseTransactionId();

char* inpay_recurringbilling_getresponsetransactionid(void* lpObj);

QString GetResponseTransactionId();

Default Value