GlobalCardValidator Component

Properties   Methods   Events   Config Settings   Errors  

The GlobalCardValidator component is used to verify with Global Payments that a given card number is formatted properly, and could be a valid card number. Validating a card before actually submitting a transaction for authorization can reduce the fees that may be associated with invalid or declined transactions.

Syntax

TibcGlobalCardValidator

Remarks

Utilization of this component catches accidentally mistyped card numbers and allows buyers to re-input their number without having the transaction declined. It can also determine the type of credit card (Visa, MasterCard, Discover, etc) so that you can easily determine if the customer is presenting a payment type which you do not support. The component can also parse swiped track data and perform these same checks on it.

There are four checks performed by the ValidateCard method on the customer's credit card information:

• The card number is checked for validity using the Luhn mod-10 algorithm.
• The type of the card (Visa, MasterCard, etc.) is computed from the card number.
• The expiration date is checked against the current system date.
• The length of the card number is checked to see if it's a valid length for the computed card type.

In addition, the IsCommercialCard method will attempt to determine if the specified CardNumber is a commercial or purchasing card, and the GetDebitNetworkInfo method will attempt to determine if the CardNumber is a debit card. This way you can pass Level 2 data (Tax amount and purchase order number) for commercial cards, or ask for a PIN for debit cards, and receive a lower interchange rate for the transaction.

This component will query the Global Transport Server to perform the above checks. The UserId and Password is only required for the GetDebitNetworkInfo method, neither IsCommercialCard or ValidateCard require authentication to use. The first three checks made by the ValidateCard method may also be performed off-line by setting the ValidationMode configuration setting to "Local" instead of "Global". In this case, the mod-10 check will be computed mathematically by the component, and the expiration date will be checked against the current system time. The CardTypeDescription will be computed using an internal set of rules, but do note that these will not be as up-to-date as the rules the Global Payments Server uses. The length check will only be performed when ValidationMode is set to "Global" mode.

Property List

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

Method List

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

Event List

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

Config Settings

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

CardExpMonth Property (GlobalCardValidator Component)

Expiration month of the card specified in CardNumber .

Syntax

__property int CardExpMonth = { read=FCardExpMonth, write=FSetCardExpMonth };

Default Value

1

Remarks

This field contains the month portion of the expiration date of the customer's card. This property must be in the range 1 - 12. The ValidateCard method compares this property against the system time to determine if the card is expired.

Data Type

Integer

CardExpYear Property (GlobalCardValidator Component)

Expiration month of the card specified in CardNumber .

Syntax

__property int CardExpYear = { read=FCardExpYear, write=FSetCardExpYear };

Default Value

0

Remarks

This field contains the year portion of the expiration date of the customer's card. This property must be in the range 00-99, or 2000-2099. The ValidateCard method compares this property against the system time to determine if the card is expired.

Data Type

Integer

CardNumber Property (GlobalCardValidator Component)

Card number to be validated.

Syntax

__property String CardNumber = { read=FCardNumber, write=FSetCardNumber };

Default Value

""

Remarks

This property contains the customer's card number. A card number may be of any length, and may optionally include dashes or spaces. However, in practice the maximum length of the supported CardTypes is 19 characters (excluding whitespace), and the minimum length is 13 characters.

Data Type

String

CardType Property (GlobalCardValidator Component)

Indicates the results of the Luhn Digit Check algorithm.

Syntax

__property TibcGlobalCardValidatorCardTypes CardType = { read=FCardType };

enum TibcGlobalCardValidatorCardTypes {
  vctUnknown=0,
  vctVisa=1,
  vctMasterCard=2,
  vctAmex=3,
  vctDiscover=4,
  vctDiners=5,
  vctJCB=6,
  vctBankCard=7,
  vctVisaElectron=8,
  vctSolo=9,
  vctSwitch=10,
  vctMaestro=11,
  vctCUP=12,
  vctLaser=13,
  vctVisaPurchase=14,
  vctMCardPurchase=15,
  vctTempoPayments=16
};

Default Value

vctUnknown

Remarks

This property is filled after a call to the ValidateCard method. Allowable values include:

