Kanuni za Kasi na Kugundua Muundo: Mwongozo kwa Msanidi Programu (SW)

Ukiangalia malipo moja kwa kawaida hayakupi taarifa yoyote. Kiasi cha €9,700 kwa mhusika mwingine si jambo la ajabu. Lakini malipo kumi ya €9,700 kwa mhusika huyo huyo kwa siku tatu, au uhamisho ishirini unaoingia kutoka akaunti ishirini tofauti alasiri moja, ni saini za shughuli za uundaji na punda. Kuzibaini kunahitaji kuangalia miamala kama mkondo — kwa wakati, kwa kuhesabu na kujumlisha — si mmoja mmoja.

Hivyo ndivyo kanuni za kasi zinavyofanya, na ndio sehemu ngumu zaidi ya ufuatiliaji wa miamala kujijengea mwenyewe. Unahitaji kichakataji cha mkondo kinachodumisha madirisha yanayozunguka kwa kila mtumiaji, kuhesabu na kujumlisha na kuondoa marudio ya wahusika wengine ndani ya madirisha hayo, na kutathmini vizingiti kwa wakati halisi. API ya Ufuatiliaji wa Miamala ya Didit inakupa injini hiyo nje ya boksi: fafanua dirisha, chagua ujumlishaji — hesabu, jumla, au tofauti — weka kizingiti, na kanuni huendeshwa dhidi ya kila muamala kwa $0.02 kwa kila muamala.

Huu ni mwongozo wa msanidi programu wa kujenga kanuni za kasi na kuzitumia kugundua muundo.

Mambo muhimu ya kuzingatia

• Kanuni za kasi hutathmini kwa vipindi vya muda — “katika saa 24 zilizopita”, “katika siku 7” — badala ya kuweka alama kwenye muamala mmoja pekee.
• Ujumlishaji tatu: hesabu (ni ngapi), jumla (kiasi cha jumla), na tofauti (wahusika wengine wa kipekee au sifa) — vitalu vya ujenzi wa kugundua muundo na punda.
• Kuunda — malipo mengi chini ya kizingiti cha kuripoti — hubainishwa kwa kuchanganya dirisha la jumla na hali ya ukaribu wa kizingiti.
• Mifumo ya punda na ulanguzi hubainishwa kwa hesabu tofauti za wahusika wengine ndani ya dirisha.
• Hakuna kichakataji cha mkondo kinachohitajika — injini hudumisha madirisha; unatangaza kanuni kwenye Console.
• $0.02 kwa kila muamala, hakuna kiwango cha chini. Uchunguzi wa AML kwa chama kilichowekewa bendera hulipwa kando kwa $0.20.

Kanuni za kasi ni nini

Kanuni ya kasi ina sehemu tatu: dirisha (kipindi cha kuangalia nyuma — saa 1, saa 24, siku 7), ujumlishaji juu ya miamala katika dirisha hilo, na kizingiti ambacho, kinapovukwa, husababisha hatua. Ujumlishaji ndio kiini cha kueleza:

• hesabu — ni miamala mingapi iliyolingana na masharti ya kanuni katika dirisha. “Uhamisho zaidi ya 5 unaoingia katika saa 24.”
• jumla — thamani ya jumla ya miamala inayolingana. “Kiasi cha jumla zaidi ya €10,000 katika siku 7.”
• tofauti — idadi ya thamani za kipekee za sifa, kwa kawaida mhusika mwingine. “Uhamisho kutoka kwa watumaji zaidi ya 8 tofauti katika saa 24.”

Madirisha huwekwa funguo kwa kila somo kwa chaguo-msingi — kila mtumiaji ana kaunta zake za kuzunguka — kwa hivyo siku yenye shughuli nyingi kwa jukwaa lako lote haizamishe ishara ya mtumiaji mmoja.

Kwa nini ni muhimu

Kuunda (pia huitwa ulanguzi) ni mojawapo ya mbinu kongwe za utakatishaji fedha na mojawapo ya zile zinazodhibitiwa waziwazi. Vizingiti vya kuripoti — €10,000 katika sehemu kubwa ya EU, $10,000 nchini Marekani — huunda motisha ya kugawanya kiasi kikubwa katika malipo madogo ambayo kila moja hubaki chini ya mstari. Kanuni ya wakati mmoja inayochunguza tu kiasi kimoja kamwe haitaiona; mfumo mzima huishi katika jumla.

