Verifi RDR Decision

When an Issuer submits a dispute and the Merchant is enrolled for Rapid Dispute Resolution (RDR) decisioning via the Verifi API, Verifi sends the pre-dispute to the Merchant via HTTP POST call.

RDR Decision Evaluation

post

Evaluates transaction data against merchant RDR rules and returns accept/decline decision for Rapid Dispute Resolution.

Authorizations

Body

decisionIdstring · max: 36Required

ID number generated by Verifi and used for case reference (UUID version 4)

Example: 4ad593b4-e751-4b43-9ade-a9406d1ae2ba

caseTypestring · enum · max: 20Required

Case type for RDR Decision Requests

Example: DISPUTEPossible values:

sourcestring · enum · max: 20Required

Source for RDR Decision Requests

Example: VMPIPossible values:

caseDatestring · date-time · max: 20Required

Date the case was recorded by the system

Example: 2024-05-25T09:17:28Z

paymentDescriptorstring · max: 25Required

The Merchant name component of the billing descriptor which appeared on the customer's transaction statement

Example: ONLINE*MERCHANT

paymentDescriptorContactstring · max: 13Required

The Merchant phone number which appeared on the Cardholder's transaction statement

Example: 3236555789

acquirerBinstring · max: 6Required

Acquiring Bank identifier assigned by Visa

Example: 123121

cardAcceptorIdstring · max: 15Required

Acquirer-assigned identifier of the Merchant account to VisaNet

Example: 1231231

transactionIdstring · max: 15Required

Visa-generated identifier that is unique for each original transaction

Example: 2837347837383

cardBinstring · max: 8Optional

The six or eight-digit card Issuer BIN that is associated with the purchase (conditionally required)

Example: 123121

cardLast4string · max: 4Optional

The last four digits of the card number associated with the purchase (conditionally required)

Example: 2476

tokenstring · max: 19Optional

Token associated with the transaction when a token was used instead of a PAN for payment

Example: 411111xxxxxx1111

paymentTypestring · max: 20Required

Indicates the payment type of the original purchase

Example: VISA

authCodestring · max: 6Required

The Issuer authorization code for the transaction

Example: 300001

ecistring · max: 1Optional

The mail/phone/electronic commerce indicator (Values 1-9)

Example: 7

mcsnstring · max: 2Optional

Multiple Clearing Sequence Number contains a sequence number that distinguishes a specific clearing message

Example: 02

installmentNumberinteger · max: 9999999999Optional

Specific installment number of the transaction (for Parcelado installment transactions)

Example: 3

transactionDatestring · date-time · max: 20Required

Purchase transaction date in UTC format

Example: 2024-07-17T09:17:28Z

arnstring · max: 24Required

Acquirer reference number

Example: 43853968624382884877396

mccstring · max: 4Required

The four-digit number listed in ISO 18245 for retail financial services

Example: 4899Pattern: ^[0-9]{4}$

terminalIdstring · max: 8Optional

Code that identifies a terminal at the card acceptor location

Example: 8mHtZZzK

purchaseIdentifierstring · max: 25Optional

Unique identifier for the order defined by the Merchant

Example: DWZ05549686048

transactionTypestring · max: 20Required

Type of transaction

Example: SALE

reasonCodestring · max: 4Required

Code indicating both Dispute Category and Dispute Condition Code

Example: 12.1

posEntryModeCodestring · max: 2Optional

Identifies the terminal type and terminal entry capability

Example: 06

Responses

200

Decision evaluation completed successfully

application/json

Responseone of

or

400

Bad Request - Missing required fields

application/json

401

Unauthorized - Authentication failed

application/json

500

Internal Server Error

application/json

post

HTTPcURLJavaScriptPython

POST /api/v2/provider/rdr/decisions HTTP/1.1
Host: {baseurl}
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 863

{
  "decisionId": "4ad593b4-e751-4b43-9ade-a9406d1ae2ba",
  "verifiEntityInfo": {
    "partnerId": 10000,
    "clientId": 104297
  },
  "caseType": "DISPUTE",
  "source": "VMPI",
  "caseDate": "2024-05-25T09:17:28Z",
  "paymentDescriptor": "ONLINE*MERCHANT",
  "paymentDescriptorContact": "3236555789",
  "acquirerBin": "123121",
  "cardAcceptorId": "1231231",
  "transactionId": "2837347837383",
  "cardBin": "123121",
  "cardLast4": "2476",
  "token": "411111xxxxxx1111",
  "paymentType": "VISA",
  "authCode": "300001",
  "eci": "7",
  "mcsn": "02",
  "installmentNumber": 3,
  "transactionDate": "2024-07-17T09:17:28Z",
  "transactionAmount": {
    "amount": 15.99,
    "currency": "XAU"
  },
  "destinationAmount": {
    "amount": 10.12,
    "currency": "USD"
  },
  "arn": "43853968624382884877396",
  "mcc": "4899",
  "terminalId": "8mHtZZzK",
  "caseAmount": {
    "amount": 10.12,
    "currency": "USD"
  },
  "purchaseIdentifier": "DWZ05549686048",
  "transactionType": "SALE",
  "reasonCode": "12.1",
  "posEntryModeCode": "06"
}

{
  "outcome": "ACCEPTED",
  "statusCode": "103",
  "reason": "Matched rule: High Value Transaction Rule",
  "refundAmount": {
    "amount": 10.12,
    "currency": "USD"
  }
}