Note that this integer value is computed by the component, the actual value returned from the Global Transport Server will be contained in CardTypeDescription.

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

Data Type

Integer

CardTypeDescription Property (GlobalCardValidator Component)

Human-readable description of the CardType .

Syntax

__property String CardTypeDescription = { read=FCardTypeDescription };

Default Value

""

Remarks

This property is filled after calling the ValidateCard method, and will contain a text description of the CardType. This is useful to distinguish different program cards. For instance, a CardType of ccDiners might have a corresponding CardTypeDescription of "Diner's Club International", "Diner's Club Carte Blanche", or "Diner's Club enRoute".

Note that this property will contain the exact text returned by the Global Transport Server.

This property is read-only.

Data Type

String

DateCheckPassed Property (GlobalCardValidator Component)

Indicates whether the card is expired or not.

Syntax

__property bool DateCheckPassed = { read=FDateCheckPassed };

Default Value

false

Remarks

The ValidateCard method checks whether the card's expiration date (CardExpMonth and CardExpYear) is a valid future date, and stores that result in the DateCheckPassed property.

This property is read-only.

Data Type

Boolean

DigitCheckPassed Property (GlobalCardValidator Component)

Indicates the results of the Luhn Digit Check algorithm.

Syntax

__property bool DigitCheckPassed = { read=FDigitCheckPassed };

Default Value

false

Remarks

The ValidateCard method checks whether or not the CardNumber conforms to the mod-10 digit check algorithm, and stores that result in the DigitCheckPassed property. Note that a card may pass this check and still be an invalid card. (Either a fake number that passes the digit check, or an unknown CardType).

This property is read-only.

Data Type

Boolean

LengthCheckPassed Property (GlobalCardValidator Component)

Indicates the results of the card number length check.

Syntax

__property bool LengthCheckPassed = { read=FLengthCheckPassed };

Default Value

false

Remarks

The ValidateCard method checks whether or not the CardNumber's length is appropriate for the card's prefix, and stores that result in the LengthCheckPassed property. Note that a card may pass this check and still be an invalid card. (For instance, a fake number that passes the length check).

This property is read-only.

Data Type

Boolean

NetworkInfoAuthorizerNumber Property (GlobalCardValidator Component)

Two-digit code that identifies the debit network.

Syntax

__property String NetworkInfoAuthorizerNumber = { read=FNetworkInfoAuthorizerNumber };

Default Value

""

Remarks

Two-digit code that identifies the debit network. The NetworkInfoNetworkName NetworkInfoNetworkId and NetworkInfoAuthorizerNumber properties are used to identify the debit network to which the card belongs. The current list of available networks is shown below:

This property will be blank if the card number you're validating does not belong to a debit card.

This property is read-only.

Data Type

String

NetworkInfoCode Property (GlobalCardValidator Component)

Contains the transaction result code from the Global Transport Gateway.

Syntax

__property String NetworkInfoCode = { read=FNetworkInfoCode };

Default Value

""

Remarks

Contains the transaction result code from the Global Transport Gateway. This value signifies the result of the transaction (i.e. approved, declined, etc). When programmatically validating a transaction's result, this value should ALWAYS be used instead of any response message describing the result. See the table below for a full list of result codes and descriptions.

A Partial Authorization transaction occurs when the issuer authorizes part of the sale amount on a pre-paid credit card. The transaction is approved for an amount less than the original TransactionAmount, and the customer must tender the remaining balance with another form of payment. When a transaction is partially approved, the NetworkInfoCode will contain "200", the NetworkInfoMessage will contain "Partial Approval", and the NetworkInfoMessageDetail will contain "PARTIAL AP", "PARTIALLY APPROVED", or "PARTIALLY APPROVED AUTHONLY" (for auth-only transactions). the NetworkInfoAuthorizedAmount will contain the amount of the transaction that was authorized, and the NetworkInfoBalanceDue property will indicate the amount still owed by the customer.

If a partial authorization occurs and the customer does not wish to go through with the transaction, you must submit a reversal of the authorization in order to return funds to the prepaid card.

This property is read-only.

Data Type

String

NetworkInfoId Property (GlobalCardValidator Component)

Identification code for the debit network.

Syntax