Hali kadhalika kwa mitandao ya punda. Ishara ya punda wa pesa si uhamisho wowote mmoja — ni mkusanyiko wa fedha kutoka akaunti nyingi tofauti ikifuatiwa na utawanyiko wa haraka. Unaiona tu kwa hesabu tofauti za wahusika wengine kwa dirisha. Wadhibiti wanatarajia kampuni kugundua aina hizi, na kanuni za kasi ndizo unazofanya hivyo bila kuanzisha stack yako mwenyewe ya uchanganuzi wa mkondo.

Maelezo ya kiufundi

Miamala huundwa dhidi ya API iliyounganishwa ya /v3/, isiyo na athari kwa transaction_id unayoidhibiti:

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_a19f04", \
    "category": "finance", \
    "amount": 9600, \
    "currency": "EUR", \
    "currency_kind": "fiat", \
    "txn_date": "2026-05-21T13:18:00Z", \
    "subject": { "vendor_data": "user_3310", "role": "SENDER", "entity_type": "INDIVIDUAL" }, \
    "counterparty": { "role": "RECEIVER", "entity_type": "INDIVIDUAL" }, \
    "payment_method": "BANK_TRANSFER" \
  }'

Muamala unapokamilisha muundo wa uundaji, kanuni ya kasi huwaka na jina la jibu:

{
  "transaction_id": "txn_a19f04",
  "status": "IN_REVIEW",
  "risk_score": 66,
  "triggered_rules": [
    {
      "name": "Kuunda — jumla ya jumla karibu na kizingiti",
      "bundle": "Fedha",
      "aggregation": "jumla",
      "window": "7d",
      "action": "BADILISHA_HALI"
    }
  ],
  "alert_id": "alrt_b4d8e1"
}

Webhooks. Jisajili kwa transaction.created na transaction.status.updated ili kuweka leja yako sawa alerts zinapotatuliwa.

Bei. $0.02 kwa kila muamala, hulipwa kwa kila simu, hakuna kiwango cha chini. Uchunguzi wa AML kwa chama kilichowekewa bendera hulipwa kando kwa $0.20.

Kujenga kanuni za uundaji na punda

Kuunda (dirisha la jumla). Unganisha ujumlishaji wa jumla juu ya dirisha la siku 7 na hali ya kila muamala kwamba kiasi kinakaa chini ya kizingiti chako cha kuripoti. Kanuni huwaka wakati jumla ya malipo ya mtumiaji yaliyo chini ya kizingiti yanapoongezeka na kupita mstari uliouweka — muamala mkubwa wa jumla ambao uundaji ulikusudiwa kuficha. Rekebisha ukaribu wa kizingiti (jinsi ilivyo karibu na mstari wa kuripoti inavyohesabika kama “chini ya”) na kichochezi cha jumla.

Ulanguzi (dirisha la hesabu). Ujumlishaji wa hesabu juu ya dirisha fupi hubaini mlipuko wa malipo madogo. “Uhamisho zaidi ya 10 unaotoka chini ya €1,000 katika saa 24” huonyesha mfumo wa kugawanyika hata wakati hakuna malipo moja makubwa.

Mkusanyiko wa punda (dirisha tofauti). Ujumlishaji wa tofauti kwa mhusika mwingine hubaini mkusanyiko: “Uhamisho unaoingia kutoka kwa watumaji zaidi ya 8 tofauti katika saa 24.” Unganisha na kanuni ya hesabu ya utawanyiko wa haraka na umefafanua saini kamili ya punda.

Haya yanalingana na vifurushi vilivyopandikizwa — uundaji na kuepuka kizingiti huishi katika Fedha, kiasi cha jumla na kuingia/kutoka haraka katika AML/CTF, spikes za kasi katika Kugundua kasoro — na unaweza kupanua yoyote kati yao, au kujenga yako mwenyewe, katika kifurushi cha Custom. Kitendo cha kila kanuni kinaweza kuongeza kwenye alama ya hatari, kubadilisha hali, kuongeza vitambulisho, au kuongeza chama kwenye orodha.

