# Kujaribu kwenye sandbox bila kutumia salio

Source: https://help.didit.me/sw/getting-started/sandbox-and-testing
Updated: 2026-10-12

Chagua Sandbox kwa swichi chini ya jina la programu, unda ufunguo wa API wa majaribio na uutumie. Ukaguzi huigwa, hakuna malipo na unaweza kuchagua matokeo.

Chagua **Sandbox** kwa swichi chini ya jina la programu, unda ufunguo wa API wa majaribio na uutumie. Ukaguzi huigwa, hakuna malipo na unaweza kuchagua matokeo.

Sandbox ya Didit ni kama kadi za majaribio za mtoa huduma wa malipo: inakuwezesha kuiga matokeo yoyote ya uthibitisho unavyotaka, bila kupiga simu kwa watoa huduma halisi, bila kushughulikia data halisi ya kibinafsi, na bila kugusa salio lako.

## Mazingira tofauti ya majaribio

Sandbox ni programu ya majaribio inayoshirikiwa na shirika. Data, funguo, webhooks na orodha zake zimetenganishwa na Live. Utepe juu ya kila ukurasa huonyesha mazingira.

![Ukurasa wa funguo za API kwenye console ya Didit, ambapo kila ufunguo ni wa programu moja](https://help.didit.me/screenshots/api-keys-light.webp)

*Funguo ni za kila programu, hivyo ufunguo wa sandbox hauwezi kufikia data ya live.*

1. **Badili kwenda Sandbox**

   Bonyeza **Sandbox** chini ya jina la programu. Kabla ya kurudi **Live**, kagua orodha ya mtiririko uliochapishwa, ufunguo au kiungo cha Live, webhook, malipo na uhifadhi wa data; thibitisha au baki Sandbox.

2. **Unda ufunguo wa majaribio**

   Fungua **Wasanidi → Funguo za API** na uchague Sandbox unapounda ufunguo. Ufunguo huamua mazingira; ufunguo wa Live hauundi kipindi cha Sandbox.

3. **Unda au nakili mtiririko**

   Sandbox ina mitiririko yake. Unda unaotaka kujaribu au unakili kutoka Live.

4. **Unda vipindi kama kawaida**

   Njia ile ile, msimbo ule ule. Tofauti pekee ni ufunguo unaotuma.

> **Note:** Ikiwa **Sandbox** imezimwa, shirika halina programu ya majaribio bado. Omba usaidizi kuiwasha; ni mpangilio wa akaunti.

## Kinachobadilika kwenye sandbox, na kisichobadilika

| | Sandbox | Live |
|---|---|---|
| Watoa huduma wa nje | Wote wanaigwa - hakuna wa tatu anayepigiwa simu kamwe | Halisi |
| Malipo | Hakuna kutozwa kamwe; ukaguzi wa salio unarukwa | Unatozwa kwa kila kipengele kinachokamilika |
| Kikomo cha kuunda vipindi | 500 kwa saa 24, kwa kila programu | Salio lako |
| Payload ya webhook | `"environment": "sandbox"` | `"environment": "live"` |
| Data iliyotolewa na hali | Imeigwa kulingana na scenario uliyochagua | Imetokana na ukamataji halisi |
| Vyombo vilivyonaswa (media) | **Vinahifadhiwa kihalisia**, sawa kabisa na kipindi cha live | Vinahifadhiwa |

> **Warning:** Sandbox inahifadhi vyombo inavyonasa - hati, selfie, video ya liveness, faili za
> uthibitisho wa makazi - sawa kabisa na kipindi cha live kingefanya. **Matokeo**
> ndiyo yanayoigwa, lakini upakiaji ni halisi, hivyo tumia hati za mfano na data ya
> majaribio anazotoa mtiririko badala ya hati halisi ya kitambulisho au taarifa
> halisi za kibinafsi.

Kwa sababu matokeo hayategemei kamwe picha halisi, picha mbaya kimakusudi haitasababisha kukataliwa kwenye sandbox. Scenario ndiyo inayoamua.

## Kuchagua matokeo

Tuma scenario slug kama `sandbox_scenario` unapounda kipindi, au mwache mjaribu achague mwenyewe: vipindi vya sandbox kwenye mtiririko uliohifadhiwa huonyesha **kichagua scenario** ndani ya kadi kabla ya ukamataji kuanza, pamoja na mkanda wa hati za mfano chini ya sehemu ya kupakia na bango la kudumu la "test data only".

Scenario zinajumuisha matokeo unayohitaji kujengea:

| Unachotaka kujaribu | Scenario |
|---|---|
| Kila kitu kinaidhinishwa | `approve` |
| Hati iliyoisha muda | `decline_document_expired` |
| Hati isiyosomeka | `decline_could_not_recognize_document` |
| Kushindwa kwa checksum ya MRZ | `decline_mrz_validation` |
| Chini ya umri wa chini unaotakiwa | `decline_minimum_age` |
| Ulinganifu wa uso mdogo mno | `decline_face_match_low_similarity` |
| Shambulio la uwasilishaji kwenye liveness | `decline_liveness_attack` |
| Mgongano wa vikwazo/PEP wa AML | `decline_aml_hit` |
| Anwani ya IP iliyozuiwa | `decline_ip_blocklist` |
| Mgongano wa anwani kwenye uthibitisho wa makazi | `decline_poa_address_mismatch` |
| Chip ya NFC ilishindwa uadilifu | `decline_nfc_chip_not_verified` |
| Uthibitishaji wa hifadhidata haukupata kitu | `decline_database_no_match` |
| Inahitaji upitiaji wa mkono (AML) | `review_aml_possible_match` |
| Inahitaji upitiaji wa mkono (ulinganifu wa uso wa mpakani) | `review_face_match_borderline` |
| Inahitaji upitiaji wa mkono (mgongano wa sehemu wa anwani) | `review_poa_partial_match` |
| Mgongano wa usajili wa KYB | `decline_kyb_registry_mismatch` |

Scenario za `review_*` zipo ili uweze kufanya mazoezi ya njia nzima ya upitiaji wa mkono - foleni ya upitiaji kwenye console, webhook ya `In Review`, mpitiaji akiidhinisha au kuomba kuwasilishwa upya - bila kuhitaji uingizaji wa kiwango cha kukataliwa.

> **Tip:** Orodha hai ya scenario na thamani za uchawi (magic values) inatolewa na API yenyewe
> kupitia `GET /v1/sandbox/scenarios/`. Kama slug hapa ikiwahi kuonekana imepitwa na
> wakati, amini endpoint hiyo. Marejeo kamili: [majaribio ya sandbox](https://docs.didit.me/integration/sandbox-testing).

## Kutofautisha hizo mbili kwenye msimbo wako mwenyewe

Kila webhook hubeba sehemu ya `environment` - `"sandbox"` au `"live"`. Tumia hiyo badala ya kujaribu kukisia mazingira kutoka kwenye ufunguo, na hutakosea kamwe kudhania kipindi cha majaribio ni cha mteja halisi.

## Kisichofanywa na sandbox

- Haitarudisha data halisi ya usajili kwa kampuni halisi. KYB ya sandbox hutumia majibu ya usajili yaliyoigwa.
- Haitatuma SMS au barua pepe halisi. Uthibitisho wa simu na barua pepe umeigwa, hivyo huwezi kutumia sandbox kuona jinsi ujumbe halisi unavyofika kwa kweli.
- Haitatumia mkopo wako wa mpango wa kila mwezi - jambo ambalo pia linamaanisha kipindi cha sandbox hakikuambii chochote kuhusu mkopo wako uliobaki.

## Kama unahitaji uthibitisho halisi wa majaribio

Baadhi ya mambo yanahitaji kihalisi muito wa live - kuangalia kama huduma ya hifadhidata ya nchi fulani imewekwa kwa ajili yako, au kuthibitisha uwasilishaji wa SMS kwa mtandao fulani. Hilo linahitaji kuongeza salio kidogo kwenye programu ya live badala ya sandbox. Muulize usaidizi kabla ya kutumia fedha kwenye hilo, ili waweze kuthibitisha kwanza huduma hiyo imewashwa kwenye akaunti yako.