Search: 
Available in: PAYMENTECH
PTSettle Component [Paymentech Integrator V5]

Properties   Methods   Events   Configuration Settings  

The PTSettle component is used to manually settle an open Batch with the Paymentech NetConnect system on the Tampa platform. This component supports Direct Marketing, e-Commerce, and Retail environments, and allows for simple, direct, secure communication to the Paymentech 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.

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

Once an authorization request is approved with either the PTCHARGE or PTGIFTCARD component, one of two things happen. If your Paymentech account is setup with the Host Auto Close feature enabled, you need take no further action. The host will close the current open batch at a designated time each day. This means that there is no end of day batch processing required from the merchant. In order for the merchant's batch to be included in the Paymentech Host Auto Close process, the merchant parameter file on the host must indicate that the merchant is Auto Close. If this flag is set, the PTSettle component is not necessary.

However, if your account is not setup with Host Auto Close, then after an authorization is approved the transaction is added to the current batch on the Paymentech Server, and the money in the customer's account is blocked and tagged for the merchant. The transaction must go through the Manual Batch Release Settlement process in order for the blocked money to be transferred to the merchant's account. To release a batch for settlement, first set the MerchantNumber, TerminalNumber, ClientNumber, UserId, and Password with the information given to you when you signed up for Paymentech service. Then get the Net Amount of the batch by calling the BatchInquiry method. Compare this amount to the amount in your transaction records. If they match, you may send a BatchRelease to settle the funds.

The status of a batch inquiry or release is returned in the Response. with a human-readable description contained in Response. Additional Response properties indicate the number of transactions in the batch, the date and time the batch was opened and closed, and Net amount of the batch.

Normally a BatchRelease is done at the end of each business day. Outstanding authorizations (even those in an open batch) will expire after 7 to 10 days depending on the cardholder's bank, so it is wise to release the batch often.

Note that this component only supports the Manual Batch Release (Host Capture) settlement method, and does not support Terminal Capture processing. (This component is not required for Host Auto Close).

Property List


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

ClientNumberMerchant configuration property, assigned by Paymentech.
MerchantNumberA unique number used to identify the merchant, assigned by Paymentech.
PasswordPassword for authentication with the NetConnect Server
PaymentTypesCollection of payment types in the current batch.
ProxyA set of properties related to proxy access.
ResponseContains the response to the settlement.
SequenceNumberSequence number of the transaction.
ServerThe URL for the PaymenTech NetConnect server.
SSLAcceptServerCertInstructs the component to unconditionally accept the server certificate that matches the supplied certificate.
SSLCertThe certificate to be used during ssl negotiation.
SSLServerCertThe server certificate for the last established connection.
TerminalNumberTerminal number assigned by Paymentech.
TimeoutA timeout for the component.
UserIdUserId for authentication with the NetConnect Server .

Method List


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

BatchInquiryRetrieves the current state of the open batch.
BatchReleaseReleases the current batch for settlement.
ConfigSets or retrieves a configuration setting.
InterruptInterrupt the current method.
ResetClears 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 further details.

ErrorInformation about errors during data delivery.
SSLServerAuthenticationFired after the server presents its certificate to the client.
SSLStatusShows the progress of the secure connection.
TransferFired while a document transfers (delivers document).

Configuration Settings


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

SystemInformationSystem Information field for Batch Inquiry and Release transactions.
HTTPVersionThe version of HTTP used by the component
UserAgentInformation about the user agent (browser).
AuthorizationThe Authorization string to be sent to the server.
AllowHTTPCompressionThis property enables HTTP compression for receiving data.
TransferredDataLimitThe maximum number of incoming bytes to be stored by the component.
KeepAliveDetermines whether the HTTP connection is closed after the completion of the request.
ProxyServerName or IP address of a proxy server (optional).
ProxyPortPort for the proxy server (default 80).
ProxyUserA user name if authentication is to be used for the proxy.
ProxyPasswordA password if authentication is to be used for the proxy.
ProxyAuthorizationThe authorization string to be sent to the proxy server.
ProxyAuthSchemeThe authorization scheme to be used for the proxy.
IfModifiedSinceA date determining the maximum age of the desired document.
MaxHTTPCookiesInstructs component to save the amount of cookies specified that are returned by the server when a SetCookie event is fired.
MaxHeadersInstructs component to save the amount of headers specified that are returned by the server after a Header event has been fired.
AcceptEncodingUsed to tell the server which types of content encodings the client supports.
EncodeURLIf set to true the URL will be encoded by the component.
GetOn302RedirectIf set to true the component will perform a GET on the new location.
UseWinInetIf set, the WinInet API is used for retrieving the URL
UseWinInetCookiesControls whether to send and accept cookies when making http requests through WinInet
UseIPv6Whether or not to use IPv6.
MaxLineLengthThe maximum amount of data to accumulate when no EOL is found.
FirewallListenerIf true, the component binds to a SOCKS firewall as a server (IPPort only).
CloseStreamAfterTransferIf true, the component will close the upload or download stream after the transfer.
TcpNoDelayWhether or not to delay when sending packets
AcceptAnyServerCertIf set the component will accept any certificate presented by the server
SSLProviderThe name of the security provider to use.
SSLCipherStrengthThe minimum cipher strength used for bulk encryption.
SSLEnabledProtocolsUsed to enable/disable the supported security protocols.
SSLSecurityFlagsFlags that control certificate verification
ReuseSSLSessionDetermines if the SSL session is reused.
OpenSSLCipherListA string that controls the ciphers to be used by SSL.
OpenSSLPrngSeedDataThe data to seed the pseudo random number generator(PRNG).
OpenSSLCAFileName of the file containing the list of CA's trusted by your application.
OpenSSLCADirThe path to a directory containing CA certificates.
InBufferSizeThe size in bytes of the incoming queue of the socket.
OutBufferSizeThe size in bytes of the outgoing queue of the socket.
AbsoluteTimeoutDetermines whether timeouts are inactivity timeouts or absolute timeouts.
FirewallDataUsed to send extra data to the firewall.
CodePageThe system code page used for Unicode to Multibyte translations (Windows/COM only).

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