curl

curl -X POST https://verification.didit.me/v1/transactions/ \
  -H 'X-Transaction-Token: SDK_TOKEN' -H 'Content-Type: application/json' \
  -d '{"txnId": "wd-2026-07-07-0042", "type": "travelRule", "info": {"direction": "out", "amount": "0.25", "currency": "ETH", "currencyType": "crypto"}, "subject": {"fullName": "Jane Doe"}, "counterparty": {"fullName": "Ana Diaz", "paymentMethod": {"type": "unhosted_wallet", "accountId": "0xBeneficiaryWallet01"}}, "travelRule": {"status": "AWAITING_COUNTERPARTY", "beneficiaryData": {"wallet_address": "0xBeneficiaryWallet01", "name": "Ana Diaz"}}, "includeCryptoScreening": true}'

import { DiditSdk } from '@didit-protocol/sdk-web';

const result = await DiditSdk.shared.submitTransaction({
  transactionToken: sdkToken,
  transaction: {
    txnId: 'wd-2026-07-07-0042',
    category: 'travelRule',
    details: { direction: 'out', amount: '0.25', currency: 'ETH', currencyType: 'crypto' },
    subject: { fullName: 'Jane Doe' },
    counterparty: { fullName: 'Ana Diaz', paymentMethod: { type: 'unhosted_wallet', accountId: '0xBeneficiaryWallet01' } },
    travelRule: { status: 'AWAITING_COUNTERPARTY', beneficiaryData: { wallet_address: '0xBeneficiaryWallet01', name: 'Ana Diaz' } },
    includeCryptoScreening: true
  },
  onActionCompleted: (refreshed) => console.log(refreshed.status)
});

import requests

url = "https://verification.didit.me/v1/transactions/"

