Kutuma matukio kwa ajili ya kupata alama za hatari kwa wakati halisi: mwongozo wa ujumuishaji

Ili kupata uamuzi wa hatari kwa wakati halisi, simu zako za nyuma zinapiga simuPOST /api/v1/transactionskwa kila malipo, uhamisho, amana au utoaji, naPOST /api/v1/activitieskwa kila kuingia, kujisajili, kuweka upya nenosiri, mabadiliko ya walengwa na tukio kama hilo la akaunti. Kila simu huleta uamuzi katika ombi lile lile:allow,reviewaublock, yenye alama, sababu kubwa zaidi na hatua inayofuata iliyopendekezwa. Msimbo wako unaweka kizuizi cha hatua kwenye uamuzi huo.

Mambo matatu huamua kama ujumuishaji huo ni mzuri: kupiga simu kwa wakati unaofaa (kabla ya pesa kuhamishwa, si baada ya), kutuma taarifa kamili kuhusu nani aliyetuma na nani aliyepokea fedha, na kutumia vitambulisho thabiti ili majaribio ya mara kwa mara yasijenge tathmini ya pili. Mwongozo huu unashughulikia kila moja, pamoja na maumbo ya ombi kutoka kwa nyaraka za ufuatiliaji wa matukio (hufunguka kwenye kichupo kipya) .

Upatikanaji. Sehemu hizi za mwisho ni za eneo la Ufuatiliaji wa Ulaghai la Toden Ujasusi wa Hatari, ambao unapatikana kwa akaunti zenye ufikiaji wake. Matumizi ya uzalishaji pia yanahitaji wasifu wa biashara ulioidhinishwa. Ikiwa sehemu za mwisho hazijawezeshwa kwa akaunti yako, zungumza na Toden kabla ya kujenga dhidi yao.

Kila tukio linahusu mwisho gani?

Shughulitypeni orodha iliyofungwa:login,signup,password_reset,beneficiary_added,profile_change,device_change,payoutnawithdrawal. Nyaraka zinasema kwamba uhamisho wa pesa kwa kutumia ushahidi wa mtumaji na mpokeaji huenda kwenye sehemu ya mwisho ya miamala, si kupitia sehemu ya mwisho ya shughuli kamapayout.

Simu inapaswa kuwekwa wapi katika mtiririko wako?

Kati ya uthibitisho wa mteja na hatua isiyoweza kutenduliwa. Chukua uhamisho wa benki unaoonyesha njia ya kutoka katika programu ya pochi:

1. Mteja anathibitisha uhamisho kwa mnufaika mpya.

2. Sehemu yako ya nyuma hutuma muamala na kusubiri jibu.

3. Inaelekea kwenyeassessment.summary.outcome.

4. Imewashwa pekeeallowJe, inawasilisha malipo kwa reli ya benki?

Kufunga baada ya malipo kuisha ni ufuatiliaji, ambao bado una thamani ya uchunguzi, lakini hauwezi kuzuia hasara. Ikiwa uamuzi ni kuweka kizuizi chochote, lazima kiwe cha kwanza. Toden hurejesha uamuzi; hauzuii akaunti katika ombi lako, kwa hivyo lango ni msimbo wako.

Ombi la kwanza linaonekanaje?

Simu zote za Risk Intelligence hutumia ufunguo wa siri kutoka sehemu yako ya nyuma:sk_test_dhidi yahttps://sandbox-api.toden.co/api/v1,sk_live_dhidi yahttps://api.toden.co/api/v1Node.js rasmi SDK ni@myazahq/trust-sdk( ESM -pekee, Node.js 20 au mpya zaidi), na huchagua mwenyeji kutoka kwaenvironmentchaguo. Kutoka kwa kuanza haraka kwa Akili ya Hatari (hufunguka kwenye kichupo kipya) :

import { Myaza } from '@myazahq/trust-sdk';

const myaza = new Myaza({
  apiKey: process.env.MYAZA_SECRET_KEY,
  environment: 'sandbox',
});

