Creating a Request With a Client Application

The client uses a GET method to retrieve the batch statuses. To send the request, the header must contain an authorization token and the format for the file you want to download. For information and instructions on creating an authorization token, refer to Getting Started with the REST API.

Client Application Requirements

To connect to the server, your client application must support HTTPS connections. An HTTPS connection is similar to an HTTP connection, but it is encrypted by using Transport Layer Security (TLS). Your client application must support HTTP/1.1 and TLS 1.2 connections.

HTTPS libraries are available for many programming languages, including Java, C/C++, Perl, and Visual Basic. You can implement a client in any language that allows you to use HTTPS to communicate with the report server.

IMPORTANT

Although you may be able to use a third-party client application to download Visa Acceptance Solutions reports, Visa Acceptance Solutions does not recommend or support third-party client applications or client libraries that may interfere with Visa Acceptance Solutions applications.

Request Format

To create a request, your client application must send an HTTP GET message to the server. The URL that you specify in your message indicates which function you are calling and the parameters of the call:

https://< url_prefix>/ pts/ v1/ transaction-batches/

Request Header

The default format for responses is JSON, but the Batch Detail Report can also return CSV or XML. You can set the response to return CSV or XML in the request header by setting the

Accept

value to either

application/xml

or

text/csv

.

Transaction Batch API

Retrieve a List of Batch Files

For a list of batch files, the request format is:

GET https://<url_prefix>/pts/v1/transaction-batches&startTime={startTime}&endTime={endTime}

Batch File Summary URL Values
Value	Description	Required/Optional
< `url_prefix`>	Name of the server from which to download the report. Use one of these values: Production: `api.visaacceptance.com` Test: `apitest.visaacceptance.com`	Required
< `startTime`>	Report start date to search on in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSSZ). Example: 2019-05-01T12:00:00-05:00	Required
< `endTime`>	Report end date to search on in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSSZ). Example: 2019-08-30T12:00:00-05:00	Required

Responses

This call can return one of the following HTTP status codes:

200: Ok.

400: Invalid request.

401: Not authorized.

403: Not authenticated.

404: Report not found or no transactions are available.

500: Bad Gateway.

For detailed information on the responses, including which fields are returned, see the Reporting REST API Reference..

Transaction Batch API

Retrieve a Specific Transaction Batch File

To retrieve a specific transaction batch, the request format is:

GET https://<url_prefix>/pts/v1/transaction-batches/{id}

Transaction Batch File Definition URL Values
Value	Description	Required/Optional
< `url_prefix`>	Name of the server from which to download the report. Use one of these values: Production: `api.visaacceptance.com` Test: `apitest.visaacceptance.com`	Required
< `id`>	Unique ID assigned to a batch upload file.	Required

Responses

This call can return one of the following HTTP status codes:

200: Ok.

400: Invalid request.

401: Not authorized.

403: Not authenticated.

404: Report not found or no transactions are available.

500: Bad Gateway.

For detailed information on the responses, including which fields are returned, see the Reporting REST API Reference..

Transaction Batch API

Retrieve Batch Submission Detail Report

The Batch Submission Detail Report provides real-time detailed status information about the transactions that you previously uploaded in the Business Center or processed with the Offline Transaction File Submission service. The default format for responses is JSON, but the Batch Submission Detail Report can also return CSV or XML. You can set the response to return CSV or XML in the request header by setting the

Accept

value to either

application/xml

or

text/csv

.

To request the report, your client application must send an HTTP GET message to the report server. Format the URL as follows:

https://<url_prefix>/pts/v1/transaction-batch-details/{id}

Transaction Batch File Definition URL Values
Value	Description	Required/Optional
< `url_prefix`>	Name of the server from which to download the report. Use one of these values: Production: `api.visaacceptance.com` Test: `apitest.visaacceptance.com`	Required
< `id`>	Unique ID assigned to a batch upload file.	Required

Responses

This call can return one of the following HTTP status codes:

200: Ok.

400: Invalid request.

401: Not authorized.

403: Not authenticated.

404: Report not found or no transactions are available.

500: Bad Gateway.

For detailed information on the responses, including which fields are returned, see the Reporting REST API Reference..

Transaction Batch API