Verifi Provider Search

POST https://uat-txfind.payshield.ai/api/v2/provider/verifi/orders

Request Body

Verifi V3 Provider Search

Search for an Verifi V3 enabled merchant's transaction details.

post

/api/v2/provider/verifi/orders

Authorizations

Body

insightIdstring · max: 36

Verifi's unique identifier for the Order Insight request to the network Format = UUID version 3.

Example: 451307df-137b-476c-b5d3-4022df881548

verifiEntityInfoobject

Information related to partners and clients in the Verifi system.

sourcestring · max: 3

Identifies the source of the Order Lookup Request.

Example: OID

cardBinstring · max: 8

The six or eight-digit card Issuer BIN associated with the purchase.

Example: 111111

cardLast4string · max: 4

The six or eight-digit card Issuer BIN associated with the purchase.

Example: 9854

paymentTypestring · max: 20

Indicates the payment type of the original purchase.

Example: string

paymentDescriptorstring · max: 25

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

Example: string

transactionDatestring · date · max: 20

ISO 8601 string format without milliseconds (Example = YYYY-MM-DDThh:mm:ssZ).

Example: 2023-10-11T04:00:00Z

transactionAmountobject

Transaction Amount Object.

transactionRequestIdstring · max: 36

Not a unique value, this is a hashed value based on key input fields used to locate a previous request with the same key input fields.

Example: 82ce1744-2a85-347c-bd86-6a370d756d24

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '//api/v2/provider/verifi/orders' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "insightId": "451307df-137b-476c-b5d3-4022df881548",
    "verifiEntityInfo": {
      "partnerId": 1234567890,
      "clientId": 987654321
    },
    "source": "OID",
    "cardBin": "111111",
    "cardLast4": "9854",
    "paymentType": "string",
    "paymentDescriptor": "string",
    "transactionDate": "2023-10-11T04:00:00Z",
    "transactionAmount": {
      "amount": 125.5,
      "currency": "USD"
    },
    "transactionRequestId": "82ce1744-2a85-347c-bd86-6a370d756d24"
  }'

200

400

401

404

default

200

{
  "merchantInformation": {
    "merchantContactPhone": "[phone]",
    "storeDetails": {
      "storeName": "Verifi Webstore"
    },
    "merchantUrl": "https://www.verifi.com",
    "merchantName": "Verifi, Inc."
  },
  "receipt": {
    "paymentInformation": {
      "paymentTaxDescription": "CA state 8%",
      "paymentTotalAmount": {
        "amount": 499,
        "currency": "USD"
      }
    },
    "productsPurchasedList": [
      {
        "quantity": 1,
        "deliveryDetails": {
          "shippingCarrier": "UPS",
          "dateOfShipment": "2023-01-27T19:11:28Z",
          "trackingNumber": "9Z99999999944444",
          "dateOfDelivery": "2023-01-30T19:11:28Z",
          "deliveryStatus": "DELIVERED"
        },
        "unitPriceAmount": {
          "amount": 147.25,
          "currency": "USD"
        },
        "productUrl": "https://www.verifi.com/product/3737",
        "productType": "TOOLS",
        "productDescription": "Mini Wood Chipper, 7 HP 212cc Gasoline Engine, 3in Max Diameter",
        "artistOrSeller": "BestSupplier"
      }
    ]
  }
}

Response

Name	Type	Description
insightId	String	"Please add the description here"
verifiEntityInfo	JSON	"Please add the description here"
verifiEntityInfo.partnerId	Number	"Please add the description here" NOTE: This field is inside the verifiEntityInfo JSON
verifiEntityInfo.clientId	Number	"Please add the description here" NOTE: This field is inside the verifiEntityInfo JSON
paymentType	String	"Please add the description here"
paymentDescriptor	String	"Please add the description here"
transactionDate	Datetime	"Please add the description here" NOTE: Format should be in ISO 8601
transactionAmount	JSON	"Please add the description here"
transactionAmount.amount	Number	"Please add the description here" NOTE: This field is inside the transactionAmount JSON
transactionAmount.currency	String	"Please add the description here" NOTE: This field is inside the transactionAmount JSON
cardLast4	String	The last 4 digits of the card number associated with the purchase.
cardBin	String	The six-digit card Issuer BIN associated with the purchase.
transactionRequestId	String	The hash value based on key input fields used to locate a previous request with the same key input fields. Format: UUID version 3
source	String	Identifies the source of the Order Request: Order Insight request from an Issuer via a Portal or API request (OrderInsight OIP), Order Insight request from a Cardholder via an Issuer Mobile Application or Digital Channel (Order Insight Digital OIM). Enumerated values: OIP, OIM