Submit an event payload for fraud screening

POST /create

Submit an event payload for fraud screening

cURL

curl --request POST \
  --url https://live.voora.ai/event/create \
  --header 'Content-Type: application/json' \
  --header 'X-CLIENT-API-KEY: <api-key>' \
  --data '
{
  "id": "<string>",
  "eventType": "<string>",
  "eventAmount": 123,
  "eventCurrency": "<string>",
  "cardHolder": "<string>",
  "cardBin": "<string>",
  "cardHash": "<string>",
  "cardLast": "<string>",
  "cardExpiry": "<string>",
  "userIp": "<string>",
  "userEmail": "<string>",
  "userPhoneNumber": "<string>",
  "userFullName": "<string>",
  "userFirstName": "<string>",
  "userLastName": "<string>",
  "userDob": "<string>",
  "userPob": "<string>",
  "userId": "<string>",
  "userName": "<string>",
  "userCreated": "<string>",
  "userCountry": "<string>",
  "userCity": "<string>",
  "userRegion": "<string>",
  "userZip": "<string>",
  "userStreet1": "<string>",
  "userStreet2": "<string>",
  "shippingCountry": "<string>",
  "shippingCity": "<string>",
  "shippingRegion": "<string>",
  "shippingZip": "<string>",
  "shippingStreet1": "<string>",
  "shippingStreet2": "<string>",
  "shippingPhone": "<string>",
  "shippingFullName": "<string>",
  "billingCountry": "<string>",
  "billingCity": "<string>",
  "billingRegion": "<string>",
  "billingZip": "<string>",
  "billingStreet1": "<string>",
  "billingStreet2": "<string>",
  "billingPhone": "<string>",
  "eventDate": "<string>",
  "browserUserAgent": "<string>",
  "items": [
    {
      "itemId": "<string>",
      "itemName": "<string>",
      "itemQuantity": 123,
      "itemPrice": 123,
      "itemCategory": "<string>",
      "itemSeller": "<string>",
      "itemSellerCountry": "<string>"
    }
  ]
}
'

import requests

url = "https://live.voora.ai/event/create"

payload = {
    "id": "<string>",
    "eventType": "<string>",
    "eventAmount": 123,
    "eventCurrency": "<string>",
    "cardHolder": "<string>",
    "cardBin": "<string>",
    "cardHash": "<string>",
    "cardLast": "<string>",
    "cardExpiry": "<string>",
    "userIp": "<string>",
    "userEmail": "<string>",
    "userPhoneNumber": "<string>",
    "userFullName": "<string>",
    "userFirstName": "<string>",
    "userLastName": "<string>",
    "userDob": "<string>",
    "userPob": "<string>",
    "userId": "<string>",
    "userName": "<string>",
    "userCreated": "<string>",
    "userCountry": "<string>",
    "userCity": "<string>",
    "userRegion": "<string>",
    "userZip": "<string>",
    "userStreet1": "<string>",
    "userStreet2": "<string>",
    "shippingCountry": "<string>",
    "shippingCity": "<string>",
    "shippingRegion": "<string>",
    "shippingZip": "<string>",
    "shippingStreet1": "<string>",
    "shippingStreet2": "<string>",
    "shippingPhone": "<string>",
    "shippingFullName": "<string>",
    "billingCountry": "<string>",
    "billingCity": "<string>",
    "billingRegion": "<string>",
    "billingZip": "<string>",
    "billingStreet1": "<string>",
    "billingStreet2": "<string>",
    "billingPhone": "<string>",
    "eventDate": "<string>",
    "browserUserAgent": "<string>",
    "items": [
        {
            "itemId": "<string>",
            "itemName": "<string>",
            "itemQuantity": 123,
            "itemPrice": 123,
            "itemCategory": "<string>",
            "itemSeller": "<string>",
            "itemSellerCountry": "<string>"
        }
    ]
}
headers = {
    "X-CLIENT-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-CLIENT-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: '<string>',
    eventType: '<string>',
    eventAmount: 123,
    eventCurrency: '<string>',
    cardHolder: '<string>',
    cardBin: '<string>',
    cardHash: '<string>',
    cardLast: '<string>',
    cardExpiry: '<string>',
    userIp: '<string>',
    userEmail: '<string>',
    userPhoneNumber: '<string>',
    userFullName: '<string>',
    userFirstName: '<string>',
    userLastName: '<string>',
    userDob: '<string>',
    userPob: '<string>',
    userId: '<string>',
    userName: '<string>',
    userCreated: '<string>',
    userCountry: '<string>',
    userCity: '<string>',
    userRegion: '<string>',
    userZip: '<string>',
    userStreet1: '<string>',
    userStreet2: '<string>',
    shippingCountry: '<string>',
    shippingCity: '<string>',
    shippingRegion: '<string>',
    shippingZip: '<string>',
    shippingStreet1: '<string>',
    shippingStreet2: '<string>',
    shippingPhone: '<string>',
    shippingFullName: '<string>',
    billingCountry: '<string>',
    billingCity: '<string>',
    billingRegion: '<string>',
    billingZip: '<string>',
    billingStreet1: '<string>',
    billingStreet2: '<string>',
    billingPhone: '<string>',
    eventDate: '<string>',
    browserUserAgent: '<string>',
    items: [
      {
        itemId: '<string>',
        itemName: '<string>',
        itemQuantity: 123,
        itemPrice: 123,
        itemCategory: '<string>',
        itemSeller: '<string>',
        itemSellerCountry: '<string>'
      }
    ]
  })
};

