Search: 
Available in: QUICKBOOKS | VITALPS
CCCharge Component [IBiz Vital/TSYS Integrator V4]

Properties   Methods   Events   Configuration Settings  

The CCCharge component is an advanced tool used to authorize credit card transactions in many both Direct Marketing and Retail environments. Where the CCECommerce and CCRetail components make authorizing credit cards easy, the CCCharge component gives the developer finer, more detailed control over every aspect of the transaction.

NOTE: What follows is a very short description of the component interfaces. For more information, please consult the help files that come with the respective package.

Remarks

This component allows for simple, direct, secure connection to the Vital/TSYS SSL gateway through a standard Internet connection. This component can be integrated into web pages or stand-alone Point Of Sale applications. Because all SSL communications are handled inside the component, any application or web page can be deployed without the need for expensive dedicated SSL servers.

While this component is very similar to the CCRetail and CCECommerce components, it is geared towards the advanced user who has an intimate knowledge of the Vital/TSYS message format. There are many more properties to set, and the component does no checking to make sure you are sending valid data or valid combinations of properties. To begin, first Populate the merchant properties with setup information acquired from your member bank or processor. These include properties such as MerchantBankId, MerchantName, etc.

Next, set customer properties using information gathered directly from the customer. For Direct Marketing (Card Not Present) transactions, these include CustomerAddress, CardNumber, CustomerZip, etc. For Retail (Card Present) transactions, set the CardTrack1Data or CardTrack2Data acquired from the Point Of Sale card reader.

Then set the TransactionAmount to the total for this transaction, and set the TransactionNumber.

Finally authorize the transaction with the Authorize method. The status of the authorization request will be returned in ResponseCode and the other response properties.

Once an authorization request is approved, the money in the customer's account is blocked and tagged for the merchant. This transaction must go through the Batch Settlement process in order for the blocked money to be transferred to the merchant account. This is done by passing the DetailAggregate from this component to the CCSettle component. Usually, a Batch Settlement of all authorized transactions is done at the end of each business day.

/n software suggests that as a matter of good business practices all merchants and third parties that store cardholder data should be aware of the Visa Cardholder Information Security Program (CISP) and the MasterCard Site Data Protection (SDP) program. The purpose of these programs is to help protect the integrity of cardholder information via the use of outside-vendor auditing of systems security and server site security.

Property List


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

ACI Requested Authorization Characteristics Indicator (ACI)
AccountDataSource This property contains a 1-character code identifying the source of the customer data.
CAVV AuthenticationCAVV data from the ThreeDSecure component.
CardCVVData Three digit security code on back of card (optional).
CardExpMonth Expiration month of the credit card specified in CardNumber.
CardExpYear Expiration year of the credit card specified in CardNumber.
CardNumber Customer's credit card number for this transaction.
CardTrack1Data Track 1 data for a Retail Card Present transaction
CardTrack2Data Track 2 data for a Retail Card Present transaction
CardholderId Specifies the method used to verify the identity of the cardholder.
CommercialCardType Response property that indicates whether the card is a commercial card.
CustomerAddress The customer's billing address.
CustomerZip Customer's zip code (or postal code if outside of the USA).
ECI Electronic Commerce Indicator
FirewallHost Name or IP address of firewall (optional).
FirewallPassword A password if authentication is to be used when connecting through the firewall.
FirewallPort Port of the firewall to connect to.
FirewallType Determines the type of firewall to connect through.
FirewallUser A user name if authentication is to be used connecting through a firewall.
GoodsIndicator Used to identify the type of goods purchased over the Internet.
IndustryType Code which indicates the industry the merchant is engaged in.
MerchantBankId The number which identifies the merchant's bank or processor.
MerchantCategoryCode Classifies a merchant by the type of store.
MerchantCountryCode Identifies the country where the merchant is located.
MerchantCurrencyCode Identifies the type of currency used by the merchant.
MerchantLanguage Designates the language that response messages will be returned in.
MerchantLocation Merchant's location
MerchantName Name of the merchant.
MerchantNumber A unique number used to identify the merchant within the VisaNet system.
MerchantState State or province that the merchant is located in.
MerchantStoreNumber Used to identify a specific merchant's store within the VisaNet system.
MerchantTerminalNumber Used to identify a unique terminal within a merchant location.
MerchantTimeZone Specifies the GMT offset used to calculate the local time within the VisaNet system.
MerchantZip Zip code where the merchant that initiated this transaction is located.
PrestigiousIndicator Prestigious Lodging Program indicator for the Hotel Industry Type.
RentalDuration Duration of an auto rental or hotel stay.
ResponseACI Returned Authorization Characteristics Indicator contains CPS qualification status.
ResponseAVS Contains the Address Verification System result code.
ResponseApprovalCode Contains an authorization code when a transaction has been approved.
ResponseAuthSource Indicates the source of the authorization code stored in ResponseApprovalCode.
ResponseCAVV Indicates whether the CAVV value passed validation
ResponseCVVResult Contains the returned CVV result code if it was requested.
ResponseCode Indicates the status of the authorization request.
ResponseRetrievalNumber This number is to be submitted for reversals or at settlement.
ResponseStoreNumber Check this field against the original MerchantStoreNumber.
ResponseTerminalNumber Check this field against the original MerchantTerminalNumber.
ResponseText Text information that describes each response code.
ResponseTransactionDate Local transaction date returned from the server in MMDDYY format.
ResponseTransactionId Contains the Visa Transaction Identifier or MasterCard Reference Number.
ResponseTransactionNumber Check this field against the original TransactionNumber.
ResponseTransactionTime Local transaction time returned from the server in HHMMSS format.
ResponseValidationCode This optional field contain information generated by the card issuer.
SSLAcceptServerCert Instructs the component to unconditionally accept the server certificate that matches the supplied certificate.
SSLCertEncoded The SSL certificate (PEM/base64 encoded).
SSLCertStore The name of the certificate store for the client certificate.
SSLCertStorePassword The password for the certificate store (if any).
SSLCertStoreType The type of certificate store for the client certificate.
SSLCertSubject The subject of the certificate used for client authentication.
SSLServerCert The server certificate for the last established connection.
SSLServerCertStatus The verification status of the server certificate for the last established connection.
Timeout A timeout for the component.
TransactionAmount Purchase amount to be authorized.
TransactionNumber Sequence number of this transaction.
TransactionType Specifies the type of transaction to process.
XID TransactionId from a 3D Secure authentication.

