CreditCard Activities
Properties Configuration Settings
The CreditCard Activity is used to authorize a credit card charge.
Remarks
The CreditCard Activity allows you to use multiple Internet Payment Gateways through one property set and one activity. This allows for easy migration from one gateway to another, as well as quick integration into applications or web services.
CreditCard Send Activity
The CreditCard Send Activity allows your WorkFlow 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 activity, you will need to select the Gateway. The activity 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 CardNumber, CardExpMonth, CardExpYear, and CardCVVData. The activity will attempt to automatically discover the type of card based on the CardNumber, but you may directly set it via the CardCardType property.
Once you have set the card information, you must also set the customer information. This includes, but is not limited to, CustomerFirstName, CustomerLastName, and CustomerAddress. Finally, you must set the details of the actual transaction, such as TransactionAmount and any desired description via TransactionDesc.
After the activity 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.
Please refer to the section on adapter configuration for a description of how to configure receive locations and send ports for this adapter.
Sender Property List
The following is the full list of the properties of the sender activity 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 activity execution. |
MerchantLogin | Merchant's Gateway login. |
MerchantPassword | Merchant's Gateway password. |
Other | Defines a set of configuration settings to be used by the activity. |
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 activity runtime license key. |
SpecialFields | A set of properties specific to a particular Gateway . |
SSLAcceptServerCert | Instructs the activity to unconditionally accept the server certificate that matches the supplied certificate. |
SSLAcceptServerCertAcceptAny | Tells the activity to accept any server certificate. |
SSLCert | The certificate to use for client authentication during the SSL handshake. |
Timeout | A timeout for the activity. |
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 activity with short descriptions. Click on the links for further details.
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 activity whether or not to use the system security libraries or a managed implementation. |