Mzunguko wa Maisha wa Vipindi vya KYB: Hali na Webhooks (SW)

Uthibitishaji wa KYB si jibu moja la ndiyo/hapana — ni mchakato wenye sehemu zinazobadilika. Utafutaji wa usajili unaweza kuidhinisha papo hapo huku uthibitishaji wa hati ukisubiri kuwasilishwa upya na AML ya huluki ikiwa katika mapitio ikisubiri mchambuzi. Ili kuunganisha KYB vizuri, unahitaji kujua hasa kila sehemu ya uthibitishaji iko katika hali gani, na unahitaji mifumo yako kusasishwa mara tu hali hizo zinapobadilika. Hiyo ndiyo maana ya mzunguko wa maisha wa kipindi na webhooks.

API ya Uthibitishaji wa Biashara ya Didit inaonyesha mashine kamili ya hali: hali ya kipindi kwa ujumla, hali ya kila kipengele, seti tofauti ya hali kwa huluki ya biashara mara tu inapokuwa chini ya usimamizi, na webhooks zinazowasha kila mabadiliko. Uthibitishaji kamili wa kampuni ni $2.00, na mwongozo huu unaonyesha mzunguko mzima wa maisha — kila hali, kila webhook, na API ya usimamizi inayounganisha yote.

Mambo muhimu

• Tabaka tatu za hali. Uthibitishaji wa KYB una hali ya kipindi, hali za kila kipengele, na — mara tu inaposimamiwa — hali ya huluki ya biashara.
• Hali nane za kipindi. NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, EXPIRED.
• Hali sita za kipengele kwenye kila moja ya vipengele vinne vya KYB: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED, AWAITING_USER.
• Hali tatu za huluki chini ya usimamizi: ACTIVE, FLAGGED, BLOCKED.
• Webhooks kwenye kila kitu. status.updated na data.updated (pamoja na session_kind: business) kwa vipindi; business.status.updated na business.data.updated kwa huluki zinazosimamiwa.
• API kamili ya usimamizi — POST /v3/businesses/create/, GET /v3/businesses/, GET /v3/businesses/{vendor_data}/, PATCH .../update-status/.

Nini mzunguko wa maisha wa KYB unashughulikia

Uthibitishaji wa KYB hutoa hali katika tabaka tatu, na kila moja hujibu swali tofauti:

• Kipindi hujibu "uthibitishaji unaendeleaje kwa ujumla?"
• Kila kipengele hujibu "usajili / AML ya kampuni / hati / ukaguzi wa watu muhimu ukoje?"
• Huluki ya biashara hujibu "hali ya uendeshaji wa kampuni hii katika mfumo wetu hivi sasa ni ipi?"

Unasoma zote tatu, na unaziweka sawa na webhooks badala ya kupiga kura. Uthibitishaji huanza kama kipindi, hutatua vipengele vyake, huishia kwenye matokeo ya jumla, na kisha — mara tu unapoanza kusimamia kampuni — hubeba hali ya huluki ya biashara unayoidhibiti kadri hali zinavyobadilika.

Kwa nini ni muhimu

Bila hali yenye maelezo ya kina, ujumuishaji wa KYB hudhoofika na kuwa kubashiri: bendera moja ya "inasubiri" haikwambii chochote kuhusu ni ukaguzi gani unaosababisha kuchelewa au ni hatua gani ingeondoa kikwazo. Kwa hali za kila kipengele, unaweza kuelekeza kwa usahihi — muombe mwombaji awasilishe hati upya, weka foleni ya AML ya huluki kwa ukaguzi wa mchambuzi, mshawishi UBO kumaliza KYC yao — badala ya kufeli uthibitishaji mzima.

Webhooks ni muhimu kwa sababu KYB ni asynchronous. Data ya usajili, OCR ya hati, na matokeo ya uchunguzi hufika kwa nyakati tofauti, na ukaguzi wa binadamu huchukua muda mrefu zaidi. Kupiga kura kwa mabadiliko ni kupoteza na polepole; webhooks husukuma mabadiliko mara tu yanapotokea, ili rekodi zako zionyeshe ukweli bila kazi ya cron kupiga API.

Maelezo ya kiufundi

Kipindi cha KYB huundwa dhidi ya API iliyounganishwa ya /v3/ na huripoti hali yake ya mzunguko wa maisha.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your_kyb_workflow_id",
    "vendor_data": "merchant_6601",
    "callback": "https://yourapp.com/kyb/callback"
  }'

Webhook ya status.updated hubeba hali ya kipindi na hali za kila kipengele:

{
  "event": "status.updated",
  "session_kind": "business",
  "session_id": "kyb_3a90f1c2",
  "vendor_data": "merchant_6601",
  "status": "IN_REVIEW",
  "features": {
    "kyb_registry": "APPROVED",
    "kyb_company_aml": "IN_REVIEW",
    "kyb_documents": "RESUB_REQUESTED",
    "kyb_key_people": "APPROVED"
  }
}

Hali za kipindi. NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, EXPIRED.

Hali za kipengele. Kila moja ya kyb_registry, kyb_company_aml, kyb_documents, na kyb_key_people huripoti mojawapo ya: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED, AWAITING_USER.

Webhooks. Kwa vipindi: status.updated (mabadiliko ya mzunguko wa maisha) na data.updated (data iliyoboreshwa), zote zikiwa na session_kind: "business". Kwa huluki zinazosimamiwa: business.status.updated na business.data.updated.

