Saltar al contingut principal
POST
curl

Autoritzacions

X-Transaction-Token
string
header
requerit

Token d'abast limitat de curta durada generat pel teu backend mitjançant POST /v3/transactions/sdk-token/. Utilitzat pels SDK de Didit als endpoints /v1/transactions/ orientats al dispositiu.

Cos

application/json
txnId
string
requerit

El teu identificador únic per a aquesta transacció (correspon a transaction_id, màxim 128 caràcters).

Exemple:

"wd-2026-07-07-0042"

type
string
requerit

Categoria de la transacció (s'assigna a transaction_category), p. ex., finance, kyc, travelRule, userPlatformEvent, gamblingBet.

Exemple:

"travelRule"

info
object
requerit

Detalls financers principals de la transacció (correspon a transaction_details).

subject
object
requerit

El subjecte (sol·licitant) de la transacció. externalUserId s'ignora aquí: la identitat del subjecte es determina sempre a partir de vendor_data del token.

txnDate
string<date-time>

Quan va tenir lloc la transacció (s'assigna a transaction_at). Per defecte pren l'hora actual si s'omet.

zoneId
string

Identificador de zona horària IANA (es correlaciona amb time_zone), p. ex. Europe/Madrid.

counterparty
object

La contrapart de la transacció (opcional). Té la mateixa estructura que subject; externalUserId és rellevant aquí.

props
object

Parells clau-valor personalitzats (s'assignen a custom_properties). Cada clau es pot referenciar a les condicions de les regles com a custom_values.<key>.

travelRule
object

Detalls de Travel Rule (es correlaciona amb travel_rule_details). Quan Travel Rule està activat per a l'aplicació, Didit ignora qualsevol status que enviïs i gestiona l'intercanvi directament.

includeCryptoScreening
boolean | null

Sobreescriptura per transacció per al cribratge d'analítica blockchain de criptomonedes (s'assigna a include_crypto_screening).

fingerprint_v2
object

El payload d'empremta digital del dispositiu didit-fp-v2. Injectat automàticament pels SDK; només és rellevant quan es crida directament a la wire API.

Resposta

Transacció enviada i monitorada. Mateixa estructura de detall que GET /v3/transactions/{transaction_id}/, incloent-hi el bloc action_required quan l'usuari final ha de completar una acció de seguiment (els SDK la inicien automàticament per defecte).

Registre complet de monitoratge per a una transacció, tal com el retornen GET /v3/transactions/{transaction_id}/ i POST /v3/transactions/.

uuid
string<uuid>

Identificador de transacció estable de Didit. Fes-lo servir com a {transaction_id} per a les crides de seguiment.

environment
enum<string>

Entorn de l'aplicació propietària de la transacció. Una transacció sandbox s'emmagatzema però mai s'avalua, se sotmet a cribratge, es notifica ni es factura, de manera que el seu rule_runs buit significa "no avaluada".

Opcions disponibles:
live,
sandbox
transaction_number
integer

Número seqüencial de transacció en l'àmbit de l'aplicació que es mostra a la consola (p. ex. 4123).

txn_id
string

El transaction_id que has proporcionat en el moment de la creació (màx. 128 caràcters). Únic per aplicació.

txn_date
string<date-time>

Quan va tenir lloc la transacció (a partir de transaction_at; per defecte pren l'hora d'enviament).

zone_id
string | null

Identificador de zona horària IANA proporcionat en el moment de la creació.

transaction_type
string

Categoria de primer nivell tal com s'emmagatzema: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent. Tingues en compte que els valors de diverses paraules es retornen en camelCase fins i tot quan s'envien en snake_case.

action_type
string

Subtipus dins de la categoria (p. ex. deposit, withdrawal, transfer). Per defecte pren la categoria quan no s'especifica.

direction
enum<string>

Direcció relativa al subjecte. S'emmagatzema en majúscules independentment de les majúscules o minúscules enviades (s'accepten in/out/inbound/outbound a l'entrada).

Opcions disponibles:
INBOUND,
OUTBOUND
status
enum<string>

Veredicte de monitoratge actual. Les transaccions es creen com a APPROVED; les regles poden canviar-les a IN_REVIEW/DECLINED de manera sincrònica.

Opcions disponibles:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
source
enum<string>

Com s'ha originat el registre: LIVE per a transaccions enviades a través de l'API o l'SDK, IMPORTED per a transaccions carregades mitjançant la importació des de la consola.

Opcions disponibles:
LIVE,
IMPORTED
amount
string

Import de la transacció com a cadena decimal sense els zeros finals (p. ex., "1500", "0.5", "0.123456789012345678"). Fins a 18 decimals.

currency
string

Codi de moneda de amount. S'accepta qualsevol codi alfabètic ISO 4217 (p. ex. EUR, USD, NGN), així com un símbol d'actiu cripto (p. ex. BTC). És preferible utilitzar un codi actualment en circulació. No tots els codis acceptats tenen tipus de canvi: quan no n'hi ha cap de disponible per al codi (per exemple, la unitat de compte ISO XSU, o un símbol cripto que Didit no cotitza), la conversió automàtica falla i preferred_currency_amount es retorna null tret que la sol·licitud hagi proporcionat un amount_in_default_currency preconvertit.

currency_type
string | null

fiat o crypto, tal com s'ha indicat a currency_kind.

amount_in_default_currency
string | null

Import preconvertit que has proporcionat, com a cadena decimal sense zeros finals.

default_currency_code
string | null
preferred_currency_amount
string | null

amount convertit a la moneda preferida de l'aplicació, quan estigui disponible.

preferred_currency_code
string | null
payment_details
string | null

Referència de pagament o concepte de text lliure de l'enviament.

payment_txn_id
string | null

Referència del sistema de pagament extern (p. ex. hash de la transacció a la blockchain) de payment_reference_id.

score
integer

Puntuació de risc acumulada per les regles (normalment 0–100). Com més alta, més risc.

severity
enum<string> | null

Gravetat de risc categòrica establerta per regles/proveïdors (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). null fins que algun element l'estableixi.

Opcions disponibles:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

Motiu llegible per màquina per a l'status actual.

decision_reason_label
string | null

Etiqueta fàcil de llegir per a decision_reason_code.

vendor_data
string | null

Còpia de conveniència del vendor_data del sol·licitant.

metadata
object

Instantània dels payloads de subject i counterparty tal com es van enviar en el moment de la creació.

props
object

Les custom_properties que has proporcionat en crear. Cada clau es pot referenciar en les condicions de les regles com a custom_values.<key>.

tags
object[]

Etiquetes adjuntades a la transacció (manualment o per regles).

parties
object[]

Parts de la transacció (sol·licitant, contrapart).

payment_methods
object[]

Mètodes de pagament vinculats a la transacció.

documents
object[]

Fitxers adjunts a la transacció des de la consola. [] quan no n'hi ha cap.

activities
object[]

Entrades del registre d'activitat (creació, notes, revisions manuals, canvis d'estat).

alerts
object[]

Sempre buit actualment. Una alerta oberta és una transacció amb estat IN_REVIEW o AWAITING_USER.

rule_runs
object[]

Resultats d'execució per regla: quina regla s'ha activat, amb quin impacte en la puntuació.

provider_results
object[]

Payloads en brut dels proveïdors (Cribratge AML, anàlisi de blockchain, etc.).

travel_rule
object | null

Transferència o comprovació de Travel Rule. S'emplena quan s'ha enviat travel_rule_details, i també quan Travel Rule està activat i la transacció s'ha creat amb transaction_category: travelRule (Didit inicia l'intercanvi directament, fins i tot sense travel_rule_details). null quan no existeix cap transferència o comprovació. En una transferència entrant, els camps originator_data i beneficiary_data de la contrapart romanen emmascarats (data_masked: true) fins que es confirma la titularitat de la cartera.