payload = {
    "txnId": "wd-2026-07-07-0042",
    "type": "travelRule",
    "info": {
        "direction": "out",
        "amount": "0.25",
        "currency": "ETH",
        "currencyType": "crypto",
        "cryptoParams": { "crypto_chain": "ETH" }
    },
    "subject": { "fullName": "Jane Doe" },
    "counterparty": {
        "fullName": "Ana Diaz",
        "paymentMethod": {
            "type": "unhosted_wallet",
            "accountId": "0xBeneficiaryWallet01"
        }
    },
    "travelRule": {
        "status": "AWAITING_COUNTERPARTY",
        "beneficiaryData": {
            "wallet_address": "0xBeneficiaryWallet01",
            "name": "Ana Diaz"
        }
    },
    "includeCryptoScreening": True
}
headers = {
    "X-Transaction-Token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://verification.didit.me/v1/transactions/",
  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([
    'txnId' => 'wd-2026-07-07-0042',
    'type' => 'travelRule',
    'info' => [
        'direction' => 'out',
        'amount' => '0.25',
        'currency' => 'ETH',
        'currencyType' => 'crypto',
        'cryptoParams' => [
                'crypto_chain' => 'ETH'
        ]
    ],
    'subject' => [
        'fullName' => 'Jane Doe'
    ],
    'counterparty' => [
        'fullName' => 'Ana Diaz',
        'paymentMethod' => [
                'type' => 'unhosted_wallet',
                'accountId' => '0xBeneficiaryWallet01'
        ]
    ],
    'travelRule' => [
        'status' => 'AWAITING_COUNTERPARTY',
        'beneficiaryData' => [
                'wallet_address' => '0xBeneficiaryWallet01',
                'name' => 'Ana Diaz'
        ]
    ],
    'includeCryptoScreening' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Transaction-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://verification.didit.me/v1/transactions/"

	payload := strings.NewReader("{\n  \"txnId\": \"wd-2026-07-07-0042\",\n  \"type\": \"travelRule\",\n  \"info\": {\n    \"direction\": \"out\",\n    \"amount\": \"0.25\",\n    \"currency\": \"ETH\",\n    \"currencyType\": \"crypto\",\n    \"cryptoParams\": {\n      \"crypto_chain\": \"ETH\"\n    }\n  },\n  \"subject\": {\n    \"fullName\": \"Jane Doe\"\n  },\n  \"counterparty\": {\n    \"fullName\": \"Ana Diaz\",\n    \"paymentMethod\": {\n      \"type\": \"unhosted_wallet\",\n      \"accountId\": \"0xBeneficiaryWallet01\"\n    }\n  },\n  \"travelRule\": {\n    \"status\": \"AWAITING_COUNTERPARTY\",\n    \"beneficiaryData\": {\n      \"wallet_address\": \"0xBeneficiaryWallet01\",\n      \"name\": \"Ana Diaz\"\n    }\n  },\n  \"includeCryptoScreening\": true\n}")

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

	req.Header.Add("X-Transaction-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://verification.didit.me/v1/transactions/")
  .header("X-Transaction-Token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"txnId\": \"wd-2026-07-07-0042\",\n  \"type\": \"travelRule\",\n  \"info\": {\n    \"direction\": \"out\",\n    \"amount\": \"0.25\",\n    \"currency\": \"ETH\",\n    \"currencyType\": \"crypto\",\n    \"cryptoParams\": {\n      \"crypto_chain\": \"ETH\"\n    }\n  },\n  \"subject\": {\n    \"fullName\": \"Jane Doe\"\n  },\n  \"counterparty\": {\n    \"fullName\": \"Ana Diaz\",\n    \"paymentMethod\": {\n      \"type\": \"unhosted_wallet\",\n      \"accountId\": \"0xBeneficiaryWallet01\"\n    }\n  },\n  \"travelRule\": {\n    \"status\": \"AWAITING_COUNTERPARTY\",\n    \"beneficiaryData\": {\n      \"wallet_address\": \"0xBeneficiaryWallet01\",\n      \"name\": \"Ana Diaz\"\n    }\n  },\n  \"includeCryptoScreening\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://verification.didit.me/v1/transactions/")

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

request = Net::HTTP::Post.new(url)
request["X-Transaction-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"txnId\": \"wd-2026-07-07-0042\",\n  \"type\": \"travelRule\",\n  \"info\": {\n    \"direction\": \"out\",\n    \"amount\": \"0.25\",\n    \"currency\": \"ETH\",\n    \"currencyType\": \"crypto\",\n    \"cryptoParams\": {\n      \"crypto_chain\": \"ETH\"\n    }\n  },\n  \"subject\": {\n    \"fullName\": \"Jane Doe\"\n  },\n  \"counterparty\": {\n    \"fullName\": \"Ana Diaz\",\n    \"paymentMethod\": {\n      \"type\": \"unhosted_wallet\",\n      \"accountId\": \"0xBeneficiaryWallet01\"\n    }\n  },\n  \"travelRule\": {\n    \"status\": \"AWAITING_COUNTERPARTY\",\n    \"beneficiaryData\": {\n      \"wallet_address\": \"0xBeneficiaryWallet01\",\n      \"name\": \"Ana Diaz\"\n    }\n  },\n  \"includeCryptoScreening\": true\n}"

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

{
  "uuid": "22222222-3333-4444-5555-666666666666",
  "txn_id": "wd-2026-07-07-0042",
  "transaction_type": "travelRule",
  "direction": "OUTBOUND",
  "status": "AWAITING_USER",
  "amount": "0.25",
  "currency": "ETH",
  "travel_rule": {
    "uuid": "33333333-4444-5555-6666-777777777777",
    "status": "ON_HOLD",
    "required": true
  },
  "action_required": {
    "type": "wallet_ownership",
    "url": "https://verification.didit.me/wallet-ownership/3s9x...urlsafe",
    "widget_session_id": "77777777-8888-9999-aaaa-bbbbbbbbbbbb",
    "expires_at": "2026-07-07T13:00:00Z"
  }
}

Transactions

Submit Transaction (SDK Token)

Device-facing endpoint the Didit SDKs call to submit a transaction directly from the end-user’s device. Authentication is a scoped token from POST /v3/transactions/sdk-token/ sent in the X-Transaction-Token header instead of an API key, and the endpoint is CORS-enabled so browsers can call it cross-origin. The payload uses the camelCase wire aliases shown below (the SDK submitTransaction methods build it for you). Three server-side guarantees: the application is always taken from the token; the subject identity (externalUserId) is always enforced from the token’s vendor_data, so spoofed payload values are ignored; and device intelligence (the SDK device fingerprint plus server-derived IP and user agent) is attached to the subject automatically.

POST

transactions

curl

curl -X POST https://verification.didit.me/v1/transactions/ \
  -H 'X-Transaction-Token: SDK_TOKEN' -H 'Content-Type: application/json' \
  -d '{"txnId": "wd-2026-07-07-0042", "type": "travelRule", "info": {"direction": "out", "amount": "0.25", "currency": "ETH", "currencyType": "crypto"}, "subject": {"fullName": "Jane Doe"}, "counterparty": {"fullName": "Ana Diaz", "paymentMethod": {"type": "unhosted_wallet", "accountId": "0xBeneficiaryWallet01"}}, "travelRule": {"status": "AWAITING_COUNTERPARTY", "beneficiaryData": {"wallet_address": "0xBeneficiaryWallet01", "name": "Ana Diaz"}}, "includeCryptoScreening": true}'

import { DiditSdk } from '@didit-protocol/sdk-web';

const result = await DiditSdk.shared.submitTransaction({
  transactionToken: sdkToken,
  transaction: {
    txnId: 'wd-2026-07-07-0042',
    category: 'travelRule',
    details: { direction: 'out', amount: '0.25', currency: 'ETH', currencyType: 'crypto' },
    subject: { fullName: 'Jane Doe' },
    counterparty: { fullName: 'Ana Diaz', paymentMethod: { type: 'unhosted_wallet', accountId: '0xBeneficiaryWallet01' } },
    travelRule: { status: 'AWAITING_COUNTERPARTY', beneficiaryData: { wallet_address: '0xBeneficiaryWallet01', name: 'Ana Diaz' } },
    includeCryptoScreening: true
  },
  onActionCompleted: (refreshed) => console.log(refreshed.status)
});

import requests

url = "https://verification.didit.me/v1/transactions/"

payload = {
    "txnId": "wd-2026-07-07-0042",
    "type": "travelRule",
    "info": {
        "direction": "out",
        "amount": "0.25",
        "currency": "ETH",
        "currencyType": "crypto",
        "cryptoParams": { "crypto_chain": "ETH" }
    },
    "subject": { "fullName": "Jane Doe" },
    "counterparty": {
        "fullName": "Ana Diaz",
        "paymentMethod": {
            "type": "unhosted_wallet",
            "accountId": "0xBeneficiaryWallet01"
        }
    },
    "travelRule": {
        "status": "AWAITING_COUNTERPARTY",
        "beneficiaryData": {
            "wallet_address": "0xBeneficiaryWallet01",
            "name": "Ana Diaz"
        }
    },
    "includeCryptoScreening": True
}
headers = {
    "X-Transaction-Token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://verification.didit.me/v1/transactions/",
  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([
    'txnId' => 'wd-2026-07-07-0042',
    'type' => 'travelRule',
    'info' => [
        'direction' => 'out',
        'amount' => '0.25',
        'currency' => 'ETH',
        'currencyType' => 'crypto',
        'cryptoParams' => [
                'crypto_chain' => 'ETH'
        ]
    ],
    'subject' => [
        'fullName' => 'Jane Doe'
    ],
    'counterparty' => [
        'fullName' => 'Ana Diaz',
        'paymentMethod' => [
                'type' => 'unhosted_wallet',
                'accountId' => '0xBeneficiaryWallet01'
        ]
    ],
    'travelRule' => [
        'status' => 'AWAITING_COUNTERPARTY',
        'beneficiaryData' => [
                'wallet_address' => '0xBeneficiaryWallet01',
                'name' => 'Ana Diaz'
        ]
    ],
    'includeCryptoScreening' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Transaction-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://verification.didit.me/v1/transactions/"

	payload := strings.NewReader("{\n  \"txnId\": \"wd-2026-07-07-0042\",\n  \"type\": \"travelRule\",\n  \"info\": {\n    \"direction\": \"out\",\n    \"amount\": \"0.25\",\n    \"currency\": \"ETH\",\n    \"currencyType\": \"crypto\",\n    \"cryptoParams\": {\n      \"crypto_chain\": \"ETH\"\n    }\n  },\n  \"subject\": {\n    \"fullName\": \"Jane Doe\"\n  },\n  \"counterparty\": {\n    \"fullName\": \"Ana Diaz\",\n    \"paymentMethod\": {\n      \"type\": \"unhosted_wallet\",\n      \"accountId\": \"0xBeneficiaryWallet01\"\n    }\n  },\n  \"travelRule\": {\n    \"status\": \"AWAITING_COUNTERPARTY\",\n    \"beneficiaryData\": {\n      \"wallet_address\": \"0xBeneficiaryWallet01\",\n      \"name\": \"Ana Diaz\"\n    }\n  },\n  \"includeCryptoScreening\": true\n}")

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

	req.Header.Add("X-Transaction-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://verification.didit.me/v1/transactions/")
  .header("X-Transaction-Token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"txnId\": \"wd-2026-07-07-0042\",\n  \"type\": \"travelRule\",\n  \"info\": {\n    \"direction\": \"out\",\n    \"amount\": \"0.25\",\n    \"currency\": \"ETH\",\n    \"currencyType\": \"crypto\",\n    \"cryptoParams\": {\n      \"crypto_chain\": \"ETH\"\n    }\n  },\n  \"subject\": {\n    \"fullName\": \"Jane Doe\"\n  },\n  \"counterparty\": {\n    \"fullName\": \"Ana Diaz\",\n    \"paymentMethod\": {\n      \"type\": \"unhosted_wallet\",\n      \"accountId\": \"0xBeneficiaryWallet01\"\n    }\n  },\n  \"travelRule\": {\n    \"status\": \"AWAITING_COUNTERPARTY\",\n    \"beneficiaryData\": {\n      \"wallet_address\": \"0xBeneficiaryWallet01\",\n      \"name\": \"Ana Diaz\"\n    }\n  },\n  \"includeCryptoScreening\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://verification.didit.me/v1/transactions/")

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

request = Net::HTTP::Post.new(url)
request["X-Transaction-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"txnId\": \"wd-2026-07-07-0042\",\n  \"type\": \"travelRule\",\n  \"info\": {\n    \"direction\": \"out\",\n    \"amount\": \"0.25\",\n    \"currency\": \"ETH\",\n    \"currencyType\": \"crypto\",\n    \"cryptoParams\": {\n      \"crypto_chain\": \"ETH\"\n    }\n  },\n  \"subject\": {\n    \"fullName\": \"Jane Doe\"\n  },\n  \"counterparty\": {\n    \"fullName\": \"Ana Diaz\",\n    \"paymentMethod\": {\n      \"type\": \"unhosted_wallet\",\n      \"accountId\": \"0xBeneficiaryWallet01\"\n    }\n  },\n  \"travelRule\": {\n    \"status\": \"AWAITING_COUNTERPARTY\",\n    \"beneficiaryData\": {\n      \"wallet_address\": \"0xBeneficiaryWallet01\",\n      \"name\": \"Ana Diaz\"\n    }\n  },\n  \"includeCryptoScreening\": true\n}"

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

{
  "uuid": "22222222-3333-4444-5555-666666666666",
  "txn_id": "wd-2026-07-07-0042",
  "transaction_type": "travelRule",
  "direction": "OUTBOUND",
  "status": "AWAITING_USER",
  "amount": "0.25",
  "currency": "ETH",
  "travel_rule": {
    "uuid": "33333333-4444-5555-6666-777777777777",
    "status": "ON_HOLD",
    "required": true
  },
  "action_required": {
    "type": "wallet_ownership",
    "url": "https://verification.didit.me/wallet-ownership/3s9x...urlsafe",
    "widget_session_id": "77777777-8888-9999-aaaa-bbbbbbbbbbbb",
    "expires_at": "2026-07-07T13:00:00Z"
  }
}

Authorizations

X-Transaction-Token

string

header

required

Short-lived scoped token minted by your backend via POST /v3/transactions/sdk-token/. Used by the Didit SDKs on the device-facing /v1/transactions/ endpoints.

Body

application/json

txnId

string

required

Your unique identifier for this transaction (maps to transaction_id, max 128 characters).

Example:

"wd-2026-07-07-0042"

type

string

required

Transaction category (maps to transaction_category), e.g. finance, kyc, travelRule, userPlatformEvent, gamblingBet.

Example:

"travelRule"

info

object

required

Core financial details of the transaction (maps to transaction_details).

Show child attributes

subject

object

required

The subject (applicant) of the transaction. externalUserId is ignored here: the subject identity is always enforced from the token's vendor_data.

Show child attributes

txnDate

string<date-time>

When the transaction occurred (maps to transaction_at). Defaults to now if omitted.

zoneId

string

IANA time zone identifier (maps to time_zone), e.g. Europe/Madrid.

counterparty

object

The counterparty of the transaction (optional). Same shape as subject; externalUserId is meaningful here.

Show child attributes

props

object

Custom key-value pairs (maps to custom_properties). Each key can be referenced in rule conditions as custom_values.<key>.

travelRule

object

Travel Rule details (maps to travel_rule_details). When Travel Rule is enabled for the application, Didit ignores any status you send and drives the exchange itself.

Show child attributes

includeCryptoScreening

boolean | null

Per-transaction override for crypto blockchain analytics screening (maps to include_crypto_screening).

fingerprint_v2

object

The didit-fp-v2 device fingerprint payload. Injected automatically by the SDKs; only relevant when calling the wire API directly.

Response

Transaction submitted and monitored. Same detail shape as GET /v3/transactions/{transaction_id}/, including the action_required block when the end user must complete a follow-up action (the SDKs auto-launch it by default).

Full monitoring record for one transaction, as returned by GET /v3/transactions/{transaction_id}/ and POST /v3/transactions/.

uuid

string<uuid>

Didit-stable transaction identifier. Use as {transaction_id} for follow-up calls.

transaction_number

integer

Application-scoped sequential transaction number shown in Console (e.g. 4123).

txn_id

string

The transaction_id you supplied at create time (max 128 chars). Unique per application.

txn_date

string<date-time>

When the transaction occurred (from transaction_at; defaults to submission time).

zone_id

string | null

IANA time zone identifier provided at create time.

transaction_type

string

Top-level category as stored: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent. Note multi-word values are echoed back in camelCase even when submitted in snake_case.

action_type

string

Sub-type within the category (e.g. deposit, withdrawal, transfer). Defaults to the category when not supplied.

direction

enum<string>

Direction relative to the subject. Stored uppercase regardless of the casing submitted (in/out/inbound/outbound are accepted on input).

Available options:

INBOUND,

OUTBOUND

status

enum<string>

Current monitoring verdict. Transactions are created APPROVED; rules may flip them to IN_REVIEW/DECLINED synchronously.

Available options:

APPROVED,

IN_REVIEW,

DECLINED,

AWAITING_USER

amount

string

Transaction amount as a decimal string with trailing zeros stripped (e.g. "1500", "0.5", "0.123456789012345678"). Up to 18 decimal places.

currency

string

Currency code of amount (e.g. EUR, USD, BTC).

currency_type

string | null

fiat or crypto, as submitted in currency_kind.

amount_in_default_currency

string | null

Pre-converted amount you supplied, as a decimal string with trailing zeros stripped.

default_currency_code

string | null

preferred_currency_amount

string | null

amount converted to the application's preferred currency, when available.

preferred_currency_code

string | null

payment_details

string | null

Free-text payment reference or memo from the submission.

payment_txn_id

string | null

External payment system reference (e.g. blockchain transaction hash) from payment_reference_id.

score

integer

Risk score accumulated by rules (typically 0–100). Higher = riskier.

severity

enum<string> | null

Categorical risk severity set by rules/providers (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). null until something sets it.

Available options:

UNKNOWN,

LOW,

MEDIUM,

HIGH,

CRITICAL

decision_reason_code

string | null

Machine-readable reason for the current status.

decision_reason_label

string | null

Human-readable label for decision_reason_code.

vendor_data

string | null

Convenience copy of the applicant's vendor_data.

metadata

object

Snapshot of the subject and counterparty payloads as submitted at create time.

props

object

The custom_properties you supplied at create time. Each key is addressable in rule conditions as custom_values.<key>.

Overview

User and Business Verifications

Lists

Workflows

Questionnaires

Users

Businesses

Cases

Case Blueprints

Report Templates

Regulatory Reports

Transactions

Travel Rule

Session Operations

Customization

Webhook

Billing

Management API Overview

Auth API (Programmatic)

Identity & Documents

Document AI

Database Validation

Biometrics & Face

Compliance & Risk

KYB Registry

Email Verification

Phone Verification

Submit Transaction (SDK Token)

Authorizations

Body

Response