const assessment = await myaza.transactions.create({
  externalActivityId: 'activity_txn_10001',
  subject: { type: 'individual', externalUserId: 'user_42' },
  occurredAt: new Date().toISOString(),
  transaction: {
    externalTransactionId: 'txn_10001',
    assetClass: 'fiat',
    direction: 'outbound',
    amount: '48000.00',
    currency: 'NGN',
    transactionType: 'bank_transfer',
  },
}, { idempotencyKey: 'transaction-txn_10001' });

console.log(assessment.summary?.outcome, assessment.summary?.reason);

Kumbuka kwambaamountni kamba. API inachukua mfuatano chanya wa desimali wenye hadi nafasi nane za desimali, kwa hivyo pesa hazizungushwi kamwe kupitia nambari ya nukta inayoelea inapoingia.

Ombi hilo ni halali, lakini halijakamilika, na sehemu inayofuata ni kwa nini hilo ni muhimu.

Kwa nini vyama vina umuhimu sana?

Kwa sababu uchunguzi unategemea wao. MuamaladirectionDaima ni kutoka kwa mtazamo wa mteja wako, na Toden huchunguza upande mwingine wa harakati kabla ya kutoa uamuzi:

Nambari za akaunti ya benki huhifadhiwa kama ushahidi wa uhusiano na hazitumiwi kwa ajili ya uchunguzi. Ikiwa jina au pochi ambayo skrini inahitaji haipo, jibu ni uamuzi wa ukaguzi usio na sababu ya kutosha ya data, badala ya kuchukulia muamala kama wazi.

Hiyo ndiyo tabia sahihi, na inamaanisha kuwa ujumuishaji mwembamba hutoa foleni yenye shughuli nyingi ya ukaguzi. Tumapartiessafu. Kila mhusika anahitajirole(sender,recipient,customeraucounterparty), marejeleo moja thabiti (externalUserId,entityIdauexternalPartyId), na kwa ajili ya uchunguzi wa nje wa fiat adisplayNameAmbatisha akaunti au pochi kila mhusika anayetumika kama kifaa:

{
  "role": "recipient",
  "externalPartyId": "beneficiary_998877",
  "type": "individual",
  "displayName": "Amina Bello",
  "country": "NG",
  "instruments": [
    {
      "type": "bank_account",
      "externalInstrumentId": "beneficiary_account_998877",
      "identifier": "9988776655",
      "institutionName": "Recipient Bank",
      "country": "NG",
      "currency": "NGN"
    }
  ]
}

Ala mbichiidentifierimechukuliwa alama za vidole kwa ajili ya kulinganisha uhusiano na haijahifadhiwa katika hali ghafi. Ikiwa hupendi kutuma nambari ghafi, toa yako mwenyeweexternalInstrumentIdau iliyopofingerprintbadala yake.

Unatumaje shughuli ya akaunti?

Bahasha ile ile isiyo natransactionkizuizi, pamoja natype. Kuingia kwenye akaunti HTTP :

curl -X POST "https://sandbox-api.toden.co/api/v1/activities" \
  -H "Authorization: Bearer $MYAZA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalActivityId": "login_10001",
    "subject": { "type": "individual", "externalUserId": "user_42" },
    "type": "login",
    "occurredAt": "2026-08-16T09:30:00.000Z",
    "channel": "mobile_app",
    "deviceRef": "device_7f53",
    "ipAddress": "102.89.12.34",
    "country": "NG",
    "customAttributes": { "trustedDevice": false, "failedAttemptsBeforeSuccess": 2 }
  }'

Sehemu mbili zina thamani kubwa.deviceRefni marejeleo yako ya kifaa thabiti; kuitumia tena hujenga historia ya kifaa na ndiko kunakoruhusu ishara ya kifaa kipya kumaanisha chochote.ipAddresslazima iwe anwani ya mtumiaji wa mwisho .API haibadilishi IP ya seva yako, kwa hivyo ikiwa sehemu yako ya nyuma inasambaza simu, toa anwani ya mteja uliyoiona, sio yako mwenyewe.

Tuma ushahidi pekee ulioukusanya. Latitudo na longitudo lazima vitolewe pamoja, na eneo unalotoa linabaki kuwa la msingi kuliko chochote kilichobainishwa kutoka kwa IP.

Unapaswa kusomaje jibu?

