Lookup

POST api.ravelin.com/v2/lookup

timestamp integer
required

The unix time in seconds that the event happened

email object
optional

The email address associated with the identified fraud.

Show definition
telephone object
optional

The telephone number associated with the identified fraud.

Show definition
ipAddress object
optional

The IP address associated with the identified fraud.

Show definition
paymentMethod object
optional

The payment method associated with the identified fraud. Only one of instrumentId, payerId or bankId can be provided.

One of the following:
Show definition
chargebacks array
optional
Show definition
manualReviews array
optional
Show definition
POST /v2/lookup HTTP/1.1
Authorization: token ...
Content-Type: application/json

{
  "timestamp": 1479231064,
  "email": {
    "address": "review@example.com",
    "verified": true,
    "timestamp": 1479231064
  },
  "telephone": {
    "number": "+442222222222",
    "countryCode": "GB",
    "verified": true,
    "timestamp": 1479231064
  },
  "ipAddress": {
    "address": "33.33.33.33",
    "timestamp": 1479231064
  },
  "paymentMethod": {
    "instrumentId": "ljkvel433-34t3g5-4334g3g",
    "timestamp": 1479231064
  },
  "chargebacks": [
    {
      "chargebackId": "dp_15RsQX2eZvKYlo2C0MFNUWJC",
      "gateway": "stripe",
      "gatewayReference": "tx_abc123",
      "customerId": "9307355",
      "reason": "general",
      "status": "lost",
      "amount": 195,
      "currency": "USD",
      "disputeTime": 1422915137
    }
  ],
  "manualReviews": [
    {
      "reviewId": "12345678",
      "comment": "Definitely a fraudster.",
      "customerId": "9307355",
      "reviewer": {
        "name": "tom@mycompany.com",
        "email": "Tom"
      },
      "timestamp": 1486387634000
    }
  ]
}

GET api.ravelin.com/v2/lookup

Query Parameters:

  • email
  • telephone
  • ipAddress
  • ipFromTime
  • instrumentId
  • limitIndustry

DELETE api.ravelin.com/v2/lookup

Query Parameters:

  • email
  • telephone
  • ipAddress

Feedback

© Ravelin Technology Ltd. All rights reserved