__property String NetworkInfoId = { read=FNetworkInfoId };

Default Value

""

Remarks

Identification code for the debit network. The NetworkInfoNetworkName NetworkInfoNetworkId and NetworkInfoAuthorizerNumber properties are used to identify the debit network to which the card belongs. The current list of available networks is shown below:

This property will be blank if the card number you're validating does not belong to a debit card.

This property is read-only.

Data Type

String

NetworkInfoName Property (GlobalCardValidator Component)

Name of the debit network.

Syntax

__property String NetworkInfoName = { read=FNetworkInfoName };

Default Value

""

Remarks

Name of the debit network. The NetworkInfoNetworkName NetworkInfoNetworkId and NetworkInfoAuthorizerNumber properties are used to identify the debit network to which the card belongs. The current list of available networks is shown below:

This property will be blank if the card number you're validating does not belong to a debit card.

This property is read-only.

Data Type

String

NetworkInfoOfflineSupported Property (GlobalCardValidator Component)

Indicates whether offline transactions are supported for the debit network.

Syntax

__property bool NetworkInfoOfflineSupported = { read=FNetworkInfoOfflineSupported };

Default Value

false

Remarks

Indicates whether offline transactions are supported for the debit network.

This property is read-only.

Data Type

Boolean

Password Property (GlobalCardValidator Component)

Password for authentication with the Global Payments Server .

Syntax

__property String Password = { read=FPassword, write=FSetPassword };

Default Value

""

Remarks

The Password will be supplied to you by Global Payments.

Data Type

String

ProxyAuthScheme Property (GlobalCardValidator Component)

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

Syntax

__property TibcGlobalCardValidatorProxyAuthSchemes ProxyAuthScheme = { read=FProxyAuthScheme, write=FSetProxyAuthScheme };

enum TibcGlobalCardValidatorProxyAuthSchemes {
  authBasic=0,
  authDigest=1,
  authProprietary=2,
  authNone=3,
  authNtlm=4,
  authNegotiate=5
};

Default Value

authBasic

Remarks

This property is used to tell the component 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 component. Look at the configuration file for the component 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 (GlobalCardValidator Component)

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

Syntax

__property bool ProxyAutoDetect = { read=FProxyAutoDetect, write=FSetProxyAutoDetect };

Default Value

False

Remarks

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

Data Type

Boolean

ProxyPassword Property (GlobalCardValidator Component)

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

Syntax

__property String ProxyPassword = { read=FProxyPassword, write=FSetProxyPassword };

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 (GlobalCardValidator Component)

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

Syntax

__property int ProxyPort = { read=FProxyPort, write=FSetProxyPort };

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 (GlobalCardValidator Component)

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

Syntax

__property String ProxyServer = { read=FProxyServer, write=FSetProxyServer };

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 (GlobalCardValidator Component)

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

Syntax

__property TibcGlobalCardValidatorProxySSLs ProxySSL = { read=FProxySSL, write=FSetProxySSL };

enum TibcGlobalCardValidatorProxySSLs {
  psAutomatic=0,
  psAlways=1,
  psNever=2,
  psTunnel=3
};

Default Value

psAutomatic

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 (GlobalCardValidator Component)

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

Syntax

__property String ProxyUser = { read=FProxyUser, write=FSetProxyUser };

Default Value

""

Remarks

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

If ProxyAuthScheme is set to Basic Authentication, the ProxyUser and ProxyPassword properties 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

Server Property (GlobalCardValidator Component)

Global Payments transaction server.

Syntax

__property String Server = { read=FServer, write=FSetServer };

Default Value

"https://api.globalpay.com"

Remarks

This is the server to which all transactions are sent. The live URL for Global Payments is "https://api.globalpay.com". For testing and certification purposes you may set this to the test server located at "https://certapia.globalpay.com" instead.

Data Type

String

SSLAcceptServerCertEncoded Property (GlobalCardValidator Component)

This is the certificate (PEM/Base64 encoded).

Syntax

__property String SSLAcceptServerCertEncoded = { read=FSSLAcceptServerCertEncoded, write=FSetSSLAcceptServerCertEncoded };
__property DynamicArray<Byte> SSLAcceptServerCertEncodedB = { read=FSSLAcceptServerCertEncodedB, write=FSetSSLAcceptServerCertEncodedB };

