Download First Data Global Gateway Integration Guide Web Service API
Transcript
4 Sending Transactions to the Gateway This section describes the basic steps to take place when sending transactions to the First Data Global Gateway. The customer initiates checkout in the online store. The online store displays a form asking the customer to provide a credit card number and the expiration date. The customer enters and submits the data. The online store receives the data and builds an XML document encoding a Sale transaction, which includes the data provided by the customer and the total amount to be paid by the customer. After building the XML Sale transaction, the online store wraps it in a SOAP message, which describes the Web Service operation to be called with the transaction XML being passed as a parameter. The online store generates an HTTP POST request containing the soap message and sets the HTTP basic authorization headers. The online store establishes an SSL connection by providing the client and server certificate. The online store sends the HTTP POST request to the First Data Global Gateway Web Service API and waits for an HTTP response. The Web Service API receives the HTTPS request and parses the authorization information provided by the store in the HTTP headers. Having authorized the store, the Web Service API parses the SOAP message contained in the HTTP request body, triggering the call to the transaction operation. The First Data Global Gateway Web Service API performs the transaction processing, builds an XML response document, wraps it in a SOAP message, and sends the SOAP message back to the client in the body of an HTTP response. The online store receives the HTTP response. Depending upon the data contained in the XML response document, the online store displays the approval or error message. While this example describes the case of a Sale transaction, other transactions follow the same process. Your application performs the following steps in order to submit transactions and analyze the result: Build an XML document encoding your transactions. Wrap that XML document in a SOAP request message. Build an HTTP POST request with the information identifying your store provided in the HTTP header and the SOAP request message in the body. First Data Corp. Web Service API v3 11