Collect information for the
Cybersource
services that you will use
Assemble the order information into requests
Send the requests to the
Cybersource
server
The
Cybersource
servers do not support persistent HTTP connections.
Process the reply information

<?xml version="1.0" encoding="utf-8"?>
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.18">
</requestMessage>

   Namespace: urn:schemas-cybersource-com:transaction-data-
   
1.18

<?xml version="1.0" encoding="utf-8"?>
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-
1.18">
  <ccAuthService run="true"/>
</requestMessage>

<?xml version="1.0" encoding="utf-8"?>
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.18">
  <ccAuthService run="true"/>
  <ccCaptureService run="true"/>
</requestMessage>

<businessRules>
    <ignoreAVSResult>true</ignoreAVSResult>
</businessRules>

<?xml version="1.0" encoding="utf-8"?>
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-
1.18">
  <billTo>
    <firstName>Jane</firstName>
    <lastName>Smith</lastName>
  </billTo>
  <item id="0">
    <unitPrice>29.95</unitPrice>
  </item>
  <card>
    <accountNumber>4111111111111111</accountNumber>
  </card>
  <ccAuthService run="true"/>
</requestMessage>

import java.io.*;
import java.util.*;
import javax.xml.parsers.*;
import org.w3c.dom.*;
import org.xml.sax.*;
import com.cybersource.ws.client.*;

Properties props = Utility.readProperties( args );

try {
  Document request = readRequest( props, args );
  // The sample reads the files specified in the command line, or if no files are
  // specified, the sample looks for cybs.properties and auth.xml in the current
  // directory.
  Document reply = XMLClient.runTransaction( request, props );
  // Using the Decision and Reason Code Fields illustrates how you might
  // design a ProcessReply() method to handle the reply.
  processReply( reply );
}
catch (FaultException e)
{
  e.printStackTrace();
  System.out.println( e.getLogString() );
}
catch (ClientException e)
{
  e.getInnerException().printStackTrace();
  System.out.println( e.getLogString() );
}

decision
: A one-word description of the results of your request:
ACCEPT
if the request succeeded.
REJECT
if one or more of the services in the request was declined.
REVIEW
(Advanced package only) if you use
Decision Manager
, and the order is marked for review. For more information, see Handling Decision Manager Reviews (Cybersource Advanced Merchants).
ERROR
if a system error occurred. For more information, see Handling System Errors.
reasonCode
: A numeric code that provides more specific information about the results of your request.

private static boolean processReply( Document reply )
  throws ClientException {
  // The following code allows you to use XPath with the Cybersource schema, which
  // uses a non-empty default namespace.
  XPathAPI xp = new XPathAPI();
  Element nsNode = reply.createElement( "nsNode" );
  // The version number (1.20) at the end of the namespaceURI below is an example.
  // Change it to the version of the API that you are using.
  nsNode.setAttribute("xmlns:cybs", "urn:schemas-cybersource-com:transaction-data

    -1.20" );
  Node replyMessage =
    getNode( xp, reply, "cybs:replyMessage", nsNode );
  String decision =
    getText( xp, replyMessage, "cybs:decision", nsNode );		
  MessageFormat template =
    new MessageFormat( getTemplate( decision ) );
  Object[] content = { getContent( xp, replyMessage, nsNode ) };
  /*
   * This example writes the message to the console. Choose an appropriate display
   * method for your own application.
   */
  System.out.println( template.format( content ) );
}
  private static String getTemplate( String decision ){
    // Retrieves the text that corresponds to the decision.
    if ("ACCEPT".equalsIgnoreCase( decision )) {
      return( "Your order was approved.{0}" );
    }
    if ("REJECT".equalsIgnoreCase( decision )) {
      return( "Your order was not approved.{0}" );
    }
    // ERROR, or unknown decision
    return( "Your order cannot be completed at this time.{0}" +
            "\nPlease try again later." );
}
private static String getContent(
  XPathAPI xp, Node ctxNode, Node nsNode )
  throws XMLClientException {
  /*
   * Uses the reason code to retrieve more details to add to the template.
   * The strings returned in this sample are meant to demonstrate how to retrieve
   * the reply fields. Your application should display user-friendly messages.
   */
  int reasonCode = Integer.parseInt(
    getText( xp, ctxNode, "cybs:reasonCode", nsNode ) );
  switch (reasonCode) {
    // Success
    case 100:
      return ( "\nRequest ID: " +
        getText( xp, ctxNode, "cybs:requestID", nsNode ) );
    // Missing field or fields
    case 101:
      return( "\nThe following required field(s) are missing:\n" +
      enumerateValues( xp, ctxNode, "cybs:missingField", nsNode ) );
    // Invalid field or fields
    case 102:
      return( "\nThe following field(s) are invalid:\n" +
      enumerateValues( xp, ctxNode, "cybs:invalidField", nsNode ) );
    // Insufficient funds
    case 204:
      return( "\nInsufficient funds in the account. Please use a " +
              "different card or select another form of payment." );
    // Add additional reason codes here that you must handle specifically.
    default:
      // For all other reason codes (for example, unrecognized reason codes, or
      // codes that do not require special handling), return an empty string.
      return( "" );
  }
}
private static String enumerateValues(
  XPathAPI xp, Node ctxNode, String xpath, Node nsNode )
  throws TransformerException {
  try {
    StringBuffer sb = new StringBuffer();
    NodeList list =
      xp.selectNodeList( ctxNode, xpath + "/text()", nsNode );
    if (list != null) {
      for (int i = 0, len = list.getLength(); i < len; ++i) {
        sb.append( list.item( i ).getNodeValue() + "\n" );
      }
    }
    return( sb.toString() );
  }
}

If you authorize and capture the credit card payment at the same time, treat the
REVIEW
response like a
REJECT
response. Rejecting any orders that are marked for review may be appropriate if your product is a software download or access to a Web site. If supported by your processor, you may also want to reverse the authorization.
If you approve the order after reviewing it, convert the order status to
ACCEPT
in your order management system. You can request the credit card capture without requesting a new authorization.
If you approve the order after reviewing it but cannot convert the order status to
ACCEPT
in your system, request a new authorization for the order. When processing this new authorization, you must disable
Decision Manager
. Otherwise the order will be marked for review again. For details about the API field that disables
Decision Manager
, see the
Decision Manager
User Guide
.

Find the transaction in the
Business Center
. After looking at the description of the error on the transaction details page, call your processor to determine if and why the transaction was rejected. If your processor is
TSYS Acquiring Solutions
, you may want to follow this option because this processor can return several system errors that only it can address.
Contact
Cybersource
Customer Support to determine whether the error is caused by a
Cybersource
system issue.