Default Value

""

Remarks

This is the certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The SSLAcceptServerCertStore and SSLAcceptServerCertSubject properties also may be used to specify a certificate.

When SSLAcceptServerCertEncoded is set, a search is initiated in the current SSLAcceptServerCertStore for the private key of the certificate. If the key is found, SSLAcceptServerCertSubject is updated to reflect the full subject of the selected certificate; otherwise, SSLAcceptServerCertSubject is set to an empty string.

This property is not available at design time.

Data Type

Byte Array

SSLCertEncoded Property (GlobalCardValidator Component)

This is the certificate (PEM/Base64 encoded).

Syntax

__property String SSLCertEncoded = { read=FSSLCertEncoded, write=FSetSSLCertEncoded };
__property DynamicArray<Byte> SSLCertEncodedB = { read=FSSLCertEncodedB, write=FSetSSLCertEncodedB };

Default Value

""

Remarks

This is the certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The SSLCertStore and SSLCertSubject properties also may be used to specify a certificate.

When SSLCertEncoded is set, a search is initiated in the current SSLCertStore for the private key of the certificate. If the key is found, SSLCertSubject is updated to reflect the full subject of the selected certificate; otherwise, SSLCertSubject is set to an empty string.

This property is not available at design time.

Data Type

Byte Array

SSLCertStore Property (GlobalCardValidator Component)

This is the name of the certificate store for the client certificate.

Syntax

__property String SSLCertStore = { read=FSSLCertStore, write=FSetSSLCertStore };
__property DynamicArray<Byte> SSLCertStoreB = { read=FSSLCertStoreB, write=FSetSSLCertStoreB };

Default Value

"MY"

Remarks

This is the name of the certificate store for the client certificate.

The SSLCertStoreType property denotes the type of the certificate store specified by SSLCertStore. If the store is password protected, specify the password in SSLCertStorePassword.

SSLCertStore is used in conjunction with the SSLCertSubject property to specify client certificates. If SSLCertStore has a value, and SSLCertSubject or SSLCertEncoded is set, a search for a certificate is initiated. Please see the SSLCertSubject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is PFXFile, this property must be set to the name of the file. When the type is PFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Byte Array

SSLCertStorePassword Property (GlobalCardValidator Component)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

__property String SSLCertStorePassword = { read=FSSLCertStorePassword, write=FSetSSLCertStorePassword };

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

SSLCertStoreType Property (GlobalCardValidator Component)

This is the type of certificate store for this certificate.

Syntax

__property TibcGlobalCardValidatorSSLCertStoreTypes SSLCertStoreType = { read=FSSLCertStoreType, write=FSetSSLCertStoreType };

enum TibcGlobalCardValidatorSSLCertStoreTypes {
  cstUser=0,
  cstMachine=1,
  cstPFXFile=2,
  cstPFXBlob=3,
  cstJKSFile=4,
  cstJKSBlob=5,
  cstPEMKeyFile=6,
  cstPEMKeyBlob=7,
  cstPublicKeyFile=8,
  cstPublicKeyBlob=9,
  cstSSHPublicKeyBlob=10,
  cstP7BFile=11,
  cstP7BBlob=12,
  cstSSHPublicKeyFile=13,
  cstPPKFile=14,
  cstPPKBlob=15,
  cstXMLFile=16,
  cstXMLBlob=17,
  cstJWKFile=18,
  cstJWKBlob=19,
  cstSecurityKey=20,
  cstBCFKSFile=21,
  cstBCFKSBlob=22,
  cstPKCS11=23,
  cstAuto=99
};

Default Value

cstUser

Remarks

This is the type of certificate store for this certificate.

The component supports both public and private keys in a variety of formats. When the cstAuto value is used, the component will automatically determine the type. This property can take one of the following values:

Data Type

Integer

SSLCertSubject Property (GlobalCardValidator Component)

This is the subject of the certificate used for client authentication.

Syntax

__property String SSLCertSubject = { read=FSSLCertSubject, write=FSetSSLCertSubject };

