Your local machine is running J2SE 17 or newer
Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy files have been downloaded from the Oracle Java SE download page and they are installed on your local machine:
US_export_policy.jar
local_policy.jar
The files are available at http://www.oracle.com/technetwork/java/javase/downloads/index.html.

Email Notifications

Cybersource

sends email that reports failed or successful validation of batch files and for successful processing of batched transaction requests. For more information, see Viewing Email Notifications.

Batch Validation Response File

After a batch file is uploaded,

Cybersource

checks the validity of the batch file contents and then creates an XML file that shows whether the batch file validation succeeded or failed. If the batch file contains an error, none of the transaction requests are processed. See Viewing the Results of Batch File Validation.

Transaction Response Files

After batched transaction requests are processed,

Cybersource

creates two CSV-formatted files. One file lists processing results for all transactions, whether accepted, rejected, or error. The other file lists results only for any transactions that were rejected or that triggered a processing error. For more information, see Viewing the Results of Transaction Processing.

Transaction Request Report

This automatically generated report contains general information about the transaction requests that were uploaded from a batch file. For more information, see Viewing the Transaction Request Report.

Batch Submission Detail Report

This automatically generated report contains detailed information about the transaction requests that were uploaded from a batch file. For more information, see Viewing the Batch Submission Detail Report.

Payment Batch Detail Report

This transaction-level report shows all of your sales and refunds that were submitted to your payment processor through the

Business Center

. The report also tracks which of your transactions have been settled.

See

Getting Started with

Business Center

Reports

.

Authorizations

An authorization confirms that a payment card account holds sufficient funds to pay for a purchase. A successful authorization places a hold on the funds in the account, reducing the cardholder's available limits by the authorized amount. The name of the template file for authorizations is

authorizations-TEMPLATE.csv

.

Sales

A sale bundles an authorization and capture into a single transaction request. Upon a successful transaction, funds are immediately transferred from the cardholder account to the merchant account. The authorization and capture amounts must be the same. The

sales-TEMPLATE.csv

template supports these types of transactions:

Sales
Sales with Level III data

Captures

A capture, also known as

settlement

, transfers funds from the cardholder’s account to your bank and releases the hold that the authorization placed on the cardholder’s credit card funds. Include in the capture request message the request ID returned from the previous authorization. The

captures-TEMPLATE.csv

template supports these types of transactions:

Captures
Captures with Level III data

Credits

A

refund

(also known as a

follow-on credit

) is a payment refund from your bank to the cardholder for a payment that has already been captured. In the request, include the request ID that was returned in the response to the capture request. Unless otherwise specified, you must request a refund within 180 days of a settlement. The

credits-TEMPLATE.csv

template supports these types of transactions:

Credits
Original credit transactions (OCTs)

ACH Service

These templates are available for ACH service transactions:

The
echeck-debits-TEMPLATE.csv
template supports ACH service debits.
The
echeck-credits-TEMPLATE.csv
template supports ACH service credits.

