Reverse Funds Transaction

The Reverse Funds Transaction API is used to create a reverse funds transaction.

---

Endpoint

Method: POST
URL: http://localhost:4041/rpc/VisaDirectService/Reverse

---

Request

Payload Parameters

Parameter	Type	Description
acquirerCountryCode	Integer (Mandatory)	3-digit numeric country code for the BIN country under Visa Direct registration.
acquiringBin	Integer (Mandatory)	Bank Identification Number (BIN) under which Visa Direct is registered.
amount	Float (Mandatory)	Total amount to be sent to the recipient.
businessApplicationId	String (Mandatory)	Identifies the program's business application type for VisaNet transaction processing.
cardAcceptor	Object	Contains details of the card acceptor.
cardAcceptor.address	Object	Address details of the card acceptor.
cardAcceptor.address.country	String (Mandatory)	Country of the card acceptor (should match the original transaction).
cardAcceptor.address.county	String (Mandatory)	County of the card acceptor.
cardAcceptor.address.state	String (Mandatory)	State of the card acceptor.
cardAcceptor.address.zipCode	String (Mandatory)	Zipcode of the card acceptor.
cardAcceptor.idCode	String (Mandatory)	Unique identifier for the card acceptor.
cardAcceptor.name	String (Mandatory)	Name of the card acceptor.
cardAcceptor.terminalId	String (Mandatory)	Terminal identifier at the card acceptor location.
localTransactionDateTime	String	Local transaction date and time.
retrievalReferenceNumber	String (Mandatory)	Used to tie together service calls related to a single financial transaction.
senderCurrencyCode	String (Mandatory)	3-character currency code of the sender.
senderPrimaryAccountNumber	String (Mandatory)	Primary account number of the sender.
systemTraceAuditNumber	Integer (Mandatory)	Unique value used for each API method.
transactionIdentifier	Integer (Mandatory)	VisaNet reference number for the transaction.
senderCardExpiryDate	String (Mandatory)	Expiration date of the sender’s Visa account.
serviceProcessingType	Object	Contains processing type details.
serviceProcessingType.requestType	String	Reserved for future use.
settlementServiceIndicator	Integer (Mandatory)	Flag enabling the originator to request a settlement service.
visaMerchantIdentifier	String	Visa Merchant Identifier assigned by Visa.
programId	String	Tenant ID for the bank.
endToEndId	String	Unique ID tracking transaction from end to end.
referenceNumber	String	Unique reference number assigned to the transaction.

---

Sample Request

{
  "amount": "124.02",
  "pointOfServiceData": {
    "panEntryMode": "90",
    "posConditionCode": "00",
    "motoECIIndicator": "0"
  },
  "cardAcceptor": {
    "address": {
      "country": "USA",
      "zipCode": "94404",
      "county": "San Mateo",
      "state": "CA"
    },
    "idCode": "VMT200911026070",
    "name": "Visa Inc. USA-Foster City",
    "terminalId": "365539"
  },
  "transactionIdentifier": "159032109605920",
  "acquirerCountryCode": "840",
  "acquiringBin": "408999",
  "senderCurrencyCode": "USD",
  "retrievalReferenceNumber": "330000550013",
  "systemsTraceAuditNumber": "452012",
  "businessApplicationId": "AA",
  "senderPrimaryAccountNumber": "4104920120500001",
  "settlementServiceIndicator": "9",
  "senderCardExpiryDate": "2023-10"
}

Sample Response

{
  "actionCode": "00",
  "responseCode": "V",
  "transactionIdentifier": "134313546834208",
  "transmissionDateTime": "2024-08-05T10:01:03.000Z",
  "approvalCode": "98765X"
}