curl -X POST 'https://verification.didit.me/v3/transactions/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"transaction_id": "your-txn-2026-05-17-001",
"transaction_category": "finance",
"transaction_details": {
"direction": "outbound",
"amount": 1500,
"currency": "EUR",
"action_type": "withdrawal"
},
"subject": {
"entity_type": "individual",
"vendor_data": "user-12345",
"full_name": "Maria Garcia"
}
}'import os
import requests
resp = requests.post(
'https://verification.didit.me/v3/transactions/',
headers={
'x-api-key': os.environ['DIDIT_API_KEY'],
'Content-Type': 'application/json',
},
json={
'transaction_id': 'your-txn-2026-05-17-001',
'transaction_category': 'finance',
'transaction_details': {
'direction': 'outbound',
'amount': 1500,
'currency': 'EUR',
'action_type': 'withdrawal',
},
'subject': {
'entity_type': 'individual',
'vendor_data': 'user-12345',
'full_name': 'Maria Garcia',
},
},
timeout=15,
)
resp.raise_for_status()
tx = resp.json()
print(tx['txn_id'], '->', tx['status'], tx['severity'])const resp = await fetch('https://verification.didit.me/v3/transactions/', {
method: 'POST',
headers: {
'x-api-key': process.env.DIDIT_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
transaction_id: 'your-txn-2026-05-17-001',
transaction_category: 'finance',
transaction_details: {
direction: 'outbound',
amount: 1500,
currency: 'EUR',
action_type: 'withdrawal',
},
subject: {
entity_type: 'individual',
vendor_data: 'user-12345',
full_name: 'Maria Garcia',
},
}),
});
if (!resp.ok) throw new Error(await resp.text());
const tx = await resp.json();
console.log(tx.txn_id, tx.status, tx.severity);<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/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([
'transaction_id' => 'your-txn-2026-05-17-001',
'transaction_category' => 'finance',
'transaction_details' => [
'direction' => 'outbound',
'amount' => 1500,
'currency' => 'EUR',
'action_type' => 'withdrawal'
],
'subject' => [
'entity_type' => 'individual',
'vendor_data' => 'user-12345',
'full_name' => 'Maria Garcia'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-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://verification.didit.me/v3/transactions/"
payload := strings.NewReader("{\n \"transaction_id\": \"your-txn-2026-05-17-001\",\n \"transaction_category\": \"finance\",\n \"transaction_details\": {\n \"direction\": \"outbound\",\n \"amount\": 1500,\n \"currency\": \"EUR\",\n \"action_type\": \"withdrawal\"\n },\n \"subject\": {\n \"entity_type\": \"individual\",\n \"vendor_data\": \"user-12345\",\n \"full_name\": \"Maria Garcia\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-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://verification.didit.me/v3/transactions/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"transaction_id\": \"your-txn-2026-05-17-001\",\n \"transaction_category\": \"finance\",\n \"transaction_details\": {\n \"direction\": \"outbound\",\n \"amount\": 1500,\n \"currency\": \"EUR\",\n \"action_type\": \"withdrawal\"\n },\n \"subject\": {\n \"entity_type\": \"individual\",\n \"vendor_data\": \"user-12345\",\n \"full_name\": \"Maria Garcia\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/transactions/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transaction_id\": \"your-txn-2026-05-17-001\",\n \"transaction_category\": \"finance\",\n \"transaction_details\": {\n \"direction\": \"outbound\",\n \"amount\": 1500,\n \"currency\": \"EUR\",\n \"action_type\": \"withdrawal\"\n },\n \"subject\": {\n \"entity_type\": \"individual\",\n \"vendor_data\": \"user-12345\",\n \"full_name\": \"Maria Garcia\"\n }\n}"
response = http.request(request)
puts response.read_body{
"uuid": "abcdef12-3456-4890-abcd-ef1234567890",
"environment": "live",
"transaction_number": 4123,
"txn_id": "your-txn-2026-05-17-001",
"txn_date": "2026-05-17T08:42:00Z",
"zone_id": "Europe/Madrid",
"transaction_type": "finance",
"action_type": "withdrawal",
"direction": "OUTBOUND",
"status": "APPROVED",
"source": "LIVE",
"amount": "1500",
"currency": "EUR",
"currency_type": "fiat",
"amount_in_default_currency": "1620.45",
"default_currency_code": "USD",
"preferred_currency_amount": "1620.45",
"preferred_currency_code": "USD",
"payment_details": "Withdrawal to crypto wallet",
"payment_txn_id": null,
"score": 0,
"severity": null,
"decision_reason_code": null,
"decision_reason_label": null,
"vendor_data": "user-12345",
"metadata": {
"subject": {
"entity_type": "individual",
"vendor_data": "user-12345",
"full_name": "Maria Garcia",
"address": {},
"institution_details": {},
"device_context": {}
},
"counterparty": {}
},
"props": {},
"tags": [],
"parties": [
{
"uuid": "b1111111-2222-4333-8444-555555555555",
"role": "APPLICANT",
"entity_type": "individual",
"kind": "USER",
"vendor_data": "user-12345",
"full_name": "Maria Garcia",
"first_name": null,
"last_name": null,
"country_code": null,
"dob": null,
"address": {},
"institution_info": {},
"device": {},
"external_party_snapshot": null
}
],
"payment_methods": [],
"documents": [],
"activities": [
{
"uuid": "d4e5f6a7-8901-4bcd-9ef0-123456789abc",
"activity_type": "TRANSACTION_CREATED",
"source": "TRANSACTION",
"status": "APPROVED",
"title": "withdrawal",
"description": "Transaction recorded.",
"metadata": {},
"occurred_at": "2026-05-17T08:42:11Z"
}
],
"alerts": [],
"rule_runs": [],
"provider_results": [],
"travel_rule": null,
"network_snapshot": null,
"remediation": null,
"cost_breakdown": null
}Create Transaction
Submit a transaction for synchronous AML/risk monitoring. The transaction is created APPROVED, then your rules (and crypto screening, when applicable) run inline and may flip the returned status to IN_REVIEW or DECLINED. transaction_id is your idempotency key (max 128 chars, unique per app); reusing it returns 400. A transaction.created webhook is dispatched on success (sandbox applications are not billed and do not emit webhooks).
curl -X POST 'https://verification.didit.me/v3/transactions/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"transaction_id": "your-txn-2026-05-17-001",
"transaction_category": "finance",
"transaction_details": {
"direction": "outbound",
"amount": 1500,
"currency": "EUR",
"action_type": "withdrawal"
},
"subject": {
"entity_type": "individual",
"vendor_data": "user-12345",
"full_name": "Maria Garcia"
}
}'import os
import requests
resp = requests.post(
'https://verification.didit.me/v3/transactions/',
headers={
'x-api-key': os.environ['DIDIT_API_KEY'],
'Content-Type': 'application/json',
},
json={
'transaction_id': 'your-txn-2026-05-17-001',
'transaction_category': 'finance',
'transaction_details': {
'direction': 'outbound',
'amount': 1500,
'currency': 'EUR',
'action_type': 'withdrawal',
},
'subject': {
'entity_type': 'individual',
'vendor_data': 'user-12345',
'full_name': 'Maria Garcia',
},
},
timeout=15,
)
resp.raise_for_status()
tx = resp.json()
print(tx['txn_id'], '->', tx['status'], tx['severity'])const resp = await fetch('https://verification.didit.me/v3/transactions/', {
method: 'POST',
headers: {
'x-api-key': process.env.DIDIT_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
transaction_id: 'your-txn-2026-05-17-001',
transaction_category: 'finance',
transaction_details: {
direction: 'outbound',
amount: 1500,
currency: 'EUR',
action_type: 'withdrawal',
},
subject: {
entity_type: 'individual',
vendor_data: 'user-12345',
full_name: 'Maria Garcia',
},
}),
});
if (!resp.ok) throw new Error(await resp.text());
const tx = await resp.json();
console.log(tx.txn_id, tx.status, tx.severity);<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/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([
'transaction_id' => 'your-txn-2026-05-17-001',
'transaction_category' => 'finance',
'transaction_details' => [
'direction' => 'outbound',
'amount' => 1500,
'currency' => 'EUR',
'action_type' => 'withdrawal'
],
'subject' => [
'entity_type' => 'individual',
'vendor_data' => 'user-12345',
'full_name' => 'Maria Garcia'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-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://verification.didit.me/v3/transactions/"
payload := strings.NewReader("{\n \"transaction_id\": \"your-txn-2026-05-17-001\",\n \"transaction_category\": \"finance\",\n \"transaction_details\": {\n \"direction\": \"outbound\",\n \"amount\": 1500,\n \"currency\": \"EUR\",\n \"action_type\": \"withdrawal\"\n },\n \"subject\": {\n \"entity_type\": \"individual\",\n \"vendor_data\": \"user-12345\",\n \"full_name\": \"Maria Garcia\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-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://verification.didit.me/v3/transactions/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"transaction_id\": \"your-txn-2026-05-17-001\",\n \"transaction_category\": \"finance\",\n \"transaction_details\": {\n \"direction\": \"outbound\",\n \"amount\": 1500,\n \"currency\": \"EUR\",\n \"action_type\": \"withdrawal\"\n },\n \"subject\": {\n \"entity_type\": \"individual\",\n \"vendor_data\": \"user-12345\",\n \"full_name\": \"Maria Garcia\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/transactions/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transaction_id\": \"your-txn-2026-05-17-001\",\n \"transaction_category\": \"finance\",\n \"transaction_details\": {\n \"direction\": \"outbound\",\n \"amount\": 1500,\n \"currency\": \"EUR\",\n \"action_type\": \"withdrawal\"\n },\n \"subject\": {\n \"entity_type\": \"individual\",\n \"vendor_data\": \"user-12345\",\n \"full_name\": \"Maria Garcia\"\n }\n}"
response = http.request(request)
puts response.read_body{
"uuid": "abcdef12-3456-4890-abcd-ef1234567890",
"environment": "live",
"transaction_number": 4123,
"txn_id": "your-txn-2026-05-17-001",
"txn_date": "2026-05-17T08:42:00Z",
"zone_id": "Europe/Madrid",
"transaction_type": "finance",
"action_type": "withdrawal",
"direction": "OUTBOUND",
"status": "APPROVED",
"source": "LIVE",
"amount": "1500",
"currency": "EUR",
"currency_type": "fiat",
"amount_in_default_currency": "1620.45",
"default_currency_code": "USD",
"preferred_currency_amount": "1620.45",
"preferred_currency_code": "USD",
"payment_details": "Withdrawal to crypto wallet",
"payment_txn_id": null,
"score": 0,
"severity": null,
"decision_reason_code": null,
"decision_reason_label": null,
"vendor_data": "user-12345",
"metadata": {
"subject": {
"entity_type": "individual",
"vendor_data": "user-12345",
"full_name": "Maria Garcia",
"address": {},
"institution_details": {},
"device_context": {}
},
"counterparty": {}
},
"props": {},
"tags": [],
"parties": [
{
"uuid": "b1111111-2222-4333-8444-555555555555",
"role": "APPLICANT",
"entity_type": "individual",
"kind": "USER",
"vendor_data": "user-12345",
"full_name": "Maria Garcia",
"first_name": null,
"last_name": null,
"country_code": null,
"dob": null,
"address": {},
"institution_info": {},
"device": {},
"external_party_snapshot": null
}
],
"payment_methods": [],
"documents": [],
"activities": [
{
"uuid": "d4e5f6a7-8901-4bcd-9ef0-123456789abc",
"activity_type": "TRANSACTION_CREATED",
"source": "TRANSACTION",
"status": "APPROVED",
"title": "withdrawal",
"description": "Transaction recorded.",
"metadata": {},
"occurred_at": "2026-05-17T08:42:11Z"
}
],
"alerts": [],
"rule_runs": [],
"provider_results": [],
"travel_rule": null,
"network_snapshot": null,
"remediation": null,
"cost_breakdown": null
}Authorizations
Body
Your unique identifier for this transaction (max 128 characters).
"your-txn-2026-05-17-001"
Category of the transaction. CamelCase aliases (travelRule, userPlatformEvent, gamblingBet, …) are also accepted; the stored/echoed value is camelCase for multi-word categories.
finance, kyc, travel_rule, user_event, audit_trail_event, gambling_bet, gambling_limit_change, gambling_bonus_change, travelRule "finance"
Core financial details of the transaction.
Show child attributes
Show child attributes
The subject (applicant) of the transaction.
Show child attributes
Show child attributes
When the transaction occurred. Defaults to now if omitted.
IANA time zone identifier, e.g. Europe/Madrid.
The counterparty of the transaction (optional).
Show child attributes
Show child attributes
Arbitrary key-value pairs attached to the transaction. Each key can be referenced in rule conditions with the field path custom_values.<key>.
{
"merchant_id": "test",
"bank_name": "test_2"
}
Travel Rule compliance metadata.
Show child attributes
Show child attributes
Pre-computed network graph snapshot.
Show child attributes
Show child attributes
Per-transaction override for crypto blockchain analytics screening. When true, crypto screening is performed regardless of the application default. When false, crypto screening is skipped even if enabled in the application settings. When omitted or null, the application-level default configured in the Console is used. Crypto screening requires transaction_details.direction, currency_kind: "crypto", a chain/currency, and the wallet address selected by the direction: inbound pre-transfer screening uses counterparty.payment_method.account_id, inbound transaction-hash screening uses subject.payment_method.account_id, and outbound screening uses counterparty.payment_method.account_id. When transaction_details.payment_reference_id contains a blockchain transaction hash, Didit performs transaction screening and returns transaction summary enrichment when available.
Response
Transaction submitted and monitored. The body is the full transaction detail (same shape as GET /v3/transactions/{transaction_id}/), reflecting any rule outcomes already applied.
Full monitoring record for one transaction, as returned by GET /v3/transactions/{transaction_id}/ and POST /v3/transactions/.
Didit-stable transaction identifier. Use as {transaction_id} for follow-up calls.
Environment of the application that owns the transaction. A sandbox transaction is stored but never evaluated, screened, notified or billed, so its empty rule_runs means "not evaluated".
live, sandbox Application-scoped sequential transaction number shown in Console (e.g. 4123).
The transaction_id you supplied at create time (max 128 chars). Unique per application.
When the transaction occurred (from transaction_at; defaults to submission time).
IANA time zone identifier provided at create time.
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.
Sub-type within the category (e.g. deposit, withdrawal, transfer). Defaults to the category when not supplied.
Direction relative to the subject. Stored uppercase regardless of the casing submitted (in/out/inbound/outbound are accepted on input).
INBOUND, OUTBOUND Current monitoring verdict. Transactions are created APPROVED; rules may flip them to IN_REVIEW/DECLINED synchronously.
APPROVED, IN_REVIEW, DECLINED, AWAITING_USER How the record originated: LIVE for transactions submitted through the API or SDK, IMPORTED for transactions loaded through the console import.
LIVE, IMPORTED Transaction amount as a decimal string with trailing zeros stripped (e.g. "1500", "0.5", "0.123456789012345678"). Up to 18 decimal places.
Currency code of amount. Any ISO 4217 alphabetic code is accepted (e.g. EUR, USD, NGN), as is a crypto asset symbol (e.g. BTC). Prefer a currently-circulating code. Not every accepted code has an exchange rate: when none is available for the code (for example the ISO accounting unit XSU, or a crypto symbol Didit does not price), automatic conversion fails and preferred_currency_amount is returned null unless the request supplied a pre-converted amount_in_default_currency.
fiat or crypto, as submitted in currency_kind.
Pre-converted amount you supplied, as a decimal string with trailing zeros stripped.
amount converted to the application's preferred currency, when available.
Free-text payment reference or memo from the submission.
External payment system reference (e.g. blockchain transaction hash) from payment_reference_id.
Risk score accumulated by rules (typically 0–100). Higher = riskier.
Categorical risk severity set by rules/providers (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). null until something sets it.
UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL Machine-readable reason for the current status.
Human-readable label for decision_reason_code.
Convenience copy of the applicant's vendor_data.
Snapshot of the subject and counterparty payloads as submitted at create time.
The custom_properties you supplied at create time. Each key is addressable in rule conditions as custom_values.<key>.
Tags attached to the transaction (manually or by rules).
Show child attributes
Show child attributes
Transaction parties (applicant, counterparty).
Show child attributes
Show child attributes
Payment methods linked to the transaction.
Show child attributes
Show child attributes
Files attached to the transaction from the console. [] when none.
Show child attributes
Show child attributes
Activity log entries (creation, notes, manual reviews, status changes).
Show child attributes
Show child attributes
Alerts raised by rules and providers.
Show child attributes
Show child attributes
Per-rule execution results — which rule fired, with what score impact.
Show child attributes
Show child attributes
Raw provider payloads (AML screening, blockchain analytics, etc.).
Show child attributes
Show child attributes
Travel Rule transfer or check. Populated when travel_rule_details was submitted, and also when Travel Rule is enabled and the transaction was created with transaction_category: travelRule (Didit initiates the exchange itself, even without travel_rule_details). null when no transfer or check exists.
Show child attributes
Show child attributes
Graph snapshot of related transactions/parties used by the rules engine. Either the network_snapshot submitted with the transaction or the graph Didit builds from a successful AML wallet screening (which replaces a submitted one). null when neither exists.
Show child attributes
Show child attributes
Remediation session offered to the user when re-verification is required. Superseded by action_required, which is the canonical block; kept for backward compatibility.
Show child attributes
Show child attributes
Pending end-user action required to complete this transaction, or null when there is none. The Didit SDKs auto-launch the action by default and refresh the transaction when it finishes. Two variants, discriminated by type: verification_session (a hosted verification session created by a rule action) and wallet_ownership (a wallet-ownership widget session auto-minted for a Travel Rule transfer that needs proof of wallet control, gated by the auto_wallet_verification Travel Rule setting). When both could apply, wallet_ownership takes precedence because it blocks the Travel Rule exchange.
- Verification session
- Wallet ownership
Show child attributes
Show child attributes
Per-feature credit cost breakdown for this transaction.