CreditCard Tasks
Properties Configuration Settings
The CreditCard Task is used to authorize a credit card charge.
Remarks
The CreditCard Task allows you to use multiple Internet Payment Gateways through one property set and one task. This allows for easy migration from one gateway to another, as well as quick integration into applications or web services.
CreditCard Send Task
The CreditCard Send Task allows your SSIS Package to securely perform credit card transactions without the need to redirect to a third-party site. All transactions are accomplished through a secure HTTPS Post to any supported gateway. To gain access to gateway services you must first contact a gateway vendor and set up an account. Necessary account and password detail will be supplied by the gateway.
In order to configure the task, you will need to select the Gateway. The task will automatically determine the URL for posting transactions, however you may override the default URL by directly setting the GatewayURL property. You must also supply, at the very least, your MerchantLogin. If your account requires a password, you should set that via the MerchantPassword property. Some gateways may also require that SSL be used, which can be set up by selecting an SSLCert for client authentication and a SSLAcceptServerCert for server authentication.
In order to perform a transaction, you must set the necessary properties. First and foremost, you must set the relevant card information, such as Number, ExpMonth, ExpYear, and CVVData. The task will attempt to automatically discover the type of card based on the Number, but you may directly set it via the CardType property.
Once you have set the card information, you must also set the customer information. This includes, but is not limited to, FirstName, LastName, and Address. Finally, you must set the details of the actual transaction, such as TransactionAmount and any desired description via TransactionDesc.
After the task has performed the transactions, the status will be returned via the various response properties, which can be read from the message context at runtime. These include TransactionApproved, ResponseApprovalCode, ResponseAVS, ResponseCode, ResponseCVV2 and ResponseInvoiceNumber. The complete response is stored in ResponseData, with a human-readable message in ResponseText. If the gateway returns an internal identifier for the transaction, it will be stored in ResponseTransactionId.
Sender Property List
The following is the full list of the properties of the sender task with short descriptions. Click on the links for further details.
AuthCode | Authorization code from a previous transaction. |
Card | Contains the customer's credit card information. |
Customer | A set of properties describing the Customer for the credit card transaction. |
Firewall | A set of properties related to firewall access. |
Gateway | Gateway to process transactions. |
GatewayURL | Default URL for a specific Gateway . |
HTTPProxy | A set of properties related to proxy access. |
InvoiceNumber | Merchant-generated invoice number. |
LogFile | The file to write logging information to at runtime. |
LogMode | What information gets logged during task execution. |
MerchantLogin | Merchant's Gateway login. |
MerchantPassword | Merchant's Gateway password. |
Other | Defines a set of configuration settings to be used by the task. |
ResponseApprovalCode | Contains an authorization code when a transaction has been approved. |
ResponseAVS | Contains the Address Verification System result code. |
ResponseCode | Additional error code returned by some gateways. |
ResponseCVV2 | Contains the returned CVV2 result code if it was requested. |
ResponseData | The entire response returned from the gateway processor. |
ResponseErrorText | Additional error description returned by some gateways. |
ResponseInvoiceNumber | Invoice number submitted in authorization request (if applicable). |
ResponseProcessorCode | Response code from the underlying processor. |
ResponseText | Text information that describes each response code. |
ResponseTransactionId | Contains the Visa Transaction Identifier or MasterCard Reference Number. |
RuntimeLicense | Specifies the task runtime license key. |
SpecialFields | A set of properties specific to a particular Gateway . |
SSLAcceptServerCert | Instructs the task to unconditionally accept the server certificate that matches the supplied certificate. |
SSLAcceptServerCertAcceptAny | Tells the task to accept any server certificate. |
SSLCert | The certificate to use for client authentication during the SSL handshake. |
Timeout | A timeout for the task. |
TransactionAmount | Purchase amount for an authorization transaction. |
TransactionApproved | Indicates the status of the last transaction. |
TransactionDesc | Description of goods purchased. |
TransactionId | Transaction Id used for Capture, Credit, and Void transactions. |
TransactionType | Specifies the type of transaction to process. |
Configuration Settings
The following is a list of configuration settings for the task with short descriptions. Click on the links for further details.
CardType | Type of credit card being used in this transaction. |
CardCVVData | A three digit security code located on the back of many credit cards (optional). |
CardCVVPresence | This field is used to indicate the presence of CVVData. |
CardExpMonth | Expiration month of the credit card specified in CardNumber. |
CardExpYear | Expiration year of the credit card specified in Number. |
CardNumber | The customer's credit card number for this transaction. |
LogRawData | Whether the raw transaction request and response should be logged. |
SSLEnabledProtocols | Used to enable/disable the supported security protocols. |
AbsoluteTimeout | Determines whether timeouts are inactivity timeouts or absolute timeouts. |
LocalHost | The name of the local host or user-assigned IP interface through which connections are initiated or accepted. |
TcpNoDelay | Whether or not to delay when sending packets. |
UseManagedSecurityAPI | Tells the task whether or not to use the system security libraries or a managed implementation. |