Default Value

""

Remarks

This is the subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=support@nsoftware.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

SSLProvider Property (GlobalCardValidator Component)

This specifies the SSL/TLS implementation to use.

Syntax

__property TibcGlobalCardValidatorSSLProviders SSLProvider = { read=FSSLProvider, write=FSetSSLProvider };

enum TibcGlobalCardValidatorSSLProviders {
  sslpAutomatic=0,
  sslpPlatform=1,
  sslpInternal=2
};

Default Value

sslpAutomatic

Remarks

This property specifies the SSL/TLS implementation to use. In most cases the default value of 0 (Automatic) is recommended and should not be changed. When set to 0 (Automatic) the component will select whether to use the platform implementation or the internal implementation depending on the operating system as well as the TLS version being used.

Possible values are:

In most cases using the default value (Automatic) is recommended. The component will select a provider depending on the current platform.

When Automatic is selected the platform implementation is used by default. When TLS 1.3 is enabled via SSLEnabledProtocols the internal implementation is used.

Data Type

Integer

SSLServerCertEncoded Property (GlobalCardValidator Component)

This is the certificate (PEM/Base64 encoded).

Syntax

__property String SSLServerCertEncoded = { read=FSSLServerCertEncoded };
__property DynamicArray<Byte> SSLServerCertEncodedB = { read=FSSLServerCertEncodedB };

Default Value

""

Remarks

This is the certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The SSLServerCertStore and SSLServerCertSubject properties also may be used to specify a certificate.

When SSLServerCertEncoded is set, a search is initiated in the current SSLServerCertStore for the private key of the certificate. If the key is found, SSLServerCertSubject is updated to reflect the full subject of the selected certificate; otherwise, SSLServerCertSubject is set to an empty string.

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

Data Type

Byte Array

Timeout Property (GlobalCardValidator Component)

A timeout for the component.

Syntax

__property int Timeout = { read=FTimeout, write=FSetTimeout };

Default Value

60

Remarks

If the Timeout property is set to 0, all operations will run uninterrupted until successful completion or an error condition is encountered.

If Timeout is set to a positive value, the component will wait for the operation to complete before returning control.

The component will use DoEvents to enter an efficient wait loop during any potential waiting period, making sure that all system events are processed immediately as they arrive. This ensures that the host application does not "freeze" and remains responsive.

If Timeout expires, and the operation is not yet complete, the component raises an exception.

Please note that by default, all timeouts are inactivity timeouts, i.e. the timeout period is extended by Timeout seconds when any amount of data is successfully sent or received.

The default value for the Timeout property is 60 seconds.

Data Type

Integer

TrackData Property (GlobalCardValidator Component)

Magnetic stripe data read off the card.

Syntax

__property String TrackData = { read=FTrackData, write=FSetTrackData };

Default Value

""

Remarks

This property may be set with the magnetic stripe read off the back of a card using any commercially available card reader. You may set this property with either Track1 or Track2 data. If TrackData is set, the values contained in CardNumber, CardExpMonth, and CardExpYear are ignored when calling ValidateCard. Instead, these properties are parsed out of the track data. This allows you to easily retrieve the expiration date and card number from either Track1 or Track2 data. For instance:

CardValidator1.TrackData = "4012000033330026=09121015432112345678" CardValidator1.ValidateCard()