Method List


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

Authorize Sends an authorization request.
Config Sets or retrieves a component configuration setting.
GetDetailAggregate Returns an aggregate containing details of this transaction, which is then used for settlement.
Interrupt Interrupts the current action.
PreAuthorize Runs pre-authorization checks on the customer's credit card data.
Reset Clears all properties to their default values.

Event List


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

Connected Fired immediately after a connection completes (or fails).
DataPacketIn Fired when receiving a data packet from the transaction server.
DataPacketOut Fired when sending a data packet to the transaction server.
Disconnected Fired when a connection is closed.
Error Information about errors during data delivery.
SSLServerAuthentication Fired after the server presents its certificate to the client.
SSLStatus Shows the progress of the secure connection.

Configuration Settings


The following is a list of configuration settings for the component with short descriptions. Click on the links for complete descriptions.

AbsoluteTimeout Determines whether timeouts are inactivity timeouts or absolute timeouts.
CodePage The system code page used for Unicode to Multibyte translations (Windows/COM only).
DeveloperId Number that indicates the software's origin to the TSYS network.
FirewallData Used to send extra data to the firewall.
FirewallListener If true, the component binds to a SOCKS firewall as a server (IPPort only).
HTTPVersion The version of HTTP used by the component
IfModifiedSince A date determining the maximum age of the desired document.
InBufferSize The size in bytes of the incoming queue of the socket.
KeepAlive Determines whether the HTTP connection is closed after the completion of the request.
MaxLineLength The maximum amount of data to accumulate when no EOL is found.
MaxTransferredData The maximum number of incoming bytes to be stored by the component.
OpenSSLCADir The path to a directory containing CA certificates.
OpenSSLCAFile Name of the file containing the list of CA's trusted by your application.
OpenSSLCipherList A string that controls the ciphers to be used by SSL.
OpenSSLPrngSeedData The data to seed the pseudo random number generator(PRNG).
OutBufferSize The size in bytes of the outgoing queue of the socket.
Port The port to which transactions are posted.
ProxyAuthorization The authorization string to be sent to the proxy server.
ProxyPassword A password if Basic authentication is to be used for the proxy.
ProxyPort Port for the proxy server (default 80).
ProxyServer Name or IP address of a proxy server (optional).
ProxyUser A user name if Basic authentication is to be used for the proxy.
PurchaseIdentifier Optional purchase order number assigned by the merchant.
Retry Set this to retry a failed transaction.
SSLCipherStrength The minimum cipher strength used for bulk encryption.
SSLEnabledProtocols Used to enable/disable the supported security protocols.
SSLProvider The name of the security provider to use.
SSLSecurityFlags Flags that control certificate verification
Server The server to which transactions are posted.
SocketHandle The handle of the main socket used by the component.
UseWinInet If set, the WinInet API is used for retrieving the URL
UseWinInetCookies Controls whether to send and accept cookies when making http requests through WinInet
UserAgent Information about the user agent (browser).
VersionId Indicates the software's version to the Vital network.
WinsockInfo Identifying information about the loaded Winsock stack (Windows only)
WinsockLoaded Loads and unloads Winsock on demand (Windows only)
WinsockMaxDatagramSize Size in bytes of the largest UDP datagram that can be sent or received (Windows only)
WinsockMaxSockets Maximum number of sockets available to a single process (Windows only)
WinsockPath The path to the Winsock DLL used (Windows only)
WinsockStatus The status of the Winsock stack (Windows only)

| About | Privacy Policy | Terms of Use |
© Copyright 2008 /n software inc.