The following can be referenced as supplemental material, and are referenced throughout this section:
The Transaction Management Developer’s Guide provides guidance for the integration of the Transaction Management API with existing Commerce Web Services SOAP/REST applications.
The Transaction Management Service (TMS) provides read-only access to merchant transaction data stored in the Commerce Web Services (CWS) transaction database. TMS eliminates the need for the merchant application to store transaction data locally by providing access to merchant transaction data for transaction reporting purposes, as well as for processing subsequent transactions, such as incremental authorizations, settlement, etc.
To take advantage of this value-added service through the integration of the Transaction Management Service API, the TMS API uses both Service Key and sign-on authentication credentials to ensure secure access to transaction data.
TMS provides the following benefits:
The Transaction Management Service requires a dedicated web service endpoint to reduce the impact to existing CWS SOAP/REST endpoints during large query operations.
Due to the large amount of stored transaction data, response data is retrieved in manageable “chunks” when performing transaction data queries. This allows the application to easily manage the data for proper paging display.
By default, up to 50 transaction records are returned as part of a single query response. This default can be overridden by the client by any amount that does not exceed the maximum record return count. If the client request exceeds the maximum configurable value, an error message is returned to the application indicating the maximum value of records that can be returned has been exceeded.
In addition to the Service Information (SvcInfo) and Transaction Processing (Txn) service endpoints provided by CWS integrations, the Transaction Management Service uses a dedicated web service endpoint called TMS.
The Transaction Management Service web service endpoint and its supported functions can be found below:
Transaction Management (TMS) endpoints provide the following functionality:
A Service Key is a globally unique identifier assigned to all certified applications (aka “transaction originators”) for authentication and subsequent consumption of services running on the Managed Commerce Services Platform. An identity token is then generated and associated with the application’s Service Key. A single application can operate on behalf of one or more Service Keys.
Applications communicate with each Web Service Endpoint using endpoint URLs. There is a primary endpoint URL and a secondary endpoint URL. Your application does not need to make any special accommodations when interacting with these primary and/or secondary endpoints. They merely provide failover functionality in the event that one endpoint is not available.
Should the primary endpoint result in an unsuccessful connection, your application should try the secondary endpoint. In the event that neither endpoint URL results in a successful connection, the application should alert the user that no endpoints are available and they should contact their administrator.
Applications should first default to the primary (cws-01) endpoint URLs. If connecting to the primary endpoint URL is unsuccessful, the application should attempt the secondary (cws-02) endpoint URLs. Administrative users must be allowed to view and modify these URLs as needed.
|Transaction Management Endpoint URLs|
Enabling payment processing is just one aspect of providing a robust payment solutions to your merchants. Providing the ability for merchants to manage transactions and perform subsequent transaction processing such as voids, returns, and batch settlement processing is critical to supporting the full transaction lifecycle.
While the Preparing the Application to Transact and Transaction Processing steps are required for all CWS integrations, providing transaction management functionality to your merchants is optional, but highly recommended. Furthermore, the decision about whether to include transaction management functionality within your payment solution or leverage a third-party transaction management solution is an important development consideration.
Software developers should consult the Transaction Management Developer’s Guide for troubleshooting and integration guidance associated with the implementation of transaction management functionality within their payment solutions.
|Transaction Management Overview||Implementation|
|Integration Guidance||API Reference|
The Transaction Management Service (TMS) provides read-only access to merchant transaction data stored in the Commerce Web Services (CWS) transaction database. TMS eliminates the need for the merchant application to store transaction data locally by providing access to merchant transaction data for transaction reporting purposes, as well as for processing subsequent transactions, such as incremental authorizations, voids, returns, and batch settlement processing.
Transaction management functionality is supported by the Transaction Management Service (TMS) and corresponding Transaction Management API. The TMS API makes use of both Service Keys and sign-on authentication credentials to ensure safe, secure access to CWS transaction data.
The integration of the TMS API provides the following benefits:
This information describes the hierarchy of data elements and parameters, including data types and usage requirements associated with the the Transaction Management Service (TMS) SOAP/REST APIs for integrating the Transaction Management API within new or existing CWS SOAP/REST applications. Please see the Transaction Management Service Requests API Reference for more information.