Skip to main content
POST
/
api
/
v3
/
transmon
/
transaction
Send transaction event
curl --request POST \
  --url https://api.dataspike.io/api/v3/transmon/transaction \
  --header 'Content-Type: application/json' \
  --header 'ds-api-token: <api-key>' \
  --data '
{
  "applicant_id": "f81d4fae-7dec-11d0-a765-00a0c91e6bf6",
  "payor_account_id": "b902387378291k22",
  "payor_country_cd": "US",
  "payee_entity_id": "xf9-8209-dt7",
  "payee_account_id": "z8739nm992002653721234",
  "payee_country_cd": "US",
  "user_ip_address": "27.134.25.17",
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:126.0) Gecko/20100101 Firefox/126.0",
  "user_device_id": "nmljasfdKsed8keM#@2k",
  "session_id": "nsd,fhj734Mdksllew898233hhssa",
  "channel": "web",
  "session_duration": 86400,
  "session_login_name": "myverynicelogin",
  "session_step_up_auth_ind": false,
  "user_email_address": "myverynicelogin@example.com",
  "user_phone_number": "+1 123 456-898-87",
  "user_ds_registration": 3,
  "user_initial_risk_score": 15,
  "user_current_risk_score": 27,
  "transaction_type": "CNP",
  "routing_type": "IBAN",
  "routing_number": "a1209234883452370937",
  "currency_code": "EUR",
  "amount": "560.00",
  "account_available_balance": "1122.86",
  "ds_payee_first_transaction": 15,
  "payor_zip": "27315",
  "payor_state": "NC",
  "payor_city": "Anytown",
  "payor_address_line_1": "8247 Christopher Mountains Apt. 462",
  "ds_account_open_date": 7,
  "ds_payor_info_updated": 10,
  "payee_zip": "27315",
  "payee_state": "NC",
  "payee_city": "Anytown",
  "payee_address_line_1": "8247 Christopher Mountains Apt. 462",
  "payee_bank": "Citibank",
  "ds_payee_info_updated": 8,
  "payee_alias": "John Doe"
}
'
import requests

url = "https://api.dataspike.io/api/v3/transmon/transaction"