import java.util.*;
import java.io.*;
import javax.net.ssl.*;
import java.security.*;
public class SSLFileTransfer {
	Properties props = new Properties(); // stores properties from property file
	/**
	 * Default constructor
	 */
	public SSLFileTransfer() {}
	/**
	 * Initialize program by reading properties file.
	 *
	 * @param propsFile needed for file transfer
	 */
	public void init(String propsFile) {
		try {
			props.load(new BufferedInputStream(new FileInputStream(new File(propsFile))));
		} catch (Exception e) {
			e.printStackTrace();
			System.exit(-1);
		}
	}
	/**
	 * Error message if incorrect arguments are passed.
	 */
	public static void usage() {
		System.out.println("USAGE: java SSLFileTransfer <full path property file name>");
		System.exit(-1);
	}
	/**
	 * Get factory for authentication
	 *
	 * @throws IOException if exception occurs
	 */
	private SSLSocketFactory getFactory() throws IOException {
		try {
			SSLContext ctx;
			KeyManagerFactory kmf;
			KeyStore ks, ks1;
			char[] passphrase =	props.getProperty("passPhrase").toCharArray();
			ctx = SSLContext.getInstance("TLSv1.2");
			kmf = KeyManagerFactory.getInstance("SunX509");
			ks = KeyStore.getInstance("PKCS12");
			ks1 = KeyStore.getInstance("JKS");
			ks.load(new FileInputStream(props.getProperty("key")), passphrase);
			ks1.load(new FileInputStream(props.getProperty("keyStore")), passphrase);
			kmf.init(ks, passphrase);
			TrustManagerFactory tmf = TrustManagerFactory.getInstance("SunX509");
			tmf.init(ks1);
			ctx.init(kmf.getKeyManagers(), tmf.getTrustManagers(), null);
			return ctx.getSocketFactory();
		} catch (Exception e) {
			e.printStackTrace();
			throw new IOException(e.getMessage());
		}
	 }
	/**
	 * Get host from property file
	 */
	private String getHost() {
		return props.getProperty("host", "localhost");
	}
	/**
	 * Get port from property file
	 */
	private int getPort() {
		return Integer.parseInt(props.getProperty("port"));
	}
	/**
	 * Send request (file) to the server.
	 * 
	 * @param out outstream to send the data to the server
	 * @throws Exception if an error occurs.
	 */
	private void sendRequest(PrintWriter out) throws Exception {
		final String CRLF = "\r\n";
		String path = props.getProperty("path");
		out.print("POST " + path + " HTTP/1.1" + CRLF);
		final String BOUNDARY = "7d03135102b8";
		out.print("Host: " + props.getProperty("host") + CRLF);
		out.print("Content-Type: multipart/form-data; boundary="+BOUNDARY+CRLF);
		String uploadFile = props.getProperty("uploadFile");
		String authString = props.getProperty("bcUserName") + ":" + props.getProperty("bcPassword");
		String encodedAuthString = "Basic " + new sun.misc.BASE64Encoder().encode(authString.getBytes ());
		out.print("Authorization: " + encodedAuthString+CRLF);
		StringBuffer sbuf = new StringBuffer();
		sbuf.append("--"+BOUNDARY+CRLF);
		sbuf.append("Content-Disposition: form-data; name=\"upfile\"; filename=\"" + uploadFile + "\""+CRLF);
		sbuf.append("Content-Type: text/plain"+CRLF+CRLF);
		char[] buf;
		int cnt;
		FileReader fi = new FileReader(uploadFile);
		try {
			buf = new char[1024000];
			cnt = fi.read(buf);
		} finally {
			fi.close();
		}
		sbuf.append(buf, 0, cnt);
		sbuf.append(CRLF);
		sbuf.append("--"+BOUNDARY+"--"+CRLF);
		int sz = sbuf.length();
		out.print("Content-Length: "+ sz+CRLF);
		out.print(CRLF);
		out.print(sbuf);
		out.flush();
		// Make sure there were no surprises
		if (out.checkError()) {
			System.out.println("SSLFileTransfer: java.io.PrintWriter error");
		}
	}
	/**
	 * Reads the response from the server.
	 * @param in instream to get the data from the server
	 * @throws Exception if an error occurs.
	 */
	private void readResponse(BufferedReader in) throws Exception {
		boolean successful = false;
		String inputLine;
		while ((inputLine = in.readLine()) != null) {
			if (inputLine.startsWith("HTTP") && inputLine.indexOf("200") >= 0) {
				successful = true;
			}
			System.out.println(inputLine);
		 }
		System.out.println("UPLOAD FILE " + (successful? "SUCCESSFUL" :	"FAILED") + "!!!\n");
	}
	/**
	 * Upload file to the server.
	 * @throws Exception if an error occurs.
	 */
	public void upload() throws Exception {
		try {
			SSLSocketFactory factory = getFactory();
			SSLSocket socket = (SSLSocket)factory.createSocket(getHost(), getPort());
			PrintWriter out = new PrintWriter(new BufferedWriter(new OutputStreamWriter(socket.getOutputStream())));
			BufferedReader in = new BufferedReader(new InputStreamReader(socket.getInputStream()));
			socket.startHandshake();
			sendRequest(out);
			readResponse(in);
			out.close();
			in.close();
			socket.close();
		} catch (Exception e) {
			e.printStackTrace();
			throw e;
		}
	}
	/**
	 * Main method to start file transfer
	 * @param args command line arguments (property file, see usage())
	 * @throws Exception if an error occurs.
	 */
	public static void main(String[] args) throws Exception {
		if (args == null || args.length != 1) {
			usage();
		}
		SSLFileTransfer fileXfer = new SSLFileTransfer();
		fileXfer.init(args[0]);
		fileXfer.upload();
	}
}

