Canvia a Sandbox amb el selector de sota el nom de l'aplicació, crea-hi una clau d'API i fes-la servir: les comprovacions se simulen i tries el resultat.
Canvia a Sandbox amb el selector sota el nom de l’aplicació, crea-hi una clau d’API i utilitza-la. Les comprovacions se simulen, no es factura res i pots triar el resultat.
El sandbox de Didit és l'equivalent a les targetes de prova d'un proveïdor de pagaments: et permet reproduir qualsevol resultat de verificació a demanda, sense trucar a proveïdors reals, sense tractar dades personals reals i sense tocar el teu saldo.
#Un entorn de proves separat
Sandbox és l’aplicació de proves compartida de l’organització. Conserva dades, claus, webhooks i llistes separats de Live. Una franja a la part superior indica l’entorn.
- Canvia a Sandbox
Prem Sandbox sota el nom de l’aplicació. Per tornar a Live, revisa la llista de publicació del workflow, clau o enllaç live, webhook, pagament i retenció, i confirma el canvi o queda’t a Sandbox.
- Crea una clau de sandbox
Obre Desenvolupadors → Claus d’API i tria Sandbox en crear-la. La clau determina l’entorn; una clau live no crea sessions sandbox.
- Crea o copia un workflow
Sandbox té workflows propis. Crea el que vols provar o copia’l de Live.
- Crea sessions normalment
El mateix endpoint, el mateix camí de codi. L'única diferència és quina clau envies.
Si Sandbox està desactivat, l’organització encara no té l’aplicació de proves. Demana a suport que l’activi; és una configuració del compte.
#Què canvia sandbox i què no
| Sandbox | Producció | |
|---|---|---|
| Proveïdors externs | Tots simulats - mai es truca a cap tercer | Reals |
| Facturació | Mai es factura; la comprovació de saldo se salta | Es factura per funció completada |
| Límit de creació de sessions | 500 cada 24 hores, per aplicació | El teu saldo |
| Payload del webhook | "environment": "sandbox" | "environment": "live" |
| Dades extretes i estat | Simulats segons l'escenari triat | Derivats de la captura real |
| Mèdia capturada | S'emmagatzema de debò, igual que en una sessió en producció | S'emmagatzema |
Sandbox emmagatzema la mèdia que captura - documents, selfie, vídeo de prova de vida, fitxers de prova de domicili - exactament com faria una sessió en producció. El resultat és simulat, però la pujada és real, així que fes servir els documents de mostra i les dades de prova que ofereix el flux en lloc d'un document d'identitat real o dades personals reals.
Com que els resultats mai depenen dels píxels, una foto deliberadament dolenta no produirà una denegació en sandbox. L'escenari és qui decideix.
#Triar el resultat
Passa un identificador d'escenari com a sandbox_scenario en crear la sessió, o deixa que la persona que fa la prova en triï un: les sessions de sandbox al flux allotjat mostren un selector d'escenaris dins de la targeta abans que comenci la captura, a més d'una franja de documents de mostra sota el component de pujada i un rètol persistent de "només dades de prova".
Els escenaris cobreixen els resultats que realment necessites per fer proves:
| Vols provar | Escenari |
|---|---|
| Tot s'aprova | approve |
| Document caducat | decline_document_expired |
| Document illegible | decline_could_not_recognize_document |
| Fallada de xifra de control MRZ | decline_mrz_validation |
| Per sota de l'edat mínima | decline_minimum_age |
| Coincidència facial massa baixa | decline_face_match_low_similarity |
| Atac de presentació en la prova de vida | decline_liveness_attack |
| Coincidència en sancions/PEP de AML | decline_aml_hit |
| Adreça IP bloquejada | decline_ip_blocklist |
| Discrepància d'adreça a la prova de domicili | decline_poa_address_mismatch |
| Fallada d'integritat del xip NFC | decline_nfc_chip_not_verified |
| La validació en base de dades no ha trobat res | decline_database_no_match |
| Cal revisió manual (AML) | review_aml_possible_match |
| Cal revisió manual (coincidència facial al límit) | review_face_match_borderline |
| Cal revisió manual (coincidència parcial d'adreça) | review_poa_partial_match |
| Discrepància amb el registre en KYB | decline_kyb_registry_mismatch |
Els escenaris review_* existeixen perquè puguis provar tot el camí de revisió manual - la cua de revisió a la consola, el webhook In Review, un revisor que aprova o demana un reenviament - sense necessitar una entrada de nivell de denegació.
El catàleg en directe d'escenaris i valors màgics es serveix des de la mateixa API a
GET /v1/sandbox/scenarios/. Si algun identificador d'aquí et sembla desactualitzat,
confia en l'endpoint. Referència completa: proves en sandbox.
#Distingir els dos entorns en el teu propi codi
Cada webhook porta un camp environment - "sandbox" o "live". Fes la teva lògica en funció d'aquest camp en lloc d'intentar deduir l'entorn a partir de la clau, i mai confondràs una sessió de prova amb un client real.
#Què no farà sandbox
- No retornarà dades reals de registre per a una empresa real. El KYB de sandbox fa servir respostes de registre simulades.
- No enviarà cap SMS o correu real. La verificació telefònica i de correu electrònic són simulades, així que no pots fer servir sandbox per previsualitzar l'entrega real de missatges.
- No consumirà el teu crèdit mensual del pla - cosa que també vol dir que una execució en sandbox no et diu res sobre el crèdit que et queda.
#Si necessites verificacions de prova reals
Algunes coses realment requereixen una crida en producció - comprovar que el servei de base de dades d'un país concret està activat per al teu compte, o confirmar l'entrega d'SMS a una operadora concreta. Això necessita una petita recàrrega en una aplicació de producció en lloc de sandbox. Consulta-ho amb el suport abans de gastar-hi res, perquè puguin confirmar primer que el servei estigui realment activat al teu compte.
Encara estàs encallat? Parla amb una persona.
Inclou l'ID de la teva organització i l'ID de la sessió sobre la qual preguntes.