Bei. $2.00 kwa uthibitishaji wa kampuni.

Kusimamia huluki ya biashara

Mara tu kampuni inapothibitishwa, inakuwa huluki unayoisimamia kupitia API ya biashara:

• POST /v3/businesses/create/ — sajili huluki ya biashara.
• GET /v3/businesses/ — orodhesha biashara zinazosimamiwa.
• GET /v3/businesses/{vendor_data}/ — pata biashara moja kwa rejeleo lake la vendor_data.
• PATCH .../update-status/ — badilisha hali ya huluki.

Huluki hubeba hali yake yenyewe, huru na kipindi cha uthibitishaji: ACTIVE (katika hali nzuri), FLAGGED (chini ya ukaguzi kwa ishara ya hatari), au BLOCKED (imesimamishwa). Hii ni safu ya uendeshaji — kampuni inaweza kukamilisha kipindi cha APPROVED na baadaye kuwekewa FLAGGED kwa sababu ufuatiliaji umegundua kitu. Mabadiliko kwa huluki hutuma business.status.updated na business.data.updated ili mifumo ya chini ibaki ya kisasa.

Mzunguko wa maisha, mwanzo hadi mwisho

Uthibitishaji wa kawaida huenda kwenye tabaka kwa mpangilio. Kipindi huanza kwa NOT_STARTED, huhamia IN_PROGRESS kadri vipengele vinavyoendeshwa, na kila kipengele kinatatuliwa — usajili APPROVED, hati labda RESUB_REQUESTED hadi upakiaji safi ufike, AML ya kampuni IN_REVIEW hadi mchambuzi aondoe mechi, watu muhimu APPROVED. Wakati kila kipengele kinapotulia, kipindi huishia kwenye APPROVED, DECLINED, au IN_REVIEW. Kutoka hapo kampuni inaingia usimamizi kama huluki ACTIVE, na hali yake inaweza baadaye kuhamia FLAGGED au BLOCKED kadri usimamizi unavyodai — kila mabadiliko yakitumwa kwako na webhook.

Matumizi

• Masoko huelekeza wauzaji kwa usahihi: wasilishe hati upya, maliza KYC ya UBO, au shikilia mechi ya AML ya huluki — bila kufeli usajili mzima.
• Majukwaa ya Fintech na benki huweka rekodi za akaunti za kampuni zikiwa sawa na webhooks badala ya kupiga kura, na huweka bendera au kuzuia huluki kadri hatari inavyobadilika.
• Watoa huduma za mikopo hufuatilia hali ya kila ukaguzi wa malipo na kusasisha hali ya mkopaji kupitia API ya usimamizi.
• Majukwaa ya Crypto B2B hudumisha mzunguko wa maisha unaoweza kukaguliwa wa kila huluki ya mshirika kutoka uthibitishaji hadi hali inayoendelea.

Jinsi ya kuunganisha na Didit

1. Jenga mtiririko wa kazi. Katika Dashibodi ya Biashara, unda mtiririko wa kazi wa KYB na vipengele unavyohitaji.
2. Unda kipindi. POST /v3/session/ na workflow_id yako ya KYB na rejeleo la vendor_data.
3. Jisajili kwa webhooks. Shughulikia status.updated na data.updated (session_kind: business) kwa vipindi, na business.status.updated / business.data.updated kwa huluki zinazosimamiwa.
4. Simamia huluki. Tumia POST /v3/businesses/create/, GET /v3/businesses/, GET /v3/businesses/{vendor_data}/, na PATCH .../update-status/ ili kuweka kila kampuni ACTIVE, FLAGGED, au BLOCKED.

Kwa sababu yote iko kwenye API iliyounganishwa ya /v3/, mfumo huo huo wa mzunguko wa maisha unatumika kwenye KYC, ufuatiliaji, na KYB — mashine moja thabiti ya hali kwa jukwaa zima la utambulisho na udanganyifu.

Maswali yanayoulizwa mara kwa mara

Hali za kipindi cha KYB ni zipi?

NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, na EXPIRED.

Ni hali gani vipengele binafsi huripoti?

Kila moja ya kyb_registry, kyb_company_aml, kyb_documents, na kyb_key_people huripoti NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED, au AWAITING_USER.

Ni webhooks gani ninapaswa kujiandikisha?

Kwa vipindi, status.updated na data.updated (pamoja na session_kind: business). Kwa huluki za biashara zinazosimamiwa, business.status.updated na business.data.updated.

Ninawezaje kubadilisha msimamo wa kampuni baada ya uthibitishaji?

Tumia API ya usimamizi — PATCH .../update-status/ — kuweka huluki kuwa ACTIVE, FLAGGED, au BLOCKED.

Uthibitishaji wa KYB unagharimu kiasi gani?

$2.00 kwa kila kampuni kwa uthibitishaji kamili — usajili, UBO, maafisa, na AML ya huluki.

Uko tayari kuanza?

Soma muhtasari wa Uthibitishaji wa Biashara katika nyaraka, angalia jinsi inavyolingana na sehemu nyingine ya jukwaa kwenye ukurasa wa bidhaa wa Uthibitishaji wa Biashara, na uangalie bei za uwazi za kila simu kwenye ukurasa wa bei. Ukiwa tayari, anza bure — ukaguzi 500 wa KYC bila malipo kila mwezi, na uthibitishaji wa biashara kwa $2.00 kwa kila kampuni.