# Provar en sandbox sense gastar crèdits

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

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.

![La pàgina de claus d'API a la consola de Didit, on cada clau pertany a una aplicació](https://help.didit.me/screenshots/api-keys-light.webp)

*Les claus són per aplicació, així que una clau de sandbox mai pot arribar a dades en producció.*

1. **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.

2. **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.

3. **Crea o copia un workflow**

   Sandbox té workflows propis. Crea el que vols provar o copia’l de Live.

4. **Crea sessions normalment**

   El mateix endpoint, el mateix camí de codi. L'única diferència és quina clau envies.

> **Note:** 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 |

> **Warning:** 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ó.

> **Tip:** 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](https://docs.didit.me/integration/sandbox-testing).

## 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.