Direct Payment Integrator V6 - Online Help
Direct Payment Integrator V6
Questions / Feedback?

TSYSReversal Control

Properties   Methods   Events   Configuration Settings   Errors  

The TSYSReversal component is used to reverse transactions that were previously authorized using the TSYSRETAIL , TSYSECOMMERCE , or TSYSHEALTHCARE components.

Syntax

TSYSReversal

Remarks

Credit card authorizations put a hold on funds on a credit card, until the time at which the transaction is settled or the hold expires. Reversals are similar to voids, but they're online transactions. Voids are off-line. This means that a void will not release the hold on funds at the next batch settlement (usually). Authorization reversals are online transactions, meaning that the hold on funds is immediately removed, and the cardholder may use the funds on the card for other purchases.

This control works for all IndustryTypes and supports Credit, EBT, and Debit card transactions. Both partial and full reversals are supported. When a transaction has been fully reversed (SettlementAmount is "0") the original transaction must not be included in the batch settlement. However, if the transaction has been only partially reversed, the original detail record must be updated with the new settlement amount. Both SettlementAmount and AuthorizedAmount in the detail record should be set with the SettlementAmount sent in the reversal transaction. The TotalAuthorizedAmount configuration setting should contain the original authorization amount. You must also set the PartiallyAuthorized configuration setting to True. For instance:


  TSYSRetail.TransactionAmount = "10000"; // $100.00
  TSYSRetail.Authorize();
  
  TSYSReversal.ParseAggregate(TSYSRetail.GetDetailAggregate());
  TSYSReversal.ReversalCode = rcCustomerDirected;
  TSYSReversal.ReversalType = rtPreSettlement;
  TSYSReversal.SettlementAmount = "5000"; // $50.00
  TSYSReversal.Reverse();

  TSYSDetailRecord.ParseAggregate(TSYSRetail.GetDetailAggregate());
  TSYSDetailRecord.AuthorizedAmount = "5000"; // Current open authorization
  TSYSDetailRecord.SettlementAmount = "5000"; // Amount you wish to settle (need not be equal to AuthorizedAmount)
  TSYSDetailRecord.Config("PartiallyReversed=True");
  
  TSYSSettle.DetailRecords.Add(new TSYSRecordType(TSYSDetailRecord.GetDetailAggregate()));

So long as you pass aggregates around, the TSYSDetailRecord's TotalAuthorizedAmount will still reflect the originally authorized amount. You may change this using the TSYSDetailRecord's Config method.

When the control receives a response from the Vital/TSYS servers, the result of the reversal will be displayed in several Response properties. The ResponseCode indicates whether the reversal was approved, and the remaining response properties should exactly match the response from the original authorization.

Property List


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

AgentBankNumberThe batch number that this transaction will be included in.
AgentChainNumberIdentifies a specific chain of an agent organization.
ApprovalCodeThe Response ApprovalCode of the transaction being reversed.
BatchNumberThe batch number that this transaction will be included in.
CardCVVDataThree digit security code on back of card (optional).
CardCVVPresenceIndicates the presence of the card verification value.
CardEntryDataSourceThis property contains a 1-character code identifying the source of the customer data.
CardExpMonthExpiration month of the credit card specified in Number .
CardExpYearExpiration year of the credit card specified in Number .
CardMagneticStripeTrack data read off of the card's magnetic stripe.
CardNumberCustomer's credit card number for the transaction.
CardholderIdThe CardholderId code for this reversal.
CashBackAmountAmount returned to the customer in cash.
IndustryTypeCode which indicates the industry the merchant is engaged in.
MerchantBankIdThe number which identifies the merchant's bank or processor.
MerchantCategoryCodeClassifies a merchant by the type of store.
MerchantCityMerchant's City For Retail (Card Present) transactions, this property should contain the city in which the merchant is located.
MerchantCountryCodeIdentifies the country where the merchant is located.
MerchantCurrencyCodeIdentifies the type of currency used by the merchant.
MerchantLanguageDesignates the language that response messages will be returned in.
MerchantNameName of the merchant.
MerchantNumberA unique number used to identify the merchant within the VisaNet system.
MerchantServicePhoneMerchant's customer service number.
MerchantStateState or province that the merchant is located in.
MerchantStoreNumberUsed to identify a specific merchant's store within the VisaNet system.
MerchantTerminalNumberUsed to identify a unique terminal within a merchant location.
MerchantTimeZoneSpecifies the GMT offset used to calculate the local time within the VisaNet system.
MerchantZipZip code where the merchant that initiated this transaction is located.
MerchantABANumberMerchant's routing number.
MerchantSettlementAgentMerchant's settling agent.
NetworkIdIdentification code of the network on which the transaction was authorized.
ReimbursementAttributeIndicates the type of fee applicable to this transaction.
ResponseApprovalCodeContains an authorization code when a transaction has been approved.
ResponseAuthorizedAmountAmount actually used from the card (used when supporting partial redemptions).
ResponseAuthSourceIndicates the source of the authorization code stored in ApprovalCode .
ResponseAVSResultContains the Address Verification System result code.
ResponseCardLevelThis property contains a two-character code created by Visa during the authorization process.
ResponseCodeIndicates the status of the authorization request.
ResponseCommercialCardTypeResponse property that indicates whether the card is a commercial card.
ResponseCVVResultContains the returned CVV result code if it was requested.
ResponseRetrievalNumberThis number is to be used to identify transactions and should be submitted when making adjustments, reversals or at settlement.
ResponseReturnedACIReturned Authorization Characteristics Indicator contains CPS qualification status.
ResponseTextText information that describes each response code.
ResponseTransactionDateLocal transaction date returned from the server in MMddyy format.
ResponseTransactionIdContains the Transaction Identifier or MasterCard Reference Number.
ResponseTransactionNumberCheck this property against the original Transaction Number.
ResponseTransactionTimeLocal transaction time returned from the server in HHmmss format.
ResponseValidationCodeThis optional property contains information generated by the card issuer.
RetrievalNumberThe Response RetrievalNumber of the transaction being reversed.
ReturnedACIThe Response ReturnedACI of the transaction being reversed.
ReversalCodeThis code can be present in the reversal request for MasterCard transactions to signify the reason for the reversal.
ReversalTypeSpecifies the type of reversal to process.
SettlementAmountThe new Settlement Amount for this transaction.
SharingGroupList of Debit and EBT networks that the merchant supports.
SSLAcceptServerCertEncodedThe certificate (PEM/base64 encoded).
SSLCertEncodedThe certificate (PEM/base64 encoded).
SSLCertStoreThe name of the certificate store for the client certificate.
SSLCertStorePasswordIf the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.
SSLCertStoreTypeThe type of certificate store for this certificate.
SSLCertSubjectThe subject of the certificate used for client authentication.
SSLServerCertEncodedThe certificate (PEM/base64 encoded).
TimeoutA timeout for the component.
TotalAuthorizedAmountThe amount originally authorized.
TraceAuditNumberSystem Trace Audit Number returned for Debit and EBT transactions.
TransactionDateThe Response TransactionDate of the transaction being reversed.
TransactionIdThe Response TransactionId of the transaction being reversed.
TransactionNumberSequence number of this transaction.
TransactionTimeThe Response TransactionTime of the transaction being reversed.