The CardNumber, CardExpMonth, and CardExpYear will now contain the values parsed from the track data. TrackType will also indicate whether the TrackData is Track1 or Track2 (in this case, it's Track2 data).

Data Type

String

TrackType Property (GlobalCardValidator Component)

Indicates the type of the specified TrackData .

Syntax

__property TibcGlobalCardValidatorTrackTypes TrackType = { read=FTrackType };

enum TibcGlobalCardValidatorTrackTypes {
  ttUnknown=0,
  ttTrack1=1,
  ttTrack2=2
};

Default Value

ttUnknown

Remarks

This property will be filled after a call to ValidateCard. If magnetic stripe data was supplied in the TrackData field, this property will indicate which type of track was entered. If no track data was entered (ie, the CardNumber was specified instead) then the TrackType will be ttUnknown.

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

Data Type

Integer

UserId Property (GlobalCardValidator Component)

UserId for authentication with the Global Payments Server .

Syntax

__property String UserId = { read=FUserId, write=FSetUserId };

Default Value

""

Remarks

The UserId will be supplied to you by Global Payments.

Data Type

String

Config Method (GlobalCardValidator Component)

Sets or retrieves a configuration setting.

Syntax

String __fastcall Config(String ConfigurationString);

Remarks

Config is a generic method available in every component. It is used to set and retrieve configuration settings for the component.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

GetDebitNetworkInfo Method (GlobalCardValidator Component)

Determines if the card is a debit card, and which network it belongs to.

Syntax

void __fastcall GetDebitNetworkInfo();

Remarks

This method retrieves the name, Id, and Authorizer number of the U.S. Debit Network, if the CardNumber matches a debit network's BIN range. The possible networks are detailed in the table below. If there is a match, the card can likely be processed through the U.S. debit network as a PIN-based debit transaction.

If the CardNumber is not a debit card or there is an error communicating with Global Payments, an error code will be stored in the NetworkInfoCode property, and a detailed error message will be contained in the NetworkInfoName property.

Interrupt Method (GlobalCardValidator Component)

Interrupt the current method.

Syntax

void __fastcall Interrupt();

Remarks

If there is no method in progress, Interrupt simply returns, doing nothing.

IsCommercialCard Method (GlobalCardValidator Component)

Indicates whether or not the CardNumber is for a commercial/purchasing card.

Syntax

bool __fastcall IsCommercialCard();

Remarks

This method queries the Global Payments servers as to whether or not the credit card number specified by CardNumber is a commercial card. The Global Payments server compares the card prefix against the latest BIN ranges to determine this. However, please note that due to the dynamic nature of card BIN ranges, not all Commercial/Purchasing cards can be determined by this method. Developers should keep this in mind when designing applications.

The CardNumber is the only property required for this method. If the CardNumber does fall within a Commercial or Purchasing card BIN range, the IsCommercialCard method will return True. If it is not - or if the transaction fails, this method will return False.

Reset Method (GlobalCardValidator Component)

Clears all properties to their default values.

Syntax

void __fastcall Reset();

Remarks

This method clears all properties to their default values.

ValidateCard Method (GlobalCardValidator Component)

Checks the card number and expiration date for validity.

Syntax

void __fastcall ValidateCard();

Remarks

This method performs several checks on customer information to determine if the card information submitted could be valid. This should be done before submitting an actual transaction for authorization. The tests performed are listed below:

This component will query the Global Transport Server to perform the above checks. The UserId and Password is only required for the GetDebitNetworkInfo method, neither IsCommercialCard or ValidateCard require authentication to use. The first three checks made by the ValidateCard method may also be performed off-line by setting the ValidationMode configuration setting to "Local" instead of "Global". In this case, the mod-10 check will be computed mathematically by the component, and the expiration date will be checked against the current system time. The CardTypeDescription will be computed using an internal set of rules, but do note that these will not be as up-to-date as the rules the Global Payments Server uses. The length check will only be performed when ValidationMode is set to "Global" mode.

Error Event (GlobalCardValidator Component)

Fired when information is available about errors during data delivery.

Syntax

typedef struct {
  int ErrorCode;
  String Description;
} TibcGlobalCardValidatorErrorEventParams;
typedef void __fastcall (__closure *TibcGlobalCardValidatorErrorEvent)(System::TObject* Sender, TibcGlobalCardValidatorErrorEventParams *e);
__property TibcGlobalCardValidatorErrorEvent OnError = { read=FOnError, write=FOnError };

Remarks

The Error event is fired in case of exceptional conditions during message processing. Normally the component raises an exception.

The ErrorCode parameter contains an error code, and the Description parameter contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Error Codes section.

SSLServerAuthentication Event (GlobalCardValidator Component)

Fired after the server presents its certificate to the client.

Syntax

typedef struct {
  String CertEncoded;
  DynamicArray<Byte> CertEncodedB;
  String CertSubject;
  String CertIssuer;
  String Status;
  bool Accept;
} TibcGlobalCardValidatorSSLServerAuthenticationEventParams;
typedef void __fastcall (__closure *TibcGlobalCardValidatorSSLServerAuthenticationEvent)(System::TObject* Sender, TibcGlobalCardValidatorSSLServerAuthenticationEventParams *e);
__property TibcGlobalCardValidatorSSLServerAuthenticationEvent OnSSLServerAuthentication = { read=FOnSSLServerAuthentication, write=FOnSSLServerAuthentication };

Remarks

During this event, the client can decide whether or not to continue with the connection process. The Accept parameter is a recommendation on whether to continue or close the connection. This is just a suggestion: application software must use its own logic to determine whether or not to continue.

When Accept is False, Status shows why the verification failed (otherwise, Status contains the string OK). If it is decided to continue, you can override and accept the certificate by setting the Accept parameter to True.

SSLStatus Event (GlobalCardValidator Component)

Fired when secure connection progress messages are available.

Syntax

typedef struct {
  String Message;
} TibcGlobalCardValidatorSSLStatusEventParams;
typedef void __fastcall (__closure *TibcGlobalCardValidatorSSLStatusEvent)(System::TObject* Sender, TibcGlobalCardValidatorSSLStatusEventParams *e);
__property TibcGlobalCardValidatorSSLStatusEvent OnSSLStatus = { read=FOnSSLStatus, write=FOnSSLStatus };

Remarks

The event is fired for informational and logging purposes only. This event tracks the progress of the connection.

Status Event (GlobalCardValidator Component)

Shows the progress of the Global Payments connection.

Syntax

typedef struct {
  String Message;
} TibcGlobalCardValidatorStatusEventParams;
typedef void __fastcall (__closure *TibcGlobalCardValidatorStatusEvent)(System::TObject* Sender, TibcGlobalCardValidatorStatusEventParams *e);
__property TibcGlobalCardValidatorStatusEvent OnStatus = { read=FOnStatus, write=FOnStatus };

Remarks

The event is fired for informational and logging purposes only. Used to track the progress of the connection.

Config Settings (GlobalCardValidator Component)

GlobalCardValidator Config Settings

TCPClient Config Settings

SSL Config Settings

-----BEGIN CERTIFICATE-----
MIIEKzCCAxOgAwIBAgIRANTET4LIkxdH6P+CFIiHvTowDQYJKoZIhvcNAQELBQAw
...
eWHV5OW1K53o/atv59sOiW5K3crjFhsBOd5Q+cJJnU+SWinPKtANXMht+EDvYY2w
F0I1XhM+pKj7FjDr+XNj
-----END CERTIFICATE-----
\r \n
-----BEGIN CERTIFICATE-----
MIIEFjCCAv6gAwIBAgIQetu1SMxpnENAnnOz1P+PtTANBgkqhkiG9w0BAQUFADBp
..
d8q23djXZbVYiIfE9ebr4g3152BlVCHZ2GyPdjhIuLeH21VbT/dyEHHA
-----END CERTIFICATE-----

-----BEGIN CERTIFICATE-----
MIIEKzCCAxOgAwIBAgIRANTET4LIkxdH6P+CFIiHvTowDQYJKoZIhvcNAQELBQAw
...
eWHV5OW1K53o/atv59sOiW5K3crjFhsBOd5Q+cJJnU+SWinPKtANXMht+EDvYY2w
F0I1XhM+pKj7FjDr+XNj
-----END CERTIFICATE-----
\r \n
-----BEGIN CERTIFICATE-----
MIIEFjCCAv6gAwIBAgIQetu1SMxpnENAnnOz1P+PtTANBgkqhkiG9w0BAQUFADBp
..
d8q23djXZbVYiIfE9ebr4g3152BlVCHZ2GyPdjhIuLeH21VbT/dyEHHA
-----END CERTIFICATE-----

Socket Config Settings

Base Config Settings

Trappable Errors (GlobalCardValidator Component)

GlobalCardValidator Errors

The component may also return one of the following error codes, which are inherited from other components.

HTTP Errors

The component may also return one of the following error codes, which are inherited from other components.

TCPClient Errors

SSL Errors

TCP/IP Errors