Skip to main content

Query

The Transaction Query API can be used to determine the processing status of a transaction or to retrieve the lifecycle of a transaction. This API can be used to check whether a PullFunds, PushFunds, or ReverseFunds transaction was successfully processed by Visa.

Endpoint

http://localhost:4041/rpc/VisaDirectService/Query

Method

POST

Request

Payload Parameters
ParameterTypeDescription
acquiringBINIntegerThe Bank Identification Number (BIN) under which the Visa Direct solution is registered.
caidStringAn identifier for the card acceptor.
fieldsStringComma-separated list of additional fields requestor would like in response (e.g., amount, responseCode).
limitIntegerNumber of records to return, if there are multiple records. Useful for pagination.
offsetIntegerStarting record number from where to return records. Useful for pagination.
requestTypeStringThis parameter will contain the deferred OCT request type.
rrnStringA value used to tie together service calls related to a single financial transaction.
stanIntegerA number assigned by the message initiator that uniquely identifies a transaction.
transactionEndDateStringThe end date for querying the transaction.
transactionIdentifierStringThe VisaNet reference number for the transaction.
transactionStartDateStringThe start date for querying the transaction.

Sample Request

{
"acquiringBIN": 40899,
"transactionIdentifier": "115906727920934"
}

Sample Response

[
{
"transactionType": "SALES DRAFT",
"systemsTraceAuditNumber": "952909",
"approvalCode": "002798",
"transactionIdentifier": "388234793890020",
"actionCode": "00",
"acquiringBin": "408999",
"retrievalReferenceNumber": "823410000885",
"transactionDate": "22-08-2018",
"transactionTime": "22:03:09",
"statusCode": "COMPLETED",
"responseCode": "4"
},
{
"transactionType": "SALES DRAFT",
"systemsTraceAuditNumber": "952909",
"approvalCode": "002798",
"originalActionCode": "00",
"transactionIdentifier": "388234793890020",
"actionCode": "94",
"acquiringBin": "408999",
"retrievalReferenceNumber": "823410000885",
"transactionDate": "22-08-2018",
"transactionTime": "22:03:09",
"statusCode": "COMPLETED",
"responseCode": "4"
},
{
"transactionType": "SALES REVERSAL",
"systemsTraceAuditNumber": "952909",
"approvalCode": "002798",
"transactionIdentifier": "388234793890020",
"actionCode": "00",
"acquiringBin": "408999",
"retrievalReferenceNumber": "823410000885",
"transactionDate": "22-08-2018",
"transactionTime": "22:03:09",
"statusCode": "COMPLETED",
"responseCode": "C"
}
]