fetch('https://live.voora.ai/event/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://live.voora.ai/event/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => '<string>',
    'eventType' => '<string>',
    'eventAmount' => 123,
    'eventCurrency' => '<string>',
    'cardHolder' => '<string>',
    'cardBin' => '<string>',
    'cardHash' => '<string>',
    'cardLast' => '<string>',
    'cardExpiry' => '<string>',
    'userIp' => '<string>',
    'userEmail' => '<string>',
    'userPhoneNumber' => '<string>',
    'userFullName' => '<string>',
    'userFirstName' => '<string>',
    'userLastName' => '<string>',
    'userDob' => '<string>',
    'userPob' => '<string>',
    'userId' => '<string>',
    'userName' => '<string>',
    'userCreated' => '<string>',
    'userCountry' => '<string>',
    'userCity' => '<string>',
    'userRegion' => '<string>',
    'userZip' => '<string>',
    'userStreet1' => '<string>',
    'userStreet2' => '<string>',
    'shippingCountry' => '<string>',
    'shippingCity' => '<string>',
    'shippingRegion' => '<string>',
    'shippingZip' => '<string>',
    'shippingStreet1' => '<string>',
    'shippingStreet2' => '<string>',
    'shippingPhone' => '<string>',
    'shippingFullName' => '<string>',
    'billingCountry' => '<string>',
    'billingCity' => '<string>',
    'billingRegion' => '<string>',
    'billingZip' => '<string>',
    'billingStreet1' => '<string>',
    'billingStreet2' => '<string>',
    'billingPhone' => '<string>',
    'eventDate' => '<string>',
    'browserUserAgent' => '<string>',
    'items' => [
        [
                'itemId' => '<string>',
                'itemName' => '<string>',
                'itemQuantity' => 123,
                'itemPrice' => 123,
                'itemCategory' => '<string>',
                'itemSeller' => '<string>',
                'itemSellerCountry' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-CLIENT-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://live.voora.ai/event/create"

	payload := strings.NewReader("{\n  \"id\": \"<string>\",\n  \"eventType\": \"<string>\",\n  \"eventAmount\": 123,\n  \"eventCurrency\": \"<string>\",\n  \"cardHolder\": \"<string>\",\n  \"cardBin\": \"<string>\",\n  \"cardHash\": \"<string>\",\n  \"cardLast\": \"<string>\",\n  \"cardExpiry\": \"<string>\",\n  \"userIp\": \"<string>\",\n  \"userEmail\": \"<string>\",\n  \"userPhoneNumber\": \"<string>\",\n  \"userFullName\": \"<string>\",\n  \"userFirstName\": \"<string>\",\n  \"userLastName\": \"<string>\",\n  \"userDob\": \"<string>\",\n  \"userPob\": \"<string>\",\n  \"userId\": \"<string>\",\n  \"userName\": \"<string>\",\n  \"userCreated\": \"<string>\",\n  \"userCountry\": \"<string>\",\n  \"userCity\": \"<string>\",\n  \"userRegion\": \"<string>\",\n  \"userZip\": \"<string>\",\n  \"userStreet1\": \"<string>\",\n  \"userStreet2\": \"<string>\",\n  \"shippingCountry\": \"<string>\",\n  \"shippingCity\": \"<string>\",\n  \"shippingRegion\": \"<string>\",\n  \"shippingZip\": \"<string>\",\n  \"shippingStreet1\": \"<string>\",\n  \"shippingStreet2\": \"<string>\",\n  \"shippingPhone\": \"<string>\",\n  \"shippingFullName\": \"<string>\",\n  \"billingCountry\": \"<string>\",\n  \"billingCity\": \"<string>\",\n  \"billingRegion\": \"<string>\",\n  \"billingZip\": \"<string>\",\n  \"billingStreet1\": \"<string>\",\n  \"billingStreet2\": \"<string>\",\n  \"billingPhone\": \"<string>\",\n  \"eventDate\": \"<string>\",\n  \"browserUserAgent\": \"<string>\",\n  \"items\": [\n    {\n      \"itemId\": \"<string>\",\n      \"itemName\": \"<string>\",\n      \"itemQuantity\": 123,\n      \"itemPrice\": 123,\n      \"itemCategory\": \"<string>\",\n      \"itemSeller\": \"<string>\",\n      \"itemSellerCountry\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-CLIENT-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://live.voora.ai/event/create")
  .header("X-CLIENT-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": \"<string>\",\n  \"eventType\": \"<string>\",\n  \"eventAmount\": 123,\n  \"eventCurrency\": \"<string>\",\n  \"cardHolder\": \"<string>\",\n  \"cardBin\": \"<string>\",\n  \"cardHash\": \"<string>\",\n  \"cardLast\": \"<string>\",\n  \"cardExpiry\": \"<string>\",\n  \"userIp\": \"<string>\",\n  \"userEmail\": \"<string>\",\n  \"userPhoneNumber\": \"<string>\",\n  \"userFullName\": \"<string>\",\n  \"userFirstName\": \"<string>\",\n  \"userLastName\": \"<string>\",\n  \"userDob\": \"<string>\",\n  \"userPob\": \"<string>\",\n  \"userId\": \"<string>\",\n  \"userName\": \"<string>\",\n  \"userCreated\": \"<string>\",\n  \"userCountry\": \"<string>\",\n  \"userCity\": \"<string>\",\n  \"userRegion\": \"<string>\",\n  \"userZip\": \"<string>\",\n  \"userStreet1\": \"<string>\",\n  \"userStreet2\": \"<string>\",\n  \"shippingCountry\": \"<string>\",\n  \"shippingCity\": \"<string>\",\n  \"shippingRegion\": \"<string>\",\n  \"shippingZip\": \"<string>\",\n  \"shippingStreet1\": \"<string>\",\n  \"shippingStreet2\": \"<string>\",\n  \"shippingPhone\": \"<string>\",\n  \"shippingFullName\": \"<string>\",\n  \"billingCountry\": \"<string>\",\n  \"billingCity\": \"<string>\",\n  \"billingRegion\": \"<string>\",\n  \"billingZip\": \"<string>\",\n  \"billingStreet1\": \"<string>\",\n  \"billingStreet2\": \"<string>\",\n  \"billingPhone\": \"<string>\",\n  \"eventDate\": \"<string>\",\n  \"browserUserAgent\": \"<string>\",\n  \"items\": [\n    {\n      \"itemId\": \"<string>\",\n      \"itemName\": \"<string>\",\n      \"itemQuantity\": 123,\n      \"itemPrice\": 123,\n      \"itemCategory\": \"<string>\",\n      \"itemSeller\": \"<string>\",\n      \"itemSellerCountry\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://live.voora.ai/event/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-CLIENT-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": \"<string>\",\n  \"eventType\": \"<string>\",\n  \"eventAmount\": 123,\n  \"eventCurrency\": \"<string>\",\n  \"cardHolder\": \"<string>\",\n  \"cardBin\": \"<string>\",\n  \"cardHash\": \"<string>\",\n  \"cardLast\": \"<string>\",\n  \"cardExpiry\": \"<string>\",\n  \"userIp\": \"<string>\",\n  \"userEmail\": \"<string>\",\n  \"userPhoneNumber\": \"<string>\",\n  \"userFullName\": \"<string>\",\n  \"userFirstName\": \"<string>\",\n  \"userLastName\": \"<string>\",\n  \"userDob\": \"<string>\",\n  \"userPob\": \"<string>\",\n  \"userId\": \"<string>\",\n  \"userName\": \"<string>\",\n  \"userCreated\": \"<string>\",\n  \"userCountry\": \"<string>\",\n  \"userCity\": \"<string>\",\n  \"userRegion\": \"<string>\",\n  \"userZip\": \"<string>\",\n  \"userStreet1\": \"<string>\",\n  \"userStreet2\": \"<string>\",\n  \"shippingCountry\": \"<string>\",\n  \"shippingCity\": \"<string>\",\n  \"shippingRegion\": \"<string>\",\n  \"shippingZip\": \"<string>\",\n  \"shippingStreet1\": \"<string>\",\n  \"shippingStreet2\": \"<string>\",\n  \"shippingPhone\": \"<string>\",\n  \"shippingFullName\": \"<string>\",\n  \"billingCountry\": \"<string>\",\n  \"billingCity\": \"<string>\",\n  \"billingRegion\": \"<string>\",\n  \"billingZip\": \"<string>\",\n  \"billingStreet1\": \"<string>\",\n  \"billingStreet2\": \"<string>\",\n  \"billingPhone\": \"<string>\",\n  \"eventDate\": \"<string>\",\n  \"browserUserAgent\": \"<string>\",\n  \"items\": [\n    {\n      \"itemId\": \"<string>\",\n      \"itemName\": \"<string>\",\n      \"itemQuantity\": 123,\n      \"itemPrice\": 123,\n      \"itemCategory\": \"<string>\",\n      \"itemSeller\": \"<string>\",\n      \"itemSellerCountry\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

200

{
  "id": "<string>",
  "eventId": "<string>",
  "actionType": "<string>",
  "totalRiskScore": 123,
  "appliedRulesDetails": [
    {
      "ruleId": "<string>",
      "score": 123,
      "ruleName": "<string>"
    }
  ],
  "denylistMatches": [
    "<string>"
  ],
  "allowlistMatches": [
    "<string>"
  ]
}

{
  "requestId": "<string>",
  "errorType": "<string>",
  "errorCodes": [
    "<string>"
  ]
}

{
  "requestId": "<string>",
  "errorType": "<string>",
  "errorCodes": [
    "<string>"
  ]
}

{
  "requestId": "<string>",
  "errorType": "<string>",
  "errorCodes": [
    "<string>"
  ]
}

{
  "requestId": "<string>",
  "errorType": "<string>",
  "errorCodes": [
    "<string>"
  ]
}

{
  "requestId": "<string>",
  "errorType": "<string>",
  "errorCodes": [
    "<string>"
  ]
}

{
  "requestId": "<string>",
  "errorType": "<string>",
  "errorCodes": [
    "<string>"
  ]
}

Authorizations

X-CLIENT-API-KEY · string · header · required

API key required in header: X-CLIENT-API-KEY

Body

application/jsontext/jsonapplication/*+json

id · string | null

eventType · string | null

eventAmount · number<double> | null

eventCurrency · string | null

cardHolder · string | null

cardBin · string | null

cardHash · string | null

cardLast · string | null

cardExpiry · string | null

userIp · string | null

userEmail · string | null

userPhoneNumber · string | null

userFullName · string | null

userFirstName · string | null

userLastName · string | null

userDob · string | null

userPob · string | null

userId · string | null

userName · string | null

userCreated · string | null

userCountry · string | null

userCity · string | null

userRegion · string | null

userZip · string | null

userStreet1 · string | null

userStreet2 · string | null

shippingCountry · string | null

shippingCity · string | null

shippingRegion · string | null

shippingZip · string | null

shippingStreet1 · string | null

shippingStreet2 · string | null

shippingPhone · string | null

shippingFullName · string | null

billingCountry · string | null

billingCity · string | null

billingRegion · string | null

billingZip · string | null

billingStreet1 · string | null

billingStreet2 · string | null

billingPhone · string | null

eventDate · string | null

browserUserAgent · string | null

items · object[] | null

Show child attributes

Response

200

application/json

OK

id · string | null

Id provided by customer

eventId · string | null

A unique identifier generated by StrongHold api

actionType · string | null

Event state, which indicates the further action. State can be either APPROVE, REVIEW or DECLINE

totalRiskScore · integer<int32>

A score from 0-100 indicating the likelihood that a event is fraudulent.

appliedRulesDetails · object[] | null

Show child attributes

denylistMatches · string[] | null

allowlistMatches · string[] | null