Upload Batch Transaction Requests

Using any of the provided templates, you can upload a file containing multiple transaction requests. In one file, you can include transactions that use different services, currencies, countries, merchant IDs, and card types, thus eliminating the burden of handling these values separately.

Each file can contain only one type of transaction. For a list of available transactions, see Eligible Batch Upload Transaction Types.

After you upload your file, you can search for and review the processing status of your file.

Step 1On the left navigation panel, click Virtual Terminal.

Step 2Click Batch Transaction Upload. The Batch Transaction Upload page appears.

Step 3Click Batch Upload. The Batch Upload panel opens.

Step 4Enter any notes related to this batch of transactions.

Step 5Enter any email address to receive file upload status updates.

Step 6Click Browse to attach the file that you want to upload.

Files must be in CSV format and cannot be larger than 20 MB. Use the provided templates to ensure that the file is formatted properly.

Step 7Click Save. While the file is being processed, the status changes several times until processing is completed.

If the batch file contains a “Template=Custom” column, the OLP engine validates the batches.

Table 2Status Values
Status	Description
Validating	After the file is uploaded, the system displays Validating in the status grid. Cybersource usually updates the status in the grid and send a batch status alert within 30 minutes of receiving the file. However, actual timing depends on the system load and the number of files ahead of yours. Cybersource does not process any of the requests in the file if there is any type of syntax error. If multiple records in the file have errors, Cybersource sends only one email with the line number of the first failed record. Typical errors are: nThe record count you specified in the file header does not match the number of data records in the file. nA data record in the file does not have the correct number of fields as specified in the data header. The batch status alert indicates the line number of the problem data record.
ToBeResolved	After the file is uploaded, the system displays ToBeResolved in the status grid. Cybersource usually updates the status in the grid and send a batch status alert within 30 minutes of receiving the file. This happens for multiple reasons and requires manual intervention.
Rejected or OnHold	If the validation fails, the system displays Rejected or OnHold in the status grid. To handle a failed validation, follow the suggested remedy in the batch status alert. If you need to resend the file, use the same batch ID that you used for the original file unless otherwise instructed in the batch status alert.
Processing	If the validation succeeds, the system displays Processing in the status grid and Cybersource begins processing the transactions. The transaction processing time depends on the time of day and the size of your file. Submit the batch file early enough in the day to allow plenty of time for validation and processing before your batch cut-off time.
Completed	When the processing is complete, the system displays Completed in the status grid, and the date in the Uploaded column becomes a link to a Batch Files Daily Summary report, which is described in Batch File Reports.

Step 8Receive the batch status alerts.

The system sends you an email when batch file validation succeeds or fails and when batch file processing is complete.

You can also view validation files as described in Viewing the Status of Your Batch File Submissions .

Step 9View the reports and response files for your transaction requests:

nAfter all of the requests in a batch file are processed, Cybersource creates the batch reports:

Batch Files Detail Report—shows details of the batched transactions.

See Batch File Reports.

nCapture Detail Report—shows all of the transactions that were submitted to your processor for settlement. You can download the report daily. If the batch file has an error, the file is not processed, and the file’s requests are not included in the report. See the Business Center Reporting User Guide (PDF | HTML).

nResponse files—after Cybersource processes all of the requests in the batch file, Cybersource creates two types of CSV response files that you can use to determine the results of the requests. See Response Files .