Somaassessment.summarykwanza. Inashikiliaoutcome,title,reason,score,riskLevel,matchedRulesnanextAction, na inatosha kwa uelekezaji wa kawaida. Jibu lile lile pia lina sheria zilizounganishwa kwa kina, ushahidi wa uchunguzi na uchanganuzi wa bili kwa wakati mtu anapochunguza.decisionIdnaalertIddhidi ya muamala wako mwenyewe ili mtoa huduma aweze kupata ushahidi baadaye.

Tumia thamani za mashine (allow,review,block) kwa msimbo na uandike nakala yako mwenyewe inayomlenga mteja, kama nyaraka zinavyoshauri, badala ya kumpa mteja maandishi ya tathmini.

Unawezaje kujaribu tena bila kupata alama mbili?

Na vitambulisho thabiti:

• MojaexternalActivityIdkwa kila tathmini ya kimantiki, huwekwa sawa katika majaribio ya kurudia. Marudio hurejesha tathmini iliyopo nareplayed: truena haitoi alama au kuitoza tena.

• MojaexternalTransactionIdkwa kila muamala wa mteja.

• Kutumia tena kitambulisho chochote na marejesho tofauti ya data yasiyobadilika409(idempotency_conflictautransaction_id_conflictHilo ni hitilafu katika mpango wako wa kitambulisho, si kitu cha kujaribu tena.

• Tuma asilioccurredAtHaiwezi kuwa zaidi ya dakika tano katika siku zijazo, na Toden hurekodi matukio na muda wa kupokea, ili tukio lililochelewa libaki kuonekana bila kupotosha ratiba.

Nini kifanyike wakati uamuzi hautarudi?

Amua hili kabla ya uzinduzi, kwa sababu tabia iliyoandikwa ni kushindwa kufungwa. Makosa utakayokutana nayo:

Nyaraka za hitilafu (hufunguka kwenye kichupo kipya) zinaongeza hoja inayofaa kuandikwa kwenye kitabu chako cha utekelezaji: maamuzi ya muamala na shughuli hushindwa kufungwa wakati salio halipatikani, na rekodi ya kuchelewa si jibu la idhini. Ikiwa huwezi kupata uamuzi kwa wakati, bidhaa yako inahitaji sheria yake, kwa mfano kushikilia uhamisho wa nje juu ya kikomo unachochagua hadi uamuzi utakapofika. Andika sheria hiyo; usiruhusu muda wa kuisha kuwa chaguo-msingi "kuruhusu".

Bado unahitaji vivinjari vya wavuti?

Kwa shughuli, ndiyo. Jisajili kwafraud.transaction.assessednafraud.activity.assessedkupokea kila uamuzi, nascreening.match,risk.signal.creatednaalert.createdili kuchukua hatua kutokana na matokeo. Thibitisha kila sahihi dhidi ya kiini ghafi na uigawe kwa kutumia Kitambulisho cha tukio.event.flaggedinabaki tu kama jina bandia la utangamano kwa maamuzi yasiyoruhusiwa. Ikiwa uko kwenyePOST /api/identity/events, panga hatua hadi mwisho wa v1: umbo la zamani linaweza kupata alama katika tukio rahisi lakini haliwezi kubeba sherehe au vyombo vilivyopangwa.

Orodha ya ukaguzi

• Ufunguo wa siri na mwenyeji wa Risk Intelligence kwenye sehemu yako ya nyuma pekee;sk_test_na mwenyeji wa Sandbox wakati wa ujenzi.

• Miamala huitwa kabla ya fedha kuhamishwa; lango ni msimbo wako.

• partiesyenye majina au pochi kwa upande uliofunikwa wa kila harakati.

• Anwani ya IP ya mtumiaji wa mwisho na hali yako thabitideviceRefkwenye shughuli.

• ImaraexternalActivityIdnaexternalTransactionId, asilioccurredAt.

• Sheria iliyoandikwa kuhusu kinachotokea wakati hakuna uamuzi unaopatikana.

• Webhooks zimesajiliwa, zimethibitishwa na zimetolewa nakala.

Ukurasa wa bidhaa ya Ufuatiliaji wa Miamala unaelezea sheria na zana za uchunguzi nyuma ya maamuzi haya, na kitovu cha msanidi programu huunganisha marejeleo kamili.