network_snapshot
object | null

Instantània del graf de transaccions/parts relacionades utilitzada pel motor de regles. O bé el network_snapshot enviat amb la transacció o bé el graf que Didit construeix a partir d'un cribratge AML de carteres satisfactori (que substitueix el que s'hagi enviat). null quan cap dels dos existeix.

remediation
object | null

Sessió de correcció oferta a l'usuari quan es requereix una reverificació. Substituïda per action_required, que és el bloc canònic; es manté per compatibilitat amb versions anteriors.

action_required
Verification session · object

Acció pendent de l'usuari final necessària per completar aquesta transacció, o null si no n'hi ha cap. Els SDK de Didit inicien automàticament l'acció per defecte i actualitzen la transacció quan finalitza. Dues variants, discriminades per type: verification_session (una sessió de verificació allotjada creada per una acció de regla) i wallet_ownership (una sessió de widget de titularitat de la cartera generada automàticament per a una transferència de Travel Rule que necessita un comprovant de control de la cartera, regulada per la configuració de Travel Rule auto_wallet_verification). Quan totes dues es podrien aplicar, wallet_ownership té prioritat perquè bloqueja l'intercanvi de Travel Rule.

cost_breakdown
object | null

Cost d'aquesta transacció: total_price i items, un per càrrec, cadascun amb usage_type, price, details i created_at. Un nou cribratge de la mateixa transacció és un element nou.

Darrera modificació el 7 de novembre del 2026