Method List


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

ConfigSets or retrieves a configuration setting .
InterruptInterrupts the current action.
ParseAggregateParses the aggregate returned from another component's GetDetailAggregate method.
ResetClears all properties to their default values.
ReverseReverses a previously authorized transaction.

Event List


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

ConnectedFired immediately after a connection completes (or fails).
DataPacketInFired when receiving a data packet from the transaction server.
DataPacketOutFired when sending a data packet to the transaction server.
DisconnectedFired when a connection is closed.
ErrorInformation about errors during data delivery.
SSLServerAuthenticationFired after the server presents its certificate to the client.
SSLStatusShows the progress of the secure connection.

Configuration Settings


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

AccountDataSourceIdentifies the source of the customer card data entered.
MessageReasonCodeThe reversal message reason code used to identify why the reversal is being made.
SurchargeAmountThe transaction fee amount charged to the customer to account for acquirer-assessed surcharge.
POSDataCodeSpecifies the condition of the POS device used at the time of the transaction.
PortThe port to which transactions are posted.
ServerThe server to which transactions are posted.
GenKeyA randomly generated string of alphanumeric characters identifying the terminal.
ProcessorSpecifies the Processor you are connecting to.
HeartlandEncryptionModeSpecifies the encryption mode to use in Heartland transactions.
HeartlandDeviceIdSpecifies a device ID to uniquely identify each terminal (card data entry device).
ConnectionTimeoutSets a separate timeout value for establishing a connection.
FirewallAutoDetectTells the component whether or not to automatically detect and use firewall system settings, if available.
FirewallHostName or IP address of firewall (optional).
FirewallPasswordPassword to be used if authentication is to be used when connecting through the firewall.
FirewallPortThe TCP port for the FirewallHost;.
FirewallTypeDetermines the type of firewall to connect through.
FirewallUserA user name if authentication is to be used connecting through a firewall.
KeepAliveTimeThe inactivity time in milliseconds before a TCP keep-alive packet is sent.
KeepAliveIntervalThe retry interval, in milliseconds, to be used when a TCP keep-alive packet is sent and no response is received.
LingerWhen set to True, connections are terminated gracefully.
LingerTimeTime in seconds to have the connection linger.
LocalHostThe name of the local host through which connections are initiated or accepted.
LocalPortThe TCP port in the local host where the component binds.
MaxLineLengthThe maximum amount of data to accumulate when no EOL is found.
MaxTransferRateThe transfer rate limit in bytes per second.
RecordLengthThe length of received data records.
TCPKeepAliveDetermines whether or not the keep alive socket option is enabled.
UseIPv6Whether to use IPv6.
TcpNoDelayWhether or not to delay when sending packets.
TLS12SignatureAlgorithmsDefines the allowed TLS 1.2 signature algorithms when UseManagedSecurityAPI is True.
ReuseSSLSessionDetermines if the SSL session is reused.
SSLCipherStrengthThe minimum cipher strength used for bulk encryption.
SSLEnabledProtocolsUsed to enable/disable the supported security protocols.
SSLProviderThe name of the security provider to use.
SSLSecurityFlagsFlags that control certificate verification.
OpenSSLCADirThe path to a directory containing CA certificates.
OpenSSLCAFileName of the file containing the list of CA's trusted by your application.
OpenSSLCipherListA string that controls the ciphers to be used by SSL.
OpenSSLPrngSeedDataThe data to seed the pseudo random number generator (PRNG).
AbsoluteTimeoutDetermines whether timeouts are inactivity timeouts or absolute timeouts.
FirewallDataUsed to send extra data to the firewall.
InBufferSizeThe size in bytes of the incoming queue of the socket.
OutBufferSizeThe size in bytes of the outgoing queue of the socket.
CodePageThe system code page used for Unicode to Multibyte translations.

 
 
Copyright (c) 2017 /n software inc. - All rights reserved.
Build 6.0.6240.0