Matukio ya matumizi

• Fintech — kanuni za uundaji wa jumla-jumla kwa uhamisho na uondoaji; kanuni tofauti za punda kwa amana zinazoingia.
• Crypto — madirisha ya hesabu kwa shughuli za haraka za kuingia na kutoka kwa pochi; kanuni tofauti kwa fedha zinazofika kutoka anwani nyingi kabla ya utokaji mkubwa mmoja.
• Ukopeshaji — kanuni za kasi juu ya mifumo ya utoaji na ulipaji ili kubaini udanganyifu wa kuvunja mikataba.
• Soko — kanuni tofauti za hesabu ya wanunuzi ili kubaini pete za miamala za udanganyifu zinazoongeza kiasi cha muuzaji.
• iGaming — madirisha ya hesabu ya kasi ya amana ambayo pia hufanya kama ishara ya michezo ya kubahatisha inayowajibika.

Jinsi ya kuunganisha na Didit

1. Fafanua madirisha. Katika Console ya Biashara, jenga kanuni za kasi na dirisha, ujumlishaji (hesabu/jumla/tofauti), na kizingiti ambacho sera yako inahitaji.
2. Tuma miamala. POST /v3/transactions/ kutoka kwa backend yako kadri pesa zinavyosonga, na transaction_id thabiti na vendor_data ili injini iweke funguo za madirisha kwa somo sahihi.
3. Shughulikia webhooks. Sikiliza transaction.status.updated ili kuguswa wakati kanuni ya kasi inapowashwa na mchambuzi anatatua arifa.
4. Rekebisha kwa muda. Rekebisha vizingiti kwenye Console unapoendelea kujifunza viwango vyako vya kweli-chanya na chanya-bandia — hakuna usanidi unaohitajika.

Kwa sababu yote iko kwenye API iliyounganishwa ya /v3/, mtumiaji aliyeingia na mtiririko wa KYC moja kwa moja kwenye injini hiyo hiyo inayoendesha kanuni hizi za kasi — jukwaa moja la utambulisho-na-udanganyifu, mwisho hadi mwisho.

Maswali yanayoulizwa mara kwa mara

Ujumlishaji gani kanuni ya kasi inaweza kutumia?

Tatu: hesabu (idadi ya miamala inayolingana), jumla (kiasi cha jumla), na tofauti (wahusika wengine wa kipekee au sifa), kila moja ikitathminiwa kwa kipindi cha muda unachofafanua.

Ninawezaje kubaini muundo hasa?

Unganisha ujumlishaji wa jumla juu ya dirisha na hali kwamba kila malipo yanaketi chini ya kizingiti chako cha kuripoti. Kanuni huwaka wakati jumla ya jumla inavuka mstari ambao muundo ulikusudiwa kuficha.

Je, ninahitaji kichakataji changu mwenyewe cha mkondo?

Hapana. Injini hudumisha madirisha yanayozunguka kwa kila somo. Unatangaza dirisha, ujumlishaji, na kizingiti kwenye Console.

Inagharimu kiasi gani?

$0.02 kwa kila muamala, hulipwa kwa kila simu bila viwango vya chini. Uchunguzi wa AML kwa chama kilichowekewa bendera hulipwa kando kwa $0.20.

Je, ninaweza kujenga kanuni za kasi ambazo vifurushi vilivyopandikizwa havifuniki?

Ndio. Kifurushi cha Custom kinaunga mkono masharti, madirisha ya kasi, na ujumlishaji kwa aina yoyote ya kipekee kwa bidhaa yako.

Uko tayari kuanza?

Soma muhtasari wa Ufuatiliaji wa Miamala katika nyaraka, angalia jinsi inavyolingana na jukwaa lingine kwenye ukurasa wa bidhaa ya Ufuatiliaji wa Miamala, na uangalie bei ya uwazi kwa kila simu kwenye ukurasa wa bei. Unapokuwa tayari, anza bure — hundi 500 za KYC za bure kila mwezi, na ufuatiliaji wa miamala kwa $0.02 kwa kila simu.