API ya Ufuatiliaji wa Miamala: Kanuni za Wakati Halisi, Udhibiti wa Kesi & Mtiririko wa Kazi wa SAR (SW)

Kusajili mtumiaji na KYC hukupa taarifa kuhusu wao ni nani siku ya kwanza. Hakukupi taarifa yoyote kuhusu wanachofanya siku ya tisini. Ufuatiliaji wa miamala ni nusu nyingine ya kufuata sheria — safu endelevu inayofuatilia mzunguko wa pesa na kuashiria mifumo muhimu: upangaji muundo, kuingia na kutoka haraka, ongezeko la kasi, washirika waliozuiliwa, na maeneo yenye hatari kubwa.

API ya Ufuatiliaji wa Miamala ya Didit ni injini ya sheria ya wakati halisi kwa ajili ya hilo. Unatuma muamala, inatoa uamuzi ndani ya milisekunde, na chochote kinachosababisha sheria huangukia kwenye meneja wa kesi aliyejengewa ndani ambapo wachambuzi wako huchunguza, kupanda ngazi, na kuwasilisha Ripoti za Shughuli Zinazotiliwa Mashaka (SARs). Inafanya kazi kwa fiat na crypto, na inagharimu $0.02 kwa kila muamala bila viwango vya chini.

Mwongozo huu unaeleza jinsi inavyofanya kazi, injini ya sheria inakuja na nini, na jinsi ya kuiunganisha.

Mambo muhimu

• Uamuzi wa wakati halisi. Kila muamala hurejesha mojawapo ya hali nne — APPROVED, IN_REVIEW, DECLINED, au AWAITING_USER — ili uweze kuchukua hatua kabla pesa hazijatulia.
• Vifurushi 11 vya sheria vilivyojengewa ndani vinashughulikia AML/CTF, utambuzi wa kasoro, mifumo ya FATF, akili ya kifaa, udanganyifu, ufuatiliaji wa crypto, uchunguzi wa crypto, michezo ya kubahatisha inayowajibika, na biashara ya mtandaoni. Jenga yako mwenyewe juu yake.
• Udhibiti wa kesi uliojengewa ndani na mtiririko wa kazi wa SAR — arifa, ugawaji wa wachambuzi, hali za uchunguzi, na uwasilishaji wa SAR huishi ndani ya bidhaa moja, sio chombo tofauti.
• Urekebishaji wa kiotomatiki wa AWAITING_USER huruhusu muamala ulioashiriwa kusababisha hatua ya uthibitisho (re-KYC, uthibitisho wa fedha) na kuendelea kiotomatiki mara tu mtumiaji anapouidhinisha.
• Fiat na crypto katika injini moja. Miamala ya Crypto inaweza kusababisha uchunguzi wa pochi ya mnyororo kiotomatiki.
• $0.02 kwa kila muamala, lipa-kwa-simu, bila viwango vya chini. Uchunguzi wa AML kwa chama kilichoashiriwa unatozwa kando kwa $0.20 kwa kila ukaguzi.

Nini ufuatiliaji wa miamala hufanya

Ukaguzi wa KYC ni picha ya papo hapo; ufuatiliaji wa miamala ni filamu. Mara tu mtumiaji anaposajiliwa, kila malipo, uhamisho, amana, uondoaji, dau, au biashara anayofanya ni ishara. Ikichunguzwa kibinafsi, ishara nyingi hizo ni kelele. Ikichunguzwa kama mkondo — na madirisha ya kasi, ujumlishaji, na muktadha wa mshirika — mifumo inayoashiria utapeli wa pesa, udanganyifu, au ukwepaji wa vikwazo huonekana.

Didit hupima kila muamala unavyotokea dhidi ya maktaba ya sheria, huambatanisha alama ya hatari, na hugawa hali. Miamala yenye hatari ndogo hupita kimya kimya. Chochote kinachovuka kizingiti hushikiliwa kwa ajili ya ukaguzi, kukataliwa kabisa, au kuelekezwa tena kwa mtumiaji kwa ajili ya kurekebisha — na arifa hufunguliwa kwa mchambuzi.