payload = {
    "applicant_id": "f81d4fae-7dec-11d0-a765-00a0c91e6bf6",
    "payor_account_id": "b902387378291k22",
    "payor_country_cd": "US",
    "payee_entity_id": "xf9-8209-dt7",
    "payee_account_id": "z8739nm992002653721234",
    "payee_country_cd": "US",
    "user_ip_address": "27.134.25.17",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:126.0) Gecko/20100101 Firefox/126.0",
    "user_device_id": "nmljasfdKsed8keM#@2k",
    "session_id": "nsd,fhj734Mdksllew898233hhssa",
    "channel": "web",
    "session_duration": 86400,
    "session_login_name": "myverynicelogin",
    "session_step_up_auth_ind": False,
    "user_email_address": "myverynicelogin@example.com",
    "user_phone_number": "+1 123 456-898-87",
    "user_ds_registration": 3,
    "user_initial_risk_score": 15,
    "user_current_risk_score": 27,
    "transaction_type": "CNP",
    "routing_type": "IBAN",
    "routing_number": "a1209234883452370937",
    "currency_code": "EUR",
    "amount": "560.00",
    "account_available_balance": "1122.86",
    "ds_payee_first_transaction": 15,
    "payor_zip": "27315",
    "payor_state": "NC",
    "payor_city": "Anytown",
    "payor_address_line_1": "8247 Christopher Mountains Apt. 462",
    "ds_account_open_date": 7,
    "ds_payor_info_updated": 10,
    "payee_zip": "27315",
    "payee_state": "NC",
    "payee_city": "Anytown",
    "payee_address_line_1": "8247 Christopher Mountains Apt. 462",
    "payee_bank": "Citibank",
    "ds_payee_info_updated": 8,
    "payee_alias": "John Doe"
}
headers = {
    "ds-api-token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)
const options = {
  method: 'POST',
  headers: {'ds-api-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    applicant_id: 'f81d4fae-7dec-11d0-a765-00a0c91e6bf6',
    payor_account_id: 'b902387378291k22',
    payor_country_cd: 'US',
    payee_entity_id: 'xf9-8209-dt7',
    payee_account_id: 'z8739nm992002653721234',
    payee_country_cd: 'US',
    user_ip_address: '27.134.25.17',
    user_agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:126.0) Gecko/20100101 Firefox/126.0',
    user_device_id: 'nmljasfdKsed8keM#@2k',
    session_id: 'nsd,fhj734Mdksllew898233hhssa',
    channel: 'web',
    session_duration: 86400,
    session_login_name: 'myverynicelogin',
    session_step_up_auth_ind: false,
    user_email_address: 'myverynicelogin@example.com',
    user_phone_number: '+1 123 456-898-87',
    user_ds_registration: 3,
    user_initial_risk_score: 15,
    user_current_risk_score: 27,
    transaction_type: 'CNP',
    routing_type: 'IBAN',
    routing_number: 'a1209234883452370937',
    currency_code: 'EUR',
    amount: '560.00',
    account_available_balance: '1122.86',
    ds_payee_first_transaction: 15,
    payor_zip: '27315',
    payor_state: 'NC',
    payor_city: 'Anytown',
    payor_address_line_1: '8247 Christopher Mountains Apt. 462',
    ds_account_open_date: 7,
    ds_payor_info_updated: 10,
    payee_zip: '27315',
    payee_state: 'NC',
    payee_city: 'Anytown',
    payee_address_line_1: '8247 Christopher Mountains Apt. 462',
    payee_bank: 'Citibank',
    ds_payee_info_updated: 8,
    payee_alias: 'John Doe'
  })
};

