EMS Provider Search

Search from EMS

EMS Provider Search

post

Search for an EMS enabled merchant's transaction details.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

txShieldOICartReferencestringRequired

TxShield OI Reference number

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

sourcestringRequired

Source of the transaction. Must be "EMS".

Example: EMS

cardBinstring · max: 8Required

The first 6-8 digits card number.

Example: 412345

cardLast4string · max: 4Required

The last 4 digits card number.

Example: 5678

transactionDatestring · max: 20Required

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

and

400

Error

application/json

401

Unauthorized

application/json

403

Forbidden - Merchant not enrolled with EMS service

application/json

404

Not found

application/json

500

Internal Server Error

application/json

post/api/v2/provider/ems/getTransactionDetails

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

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

{
  "merchantId": "merchant-uuid-1234",
  "txShieldOICartReference": "53b09896-cf5b-405b-88e8-2a0f66c41e04",
  "paymentType": "CREDIT",
  "paymentDescriptor": "ACME STORE",
  "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"
  }
}