EMS Provider Search

Search from EMS

EMS Provider Search

post

Search for an EMS enabled merchant's transaction details.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

txShieldOICartReferencestringOptional

TxShield OI Reference number

Example: 53b09896-cf5b-405b-88e8-2a0f66c41e04

sourcestringOptional

Source of the transaction.

Example: EMS

cardBinstring · max: 8Optional

The first 6-8 digits card number.

Example: 412345

cardLast4string · max: 4Optional

The last 4 digits card number.

Example: 5678

transactionDatestring · max: 20Optional

Transaction Date formatted in ISO 8601 20 charactor long without milliseconds (Example = YYYY-MM-DDThh:mm:ssZ)

Example: 2024-06-05T00:00:00Z

Responses

200

Response

application/json

400

Error

application/json

401

Unauthorized

application/json

404

Not found

application/json

default

Error Payload

application/json

post

/api/v2/provider/ems/getTransactionDetails

HTTPcURLJavaScriptPython

POST /api/v2/provider/ems/getTransactionDetails HTTP/1.1
Host: {baseUrl}
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 214

{
  "txShieldOICartReference": "53b09896-cf5b-405b-88e8-2a0f66c41e04",
  "source": "EMS",
  "cardBin": "412345",
  "cardLast4": "5678",
  "transactionAmount": {
    "amount": "499",
    "currency": "USD"
  },
  "transactionDate": "2024-06-05T00:00:00Z"
}

[
  {
    "merchantInformation": {
      "merchantContactPhone": "[phone]",
      "storeDetails": {
        "storeName": "Verifi Webstore"
      },
      "merchantUrl": "https://www.verifi.com",
      "merchantName": "Verifi,Inc."
    },
    "receipt": {
      "paymentInformation": {
        "paymentTotalAmount": {
          "amount": 499,
          "currency": "USD"
        }
      },
      "productsPurchasedList": [
        {
          "quantity": 1,
          "deliveryDetails": {
            "shippingCarrier": "UPS",
            "dateOfShipment": "2023-01-27T19:11:28Z",
            "otherStatusDescription": "DELIVERED: Left at front door",
            "trackingNumber": "1Z9999999999999999",
            "dateOfDelivery": "2023-01-29T11:44:00Z",
            "deliveryStatus": "OTHER"
          },
          "creditReimbursementSequenceNumber": 1,
          "unitPriceAmount": {
            "amount": 100.25,
            "currency": "USD"
          },
          "productUrl": "https://www.verifi.com/product/7366",
          "productType": "ELECTRONICS",
          "productDescription": "ABC Smart Watch, Fitness Tracker and Health Monitor",
          "artistOrSeller": "QualityElectronics"
        }
      ]
    },
    "customerInformation": {
      "accountId": "jcustomer"
    },
    "device": {
      "ipAddress": "198.241.10.6",
      "deviceFingerprint": "ace4cb941f15613bdc7e69b28318646915928a6d",
      "deviceId": "576787-7h9y8hf777-88887777hhhhh"
    },
    "deliveryAddress": {
      "address1": "5670 Wilshire Blvd"
    }
  }
]