fetch('https://api.dataspike.io/api/v3/transmon/transaction', 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://api.dataspike.io/api/v3/transmon/transaction",
  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([
    'applicant_id' => 'f81d4fae-7dec-11d0-a765-00a0c91e6bf6',
    'payor_account_id' => 'b902387378291k22',
    'payor_country_cd' => 'US',
    'payee_entity_id' => 'xf9-8209-dt7',
    'payee_account_id' => 'z8739nm992002653721234',
    'payee_country_cd' => 'US',
    'user_ip_address' => '27.134.25.17',
    'user_agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:126.0) Gecko/20100101 Firefox/126.0',
    'user_device_id' => 'nmljasfdKsed8keM#@2k',
    'session_id' => 'nsd,fhj734Mdksllew898233hhssa',
    'channel' => 'web',
    'session_duration' => 86400,
    'session_login_name' => 'myverynicelogin',
    'session_step_up_auth_ind' => false,
    'user_email_address' => 'myverynicelogin@example.com',
    'user_phone_number' => '+1 123 456-898-87',
    'user_ds_registration' => 3,
    'user_initial_risk_score' => 15,
    'user_current_risk_score' => 27,
    'transaction_type' => 'CNP',
    'routing_type' => 'IBAN',
    'routing_number' => 'a1209234883452370937',
    'currency_code' => 'EUR',
    'amount' => '560.00',
    'account_available_balance' => '1122.86',
    'ds_payee_first_transaction' => 15,
    'payor_zip' => '27315',
    'payor_state' => 'NC',
    'payor_city' => 'Anytown',
    'payor_address_line_1' => '8247 Christopher Mountains Apt. 462',
    'ds_account_open_date' => 7,
    'ds_payor_info_updated' => 10,
    'payee_zip' => '27315',
    'payee_state' => 'NC',
    'payee_city' => 'Anytown',
    'payee_address_line_1' => '8247 Christopher Mountains Apt. 462',
    'payee_bank' => 'Citibank',
    'ds_payee_info_updated' => 8,
    'payee_alias' => 'John Doe'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "ds-api-token: <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://api.dataspike.io/api/v3/transmon/transaction"

	payload := strings.NewReader("{\n  \"applicant_id\": \"f81d4fae-7dec-11d0-a765-00a0c91e6bf6\",\n  \"payor_account_id\": \"b902387378291k22\",\n  \"payor_country_cd\": \"US\",\n  \"payee_entity_id\": \"xf9-8209-dt7\",\n  \"payee_account_id\": \"z8739nm992002653721234\",\n  \"payee_country_cd\": \"US\",\n  \"user_ip_address\": \"27.134.25.17\",\n  \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:126.0) Gecko/20100101 Firefox/126.0\",\n  \"user_device_id\": \"nmljasfdKsed8keM#@2k\",\n  \"session_id\": \"nsd,fhj734Mdksllew898233hhssa\",\n  \"channel\": \"web\",\n  \"session_duration\": 86400,\n  \"session_login_name\": \"myverynicelogin\",\n  \"session_step_up_auth_ind\": false,\n  \"user_email_address\": \"myverynicelogin@example.com\",\n  \"user_phone_number\": \"+1 123 456-898-87\",\n  \"user_ds_registration\": 3,\n  \"user_initial_risk_score\": 15,\n  \"user_current_risk_score\": 27,\n  \"transaction_type\": \"CNP\",\n  \"routing_type\": \"IBAN\",\n  \"routing_number\": \"a1209234883452370937\",\n  \"currency_code\": \"EUR\",\n  \"amount\": \"560.00\",\n  \"account_available_balance\": \"1122.86\",\n  \"ds_payee_first_transaction\": 15,\n  \"payor_zip\": \"27315\",\n  \"payor_state\": \"NC\",\n  \"payor_city\": \"Anytown\",\n  \"payor_address_line_1\": \"8247 Christopher Mountains Apt. 462\",\n  \"ds_account_open_date\": 7,\n  \"ds_payor_info_updated\": 10,\n  \"payee_zip\": \"27315\",\n  \"payee_state\": \"NC\",\n  \"payee_city\": \"Anytown\",\n  \"payee_address_line_1\": \"8247 Christopher Mountains Apt. 462\",\n  \"payee_bank\": \"Citibank\",\n  \"ds_payee_info_updated\": 8,\n  \"payee_alias\": \"John Doe\"\n}")

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

	req.Header.Add("ds-api-token", "<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://api.dataspike.io/api/v3/transmon/transaction")
  .header("ds-api-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"applicant_id\": \"f81d4fae-7dec-11d0-a765-00a0c91e6bf6\",\n  \"payor_account_id\": \"b902387378291k22\",\n  \"payor_country_cd\": \"US\",\n  \"payee_entity_id\": \"xf9-8209-dt7\",\n  \"payee_account_id\": \"z8739nm992002653721234\",\n  \"payee_country_cd\": \"US\",\n  \"user_ip_address\": \"27.134.25.17\",\n  \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:126.0) Gecko/20100101 Firefox/126.0\",\n  \"user_device_id\": \"nmljasfdKsed8keM#@2k\",\n  \"session_id\": \"nsd,fhj734Mdksllew898233hhssa\",\n  \"channel\": \"web\",\n  \"session_duration\": 86400,\n  \"session_login_name\": \"myverynicelogin\",\n  \"session_step_up_auth_ind\": false,\n  \"user_email_address\": \"myverynicelogin@example.com\",\n  \"user_phone_number\": \"+1 123 456-898-87\",\n  \"user_ds_registration\": 3,\n  \"user_initial_risk_score\": 15,\n  \"user_current_risk_score\": 27,\n  \"transaction_type\": \"CNP\",\n  \"routing_type\": \"IBAN\",\n  \"routing_number\": \"a1209234883452370937\",\n  \"currency_code\": \"EUR\",\n  \"amount\": \"560.00\",\n  \"account_available_balance\": \"1122.86\",\n  \"ds_payee_first_transaction\": 15,\n  \"payor_zip\": \"27315\",\n  \"payor_state\": \"NC\",\n  \"payor_city\": \"Anytown\",\n  \"payor_address_line_1\": \"8247 Christopher Mountains Apt. 462\",\n  \"ds_account_open_date\": 7,\n  \"ds_payor_info_updated\": 10,\n  \"payee_zip\": \"27315\",\n  \"payee_state\": \"NC\",\n  \"payee_city\": \"Anytown\",\n  \"payee_address_line_1\": \"8247 Christopher Mountains Apt. 462\",\n  \"payee_bank\": \"Citibank\",\n  \"ds_payee_info_updated\": 8,\n  \"payee_alias\": \"John Doe\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.dataspike.io/api/v3/transmon/transaction")

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

request = Net::HTTP::Post.new(url)
request["ds-api-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"applicant_id\": \"f81d4fae-7dec-11d0-a765-00a0c91e6bf6\",\n  \"payor_account_id\": \"b902387378291k22\",\n  \"payor_country_cd\": \"US\",\n  \"payee_entity_id\": \"xf9-8209-dt7\",\n  \"payee_account_id\": \"z8739nm992002653721234\",\n  \"payee_country_cd\": \"US\",\n  \"user_ip_address\": \"27.134.25.17\",\n  \"user_agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:126.0) Gecko/20100101 Firefox/126.0\",\n  \"user_device_id\": \"nmljasfdKsed8keM#@2k\",\n  \"session_id\": \"nsd,fhj734Mdksllew898233hhssa\",\n  \"channel\": \"web\",\n  \"session_duration\": 86400,\n  \"session_login_name\": \"myverynicelogin\",\n  \"session_step_up_auth_ind\": false,\n  \"user_email_address\": \"myverynicelogin@example.com\",\n  \"user_phone_number\": \"+1 123 456-898-87\",\n  \"user_ds_registration\": 3,\n  \"user_initial_risk_score\": 15,\n  \"user_current_risk_score\": 27,\n  \"transaction_type\": \"CNP\",\n  \"routing_type\": \"IBAN\",\n  \"routing_number\": \"a1209234883452370937\",\n  \"currency_code\": \"EUR\",\n  \"amount\": \"560.00\",\n  \"account_available_balance\": \"1122.86\",\n  \"ds_payee_first_transaction\": 15,\n  \"payor_zip\": \"27315\",\n  \"payor_state\": \"NC\",\n  \"payor_city\": \"Anytown\",\n  \"payor_address_line_1\": \"8247 Christopher Mountains Apt. 462\",\n  \"ds_account_open_date\": 7,\n  \"ds_payor_info_updated\": 10,\n  \"payee_zip\": \"27315\",\n  \"payee_state\": \"NC\",\n  \"payee_city\": \"Anytown\",\n  \"payee_address_line_1\": \"8247 Christopher Mountains Apt. 462\",\n  \"payee_bank\": \"Citibank\",\n  \"ds_payee_info_updated\": 8,\n  \"payee_alias\": \"John Doe\"\n}"

response = http.request(request)
puts response.read_body
{
  "event_id": "f81d4fae-7dec-11d0-a765-00a0c91e6bf6"
}
"<string>"

Authorizations

​
ds-api-token
string
header
required

Body

application/json

Transaction data

​
applicant_id
string<uuid>
required

Applicant ID (user that sends transaction to other user)

Example:

"f81d4fae-7dec-11d0-a765-00a0c91e6bf6"

​
payor_account_id
string
required

A unique identifier for the account that the transaction is performed on

Example:

"b902387378291k22"

​
payor_country_cd
string
required

The country of the payor. ISO 3166-1 Alpha-2

Example:

"US"

​
payee_entity_id
string
required

A unique identifier for the payee

Example:

"xf9-8209-dt7"

​
payee_account_id
string
required

A unique identifier for the account that the transaction is performed on

Example:

"z8739nm992002653721234"

​
payee_country_cd
string
required

The country of the payee. ISO 3166-1 Alpha-2

Example:

"US"

​
user_ip_address
string

The IP address of the user's current session

Example:

"27.134.25.17"

​
user_agent
string

The full OS and browser type and version collected during the session

Example:

"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:126.0) Gecko/20100101 Firefox/126.0"

​
user_device_id
string

The unique identifier of the user's device

Example:

"nmljasfdKsed8keM#@2k"

​
session_id
string

The identifier for an authentication session

Example:

"nsd,fhj734Mdksllew898233hhssa"

​
channel
string

The channel in which transaction was originated. Allowed - "web", "mobile"

Example:

"web"

​
session_duration
integer

The number of seconds since the user started the session

Required range: x >= 0
Example:

86400

​
session_login_name
string

The user name utilized by the online user to login to the online session

Example:

"myverynicelogin"

​
session_step_up_auth_ind
boolean

Indicates whether the client passed a step up authentication during the session

Example:

false

​
user_email_address
string

The primary e-mail address associated with the user

Example:

"myverynicelogin@example.com"

​
user_phone_number
string

The phone number associated with the user

Example:

"+1 123 456-898-87"

​
user_ds_registration
integer

The number of days since the user's online registration

Required range: x >= 0
Example:

3

​
user_initial_risk_score
integer

The original risk score that a customer was assigned during account registration. In range 0 <= ... <= 100

Required range: 0 <= x <= 100
Example:

15

​
user_current_risk_score
integer

The most current risk score that a customer has been assigned based on ongoing activity monitoring. In range 0 <= ... <= 100

Required range: 0 <= x <= 100
Example:

27

​
transaction_type
string

The payment method used. Examples - "CNP", "ACH", etc.

Example:

"CNP"

​
routing_type
string

The format of the routing number supplied in the payee routing number field. Example - "ABA", "CHIPS", "BIC", "IBAN", "SIC"

Example:

"IBAN"

​
routing_number
string

The routing number for the financial institution, which holds the payee account

Example:

"a1209234883452370937"

​
currency_code
string

The currency associated with the amount. supply the currency code using ISO 4217 alphabetic currency codes, for example "USD", "EUR", "JPY"

Example:

"EUR"

​
amount
string

The transaction amount

Example:

"560.00"

​
account_available_balance
string

The account's current available balance (before the current transaction)

Example:

"1122.86"

​
ds_payee_first_transaction
integer

Days since payee was added to payee list or since first transaction to payee

Required range: x >= 0
Example:

15

​
payor_zip
string

The zip or postal code of the payor

Example:

"27315"

​
payor_state
string

The state or province of the payor

Example:

"NC"

​
payor_city
string

The city of the payor

Example:

"Anytown"

​
payor_address_line_1
string

The address of the payor

Example:

"8247 Christopher Mountains Apt. 462"

​
ds_account_open_date
integer

The number of days since account open date

Required range: x >= 0
Example:

7

​
ds_payor_info_updated
integer

The number of days since payor information last update

Required range: x >= 0
Example:

10

​
payee_zip
string

The zip or postal code of the payee

Example:

"27315"

​
payee_state
string

The state or province of the payee

Example:

"NC"

​
payee_city
string

The city of the payee

Example:

"Anytown"

​
payee_address_line_1
string

The address of the payee

Example:

"8247 Christopher Mountains Apt. 462"

​
payee_bank
string

The name / alias of the payee's bank

Example:

"Citibank"

​
ds_payee_info_updated
integer

The number of days since payee information last update

Required range: x >= 0
Example:

8

​
payee_alias
string

The alias, such as email address or phone number, as entered to identify the payee.

Example:

"John Doe"

Response

Created event ID

​
event_id
string<uuid>
required

UUID of created event (you can use it for track result on WebHooks callback)

Example:

"f81d4fae-7dec-11d0-a765-00a0c91e6bf6"