<!ELEMENT Batch (ValidationStatus, ValidatedRecords, ValidationTime, ValidationErrors)>
<!ATTLIST Batch BatchID CDATA #REQUIRED
         MerchantID CDATA #REQUIRED
         Name CDATA #REQUIRED
         Version NMTOKEN #REQUIRED>
<!ELEMENT ValidationStatus (#PCDATA)>
<!ELEMENT ValidatedRecords (#PCDATA)>
<!ELEMENT ValidationTime (#PCDATA)>
<!ELEMENT ValidationErrors (Error)*>
<!ELEMENT Error (RecordNumber, ErrorCode, ErrorMessage, ErrorRemedy)>
<!ELEMENT RecordNumber (#PCDATA)>
<!ELEMENT ErrorCode (#PCDATA)>
<!ELEMENT ErrorMessage (#PCDATA)>
<!ELEMENT ErrorRemedy (#PCDATA)>

<Batch BatchID=CDATA
       MerchantID=CDATA
       Name=CDATA
       Version=NMTOKEN>
   (ValidationStatus)
   (ValidatedRecords)
   (ValidationTime)
   (ValidationErrors)
</Batch>

<ValidationErrors>
   (Error)*
</ValidationErrors>

<Error>
   (RecordNumber)
   (ErrorCode)
   (ErrorMessage)
   (ErrorRemedy)
</Error>

Full list of transaction responses

This file lists results only for transactions that were rejected or that triggered a processing error.

File name format:
<merchantID>.<batchID>.reply.all
File name example:
CyberVacations.12345.reply.all

List of exceptions

This file lists results only for transactions that were rejected or that triggered a processing error.

File name format:
<merchantID>.<batchID>.reply.rejected
File name example:
CyberVacations.12345.reply.rejected

Batch with batchID=55555 was validated successfully.

<!ELEMENT Report (BatchFiles)>
<!ATTLIST Report Name CDATA #REQUIRED
         Version NMTOKEN #REQUIRED
         xmlns CDATA #REQUIRED
         MerchantID CDATA #REQUIRED
         ReportStartDate CDATA #REQUIRED
         ReportEndDate CDATA #REQUIRED>
<!ELEMENT BatchFiles (BatchFile)*>
<!ELEMENT BatchFile (PaymentProcessor)*>
<!ATTLIST BatchFile BatchFileID CDATA #REQUIRED>
<!ELEMENT PaymentProcessor (Request)*>
<!ATTLIST PaymentProcessor PaymentProcessorName CDATA #REQUIRED>
<!ELEMENT Request (TransactionReferenceNumber, MerchantReferenceNumber,
          TransactionStatus, Amount, CurrencyCode, PaymentStatus)>
<!ATTLIST Request RequestID CDATA #REQUIRED>
<!ELEMENT TransactionReferenceNumber (#PCDATA)>
<!ELEMENT MerchantReferenceNumber (#PCDATA)>
<!ELEMENT TransactionStatus (#PCDATA)>
<!ELEMENT Amount (#PCDATA)>
<!ELEMENT CurrencyCode (#PCDATA)>
<!ELEMENT PaymentStatus (#PCDATA)>

<Report Name=CDATA
      Version=NMTOKEN
      xmlns=CDATA
      MerchantID=CDATA
      ReportStartDate=CDATA
      ReportEndDate=CDATA>
   (BatchFiles)
</Report>

<Report Name="Batch Files Detail Report"
      Version="1.0"
      xmlns="http://reports.cybersource.com/reports/bfdr/1.0"
      MerchantID="pcpawnshop"
      ReportStartDate="2006-09-29T05:00:00-05:00"
      ReportEndDate="2006-09-30T05:00:00-05:00">
      <BatchFiles>
         ...
      </BatchFiles>
</Report>

<BatchFiles>
      (BatchFile)*
</BatchFiles>

<BatchFiles>
      <BatchFile BatchFileID="123">
         ...
      </BatchFile>
</BatchFiles>

<BatchFile BatchFileID=CDATA>
      (PaymentProcessor)*
</BatchFile>

<BatchFile BatchFileID="10101">
      <PaymentProcessor PaymentProcessorName="vital”>
         ...
      </PaymentProcessor>
</
BatchFile>

<PaymentProcessor PaymentProcessorName=CDATA>
      (Request)*
</PaymentProcessor>

<PaymentProcessor PaymentProcessorName="vital">
      <Request>
         ...
      </Request>
</PaymentProcessor>

<Request RequestID=CDATA>
      (TransactionReferenceNumber)
      (MerchantReferenceNumber)
      (TransactionStatus)
      (Amount)
      (CurrencyCode)
      (PaymentStatus)
</Request>

<Request RequestID="1580782287420174065733">
      <TransactionReferenceNumber>5533830406</TransactionReferenceNumber>
      <MerchantReferenceNumber>1158078228539</MerchantReferenceNumber>
      <TransactionStatus>SOK</TransactionStatus>
      <Amount>25.00</Amount>
      <CurrencyCode>USD</CurrencyCode>
      <PaymentStatus>PENDING</PaymentStatus>
</Request>

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE Report SYSTEM "https://businesscentertest.cybersource.com/ebctest/reports/dtd/bfdr.dtd">
<Report Name="Batch Files Detail Report"
    Version="1.0"
    xmlns="https://businesscentertest.cybersource.com/ebctest/reports/dtd/bfdr.dtd"
    MerchantID="pcpawnshop"
    ReportStartDate="2006-09-29T05:00:00-05:00"
    ReportEndDate="2006-09-30T05:00:00-05:00">
    <BatchFiles>
        <BatchFile BatchFileID="127788">
            <PaymentProcessor PaymentProcessorName="vital">
                <Request RequestID="1595558344253232243215">
                    <TransactionReferenceNumber>7242635150</TransactionReferenceNumber>
                    <MerchantReferenceNumber>1158078228539</MerchantReferenceNumber>
                    <TransactionStatus>SOK</TransactionStatus>
                    <Amount>25.00</Amount>
                    <CurrencyCode>USD</CurrencyCode>
                    <PaymentStatus>PENDING</PaymentStatus>
                </Request>
                <Request RequestID="1595558354743232243215">
                    <TransactionReferenceNumber>7242636613</TransactionReferenceNumber>
                    <MerchantReferenceNumber>1158078892610</MerchantReferenceNumber>
                    <TransactionStatus>SOK</TransactionStatus>
                    <Amount>100.00</Amount>
                    <CurrencyCode>USD</CurrencyCode>
                    <PaymentStatus>PENDING</PaymentStatus>
                </Request>
                <Request RequestID="1595558364563232243215">
                    <TransactionReferenceNumber>7242637653</TransactionReferenceNumber>
                    <MerchantReferenceNumber>1158079157035</MerchantReferenceNumber>
                    <TransactionStatus>SOK</TransactionStatus>
                    <Amount>99.00</Amount>
                    <CurrencyCode>USD</CurrencyCode>
                    <PaymentStatus>VOIDED</PaymentStatus>
                </Request>
            </PaymentProcessor>
        </BatchFile>
        <BatchFile BatchFileID="123987">
            <PaymentProcessor PaymentProcessorName="smartfdc">
                <Request RequestID="1595564779663232243215">
                    <TransactionReferenceNumber>7243278653</TransactionReferenceNumber>
                    <MerchantReferenceNumber>1159429157035</MerchantReferenceNumber>
                    <TransactionStatus>SOK</TransactionStatus>
                    <Amount>4.00</Amount>
                    <CurrencyCode>USD</CurrencyCode>
                    <PaymentStatus>PENDING</PaymentStatus>
                </Request>
            </PaymentProcessor>
        </BatchFile>
    </BatchFiles>
</Report>

Batch Files Detail Report,1,2006-09-29 to 2006-09-30,,,,,,,
merchant_id,txn_batch_id,payment_processor,request_id,trans_ref_no,
merchant_ref_number,ics_rflag,amount,currency,action
pcpawnshop,127788,vital,1598344253232243215,7242635150,
1158078228539,SOK,25.00,USD,PENDING
pcpawnshop,127788,vital,1598354743232243226,7242636613,
1158078892610,SOK,100.00,USD,PENDING
pcpawnshop,127788,vital,1598364563232243237,7242637653,
1158079157035,SOK,99.00,USD,VOIDED
pcpawnshop,123987,smartfdc,1594779663232243248,7243278653,
1159429157035,SOK,4.00,USD,PENDING

<!ELEMENT Report (Transaction)*>
<!ATTLIST Report MerchantID CDATA #REQUIRED
                 Name CDATA #REQUIRED
                 SubmissionFileID CDATA #REQUIRED
                 SubmissionDateTime CDATA #REQUIRED
                 Version NMTOKEN #REQUIRED>
<!ELEMENT Transaction (LinkToRequest?, RequestID, TransactionDate, CybsMID, 
  ProcessorMID?, HierarchyID?, TransRefNumber?, MerchantRefNumber?, TransactionType?, 
  Amount?, TransactionAmountCurrency?, PaymentMethod?, PaymentType?, AccountSuffix?, 
  Decision?, ReasonCode?, Auth?, MerchantDefinedData1?, MerchantDefinedData2?, 
  MerchantDefinedData3?, MerchantDefinedData4?)>
<!ELEMENT LinkToRequest (#PCDATA)>
<!ELEMENT RequestID (#PCDATA)>
<!ELEMENT TransactionDate (#PCDATA)>
<!ELEMENT CybsMID (#PCDATA)>
<!ELEMENT ProcessorMID (#PCDATA)>
<!ELEMENT HierarchyID (#PCDATA)>
<!ELEMENT TransRefNumber (#PCDATA)>
<!ELEMENT MerchantRefNumber (#PCDATA)>
<!ELEMENT TransactionType (#PCDATA)>
<!ELEMENT Amount (#PCDATA)>
<!ELEMENT TransactionAmountCurrency (#PCDATA)>
<!ELEMENT PaymentMethod (#PCDATA)>
<!ELEMENT PaymentType (#PCDATA)>
<!ELEMENT AccountSuffix (#PCDATA)>
<!ELEMENT Decision (#PCDATA)>
<!ELEMENT ReasonCode (#PCDATA)>
<!ELEMENT Auth (TransRefNumber?, TransactionDate?, RequestID?, Amount?, 
  Currency?, AuthCode?, ReasonCode?, RCode?)>
<!ELEMENT TransRefNumber (#PCDATA)>
<!ELEMENT TransactionDate (#PCDATA)>
<!ELEMENT RequestID (#PCDATA)>
<!ELEMENT Amount (#PCDATA)>
<!ELEMENT Currency (#PCDATA)>
<!ELEMENT AuthCode (#PCDATA)>
<!ELEMENT ReasonCode (#PCDATA)>
<!ELEMENT RCode (#PCDATA)>
<!ELEMENT MerchantDefinedData1 (#PCDATA)>
<!ELEMENT MerchantDefinedData2 (#PCDATA)>
<!ELEMENT MerchantDefinedData3 (#PCDATA)>
<!ELEMENT MerchantDefinedData4 (#PCDATA)>

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE Report SYSTEM "https://businesscentertest.cybersource.com/ebctest/reports/dtd/bsd.dtd">
<Report Name="Batch Submission Detail Report"
    Version="1.0"
    xmlns="https://businesscentertest.cybersource.com/ebctest/reports/dtd/bsd.dtd"
    Name="Batch Submission Detail Report"
    SubmissionFileID="12345678"
    SubmissionDateTime="2022-03-18 15:15:40 GMT"
    Version="1.0">
    <Transaction>
        <LinkToRequest>2689254011060008415089</LinkToRequest>
        <RequestID>2689254011060008415089</RequestID>
        <TransactionDate>2022-03-18 15:16:41 GMT</TransactionDate>
        <CybsMID>examplemerchantid</CybsMID>
        <TransRefNumber>81389795F6RU7QH0</TransRefNumber>
        <MerchantRefNumber>12345-8569-8794654</MerchantRefNumber>
        <TransactionType>ics_bill,ics_auth</TransactionType>
        <Amount>1.00</Amount>
        <TransactionAmountCurrency>USD</TransactionAmountCurrency>
        <PaymentMethod>credit card</PaymentMethod>
        <PaymentType>MasterCard</PaymentType>
        <AccountSuffix>1234</AccountSuffix>
        <ReasonCode>231</ReasonCode>
        <Auth>
            <RequestID>2689254011060008415089</RequestID>
        </Auth>
    </Transaction>
</Report>

Submission Date/Time,Submission File ID,link_to_request,request_id,transaction_ 
date,cybs_mid,processor_mid,hierarchy_id,trans_ref_number,merchant_ref_number,
transaction_type,amount,transaction,amount_currency,payment_method,
payment_type,account_suffix,decision,reason_code,reserved,auth_trans_ref_number,
auth_date,auth_request_id,auth_amount,auth_currency,auth_code,auth_reason_code,
auth_rcode,merchant_defined_data1,merchant_defined_data2,merchant_defined_data3,
merchant_defined_data4 2020-02-06 23:50:41 GMT,10100019,9.99E+21,
5.81E+21,2020-02-06 23:50:56 GMT,example_renewal,
exampleCYBS,CS000000196682612120020707470300001,"ics_ bill,ics_auth",684.18,
SGD,credit card,Visa,1625,100,2CYBS,2020-02-06 23:50:56 GMT,9.99E+21,684.18,
SGD,34521,1 2020-02-06 23:50:41 GMT,10100019,9.99E+21,5.81E+21,2020-02-06 23:50:56 
GMT,example_renewal,exampleCYBS,CS000000197045901520020707470300005,
"ics_bill,ics_auth",111.37,SGD,credit card,Visa,5246,100,2CYBS,2020-02-06 23:50:56 
GMT,9.99E+21,111.37,SGD,698141,1 2020-02-06 23:50:41 GMT,10100019,9.99E+21,
5.81E+21,2020-02-06 23:50:56 GMT,example_renewal,
exampleCYBS,CS000000197194803220020707470300006,
"ics_auth,ics_bill",140.02,SGD,credit card,Visa,7315,100,2CYBS,2020-02-06 23:50:56 
GMT,9.99E+21,140.02,SGD,42372,1 2020-02-06 23:50:41 
GMT,10100019,9.99E+21,5.81E+21,2020-02-06 23:50:56 
GMT,example_renewal,exampleCYBS,CS000000194267014620020707470300007,
"ics_bill,ics_auth",74.13SGD,credit card,MasterCard,782,100,2CYBS,2020-02-06 
23:50:56 GMT,9.99E+21,74.13,SGD,T87562,1