Kwa nini ni muhimu

Wadhibiti wanatarajia ufuatiliaji endelevu, sio tu ukaguzi wa usajili. Maagizo ya AML ya EU, mapendekezo ya FATF, na mifumo sawa duniani kote yote yanahitaji makampuni yaliyodhibitiwa kufuatilia miamala kwa msingi wa hatari na kuripoti shughuli zinazotiliwa mashaka. Njia za kushindwa ni ghali: upangaji muundo uliokosekana, washirika waliozuiliwa wasiotambuliwa, au muundo wa kasi unaogeuka kuwa mtandao wa punda.

Tatizo la uendeshaji ni halisi vile vile. Timu nyingi hukusanya ufuatiliaji kutoka kwa muuzaji wa sheria, chombo tofauti cha usimamizi wa kesi, na mchakato wa SAR wa mwongozo katika lahajedwali. Didit huanguka stack hiyo kuwa API moja na koni moja: sheria, arifa, uchunguzi, na kuripoti mahali pamoja, bei kwa kila muamala ili gharama ipatane na matumizi badala ya leseni za viti.

Maelezo ya kiufundi

Miamala huundwa dhidi ya API iliyounganishwa /v3/. Kila muamala ni sawa kwenye transaction_id unayoidhibiti (ya kipekee kwa kila programu), kwa hivyo majaribio ya kurudia kamwe hayatohesabu mara mbili.

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_8f3a91",
    "category": "finance",
    "amount": 9800,
    "currency": "EUR",
    "currency_kind": "fiat",
    "txn_date": "2026-05-21T10:32:00Z",
    "subject": {
      "vendor_data": "user_4521",
      "role": "SENDER",
      "entity_type": "INDIVIDUAL"
    },
    "counterparty": {
      "role": "RECEIVER",
      "entity_type": "INDIVIDUAL"
    },
    "payment_method": "BANK_TRANSFER"
  }'

Injini hupima muamala dhidi ya kila sheria inayotumika na hurejesha hali pamoja na sheria zilizosababisha:

{
  "transaction_id": "txn_8f3a91",
  "status": "IN_REVIEW",
  "risk_score": 62,
  "triggered_rules": [
    { "name": "Structuring — amount below reporting threshold", "bundle": "AML/CTF", "action": "ADD_SCORE" },
    { "name": "High velocity — sender 24h count", "bundle": "Anomaly detection", "action": "CHANGE_STATUS" }
  ],
  "alert_id": "alrt_2c70d4"
}

Hali. Kila muamala hutatua mojawapo ya nne:

Hali	Maana
APPROVED	Hakuna sheria iliyovuka kizingiti cha kukataa — muamala unaendelea.
IN_REVIEW	Sheria iliashiria muamala — arifa inafunguliwa kwa mchambuzi.
DECLINED	Sheria ngumu (mfano mshirika aliyewekewa vikwazo) ilizuia muamala.
AWAITING_USER	Muamala unashikiliwa ukisubiri hatua ya mtumiaji — uthibitisho upya au uthibitisho wa fedha.

Kategoria. Miamala hubeba category ili sheria zitume katika muktadha: finance, kyc, travel_rule, user_platform_event, gambling_bet, gambling_limit_change, gambling_bonus_change, na audit_trail_event.

Kasi na ujumlishaji. Sheria maalum hupima kwa nyakati na kuhesabu, kujumlisha, na ujumlishaji wa kuhesabu tofauti — ili uweze kueleza "uhamisho zaidi ya 5 kutoka kwa washirika tofauti ndani ya masaa 24" au "jumla ya kiasi zaidi ya €10,000 ndani ya siku 7" bila kuandika kichakataji chako cha mkondo.

Webhooks. Jisajili kwa transaction.created na transaction.status.updated ili kuweka leja yako sawa wakati mchambuzi anapotatua arifa.

Bei. $0.02 kwa kila muamala, inatozwa kwa kila simu, bila viwango vya chini. Ikiwa muamala ulioashiriwa unasababisha uchunguzi wa AML kwa chama, ukaguzi huo unatozwa kando kwa $0.20.

Vifurushi 11 vya sheria vilivyojengewa ndani

Huanza kutoka kwenye kitabu cha sheria kisicho na kitu. Didit huweka injini na vifurushi 11 unavyoweza kuwasha na kurekebisha:

1. Fedha — upangaji muundo, miamala mikubwa, kukwepa kizingiti.
2. AML/CTF — jumla ya kiasi, kuingia/kutoka haraka, vikwazo, mfiduo wa PEP, maeneo yenye hatari kubwa.
3. Utambuzi wa kasoro — ongezeko la kasi, uanzishaji upya wa akaunti isiyotumika, tabia zisizo za kawaida.
4. FATF — mifumo inayolingana na viashiria vya bendera nyekundu vya FATF.
5. Akili ya kifaa — alama ya kidole ya kifaa na ishara za hatari za kikao.
6. Uzuiaji wa udanganyifu — mifumo ya punda, akaunti nyingi, ishara za kuchukua akaunti.
7. Ufuatiliaji wa Crypto — mifumo ya miamala ya mnyororo.
8. Uchunguzi wa Crypto — hatari ya pochi na mfiduo wa chanzo cha fedha.
9. Michezo ya kubahatisha inayowajibika — kasi ya amana, mabadiliko ya kikomo, matumizi mabaya ya bonasi.
10. Biashara ya mtandaoni — mifumo ya malipo ya nyuma na matumizi mabaya ya kurejesha pesa.
11. Desturi — sheria zako mwenyewe na masharti, madirisha ya kasi, na ujumlishaji.

Kitendo cha kila sheria kinaweza kuongeza alama ya hatari, kubadilisha hali, kuongeza vitambulisho au maelezo, au kuongeza chama kwenye orodha — kwa hivyo sera inaonyeshwa wazi, na mabadiliko hukaguliwa kwenye Console badala ya kutumwa katika nambari.

Crypto, uchunguzi wa pochi, na Sheria ya Kusafiri

Weka currency_kind: "crypto" na mwelekeo (INBOUND au OUTBOUND) na injini inaweza kuendesha kiotomatiki uchunguzi wa pochi ya mnyororo kwenye anwani ya mshirika — kukagua mfiduo kwa vyombo vilivyowekewa vikwazo, masoko ya giza, vichanganyaji, programu za ukombozi, na fedha zilizoibiwa. Uchunguzi wa pochi huanza kwa $0.02 kwa kila uchunguzi na ufunguo wako mwenyewe (Crystal au Merkle Science).

Kwa Watoa Huduma za Mali Halisi, injini hiyo hiyo inasaidia Sheria ya Kusafiri ya FATF: ubadilishaji wa data ya asili na mnufaika na ufuatiliaji wa wajibu katika protokali, na hali maalum za sheria ya kusafiri (COMPLIANT, PENDING_ACTION, PENDING_COUNTERPARTY, EXEMPT, na zaidi). Bidhaa moja inashughulikia ufuatiliaji, uchunguzi, na Sheria ya Kusafiri.

Usimamizi wa kesi na mtiririko wa kazi wa SAR

Wakati sheria inapowashwa, arifa hufunguka. Didit husafirisha benchi la kazi ili kushughulikia — hakuna chombo tofauti cha kesi kinachohitajika.

• Arifa hubeba chanzo (kilichosababishwa na sheria, kilichosababishwa na mtoa huduma, au kilichoundwa na mchambuzi) na husogea kupitia hali: OPEN, INVESTIGATING, AWAITING_USER, PENDING_SAR, SAR_FILED, RESOLVED, DISMISSED.
• Kesi huunganisha arifa zinazohusiana, hushikilia kipaumbele na ukali, na hufuatilia uchunguzi kupitia OPEN, UNDER_REVIEW, AWAITING_USER, ON_HOLD, na RESOLVED.
• Wachambuzi hugawiwa, utendaji unapimika, na mtiririko wa kazi wa SAR huishi kwenye koni moja ambapo arifa ilitolewa.

Njia ya AWAITING_USER ndiyo inayofanya hili liwezekane kwa kiwango kikubwa: badala ya kukataa kabisa, muamala ulioashiriwa unaweza kusitishwa na kumuuliza mtumiaji kuuidhinisha — kuthibitisha utambulisho tena, kutoa uthibitisho wa fedha — kisha kuendelea kiotomatiki mara tu anapofanya hivyo. Msuguano hutokea tu ambapo hatari ipo.

Jinsi ya kuunganisha na Didit

1. Jenga mtiririko wa kazi. Katika Business Console, washa vifurushi vya sheria vinavyohusiana na biashara yako na rekebisha vizingiti. Mjenzi wa sheria maalum ni Console-pekee kwa makusudi, kwa hivyo kufuata sheria hukagua kila mabadiliko.
2. Tuma miamala. POST /v3/transactions/ kutoka kwa backend yako kadri pesa zinavyosogea. Tumia transaction_id thabiti kwa idempotency, na pitisha vendor_data ili miamala iunganishwe na mtumiaji au chombo cha biashara wanachomiliki.
3. Shughulikia webhooks. Sikiliza transaction.status.updated ili kuguswa wakati mchambuzi anapotatua arifa au urekebishaji wa AWAITING_USER unapokamilika.
4. Shughulikia arifa katika Console. Chunguza, panda ngazi hadi kesi, na uwasilishe SARs kutoka sehemu moja.

Kwa sababu yote iko kwenye API iliyounganishwa /v3/, kikao cha KYB kinaweza kuanzisha vikao vya KYC kwa ajili ya UBO zake, watumiaji hao huingia kwenye ufuatiliaji wa miamala, na muamala ulioashiriwa unaweza kuanzisha KYC ya kurekebisha — jukwaa moja la utambulisho na udanganyifu, mwisho hadi mwisho.

Maswali yanayoulizwa mara kwa mara

Ufuatiliaji wa miamala unagharimu kiasi gani?

$0.02 kwa kila muamala, inatozwa kwa kila simu bila viwango vya chini. Uchunguzi wa AML kwa chama kilichoashiriwa unatozwa kando kwa $0.20 kwa kila ukaguzi, na uchunguzi wa pochi ya mnyororo huanza kwa $0.02 kwa kila uchunguzi na ufunguo wako mwenyewe.

Je, inafanya kazi kwa crypto na fiat?

Ndiyo. Weka currency_kind kuwa fiat au crypto. Miamala ya Crypto inaweza kusababisha kiotomatiki uchunguzi wa pochi ya mnyororo na kusaidia Sheria ya Kusafiri ya FATF.

Je, ninahitaji kujenga chombo changu cha usimamizi wa kesi?

Hapana. Arifa, ugawaji wa wachambuzi, hali za uchunguzi, na mtiririko wa kazi wa SAR zimejengwa ndani ya bidhaa na koni moja.

Je, ninaweza kuandika sheria zangu mwenyewe?

Ndiyo. Juu ya vifurushi 11 vilivyopandwa unaweza kujenga sheria maalum na masharti, madirisha ya kasi, na ujumlishaji. Sheria zinasimamiwa katika Console kwa hivyo kufuata sheria hukagua kila mabadiliko.

Urekebishaji wa kiotomatiki wa AWAITING_USER ni nini?

Badala ya kukataa kabisa, muamala ulioashiriwa unaweza kusitishwa na kuomba hatua ya mtumiaji — uthibitisho upya au uthibitisho wa fedha — kisha kuendelea kiotomatiki mara tu mtumiaji anapouidhinisha.

Uko tayari kuanza?

Soma muhtasari wa Ufuatiliaji wa Miamala katika nyaraka, angalia jinsi inavyofaa sehemu nyingine ya jukwaa kwenye ukurasa wa bidhaa wa Ufuatiliaji wa Miamala, na angalia bei za uwazi za kila simu kwenye ukurasa wa bei. Unapokuwa tayari, anza bure — ukaguzi 500 wa KYC bila malipo kila mwezi, na ufuatiliaji wa miamala kwa $0.02 kwa kila simu.