Una organització conté el teu equip i la facturació; les aplicacions contenen fluxos i claus API, i cadascuna és live o sandbox. Entendre-ho evita confusions.
Organització = el teu equip, el teu saldo de facturació, el teu registre d'auditoria. Aplicació = fluxos de treball, claus API, endpoints de webhook, política de retenció i productes, en dos entorns: Producció i Sandbox. La majoria de problemes de "el meu canvi no ha tingut efecte" són qüestió d'estar a l'aplicació equivocada, o a l'entorn equivocat.
#Els dos nivells
Organització és el teu compte. Conté:
- El teu equip i els seus rols
- El teu saldo de facturació i les factures
- El teu registre d'auditoria
- Totes les teves aplicacions
Aplicació és un espai de treball dins de l'organització. Conté:
- Els seus propis fluxos de treball
- Les seves pròpies claus API
- Els seus propis endpoints de webhook
- La seva pròpia política de retenció de dades
- Els seus propis productes, allà on ja s'ha desplegat l'activació de productes per aplicació. Consulta els productes i què inclouen
- Dos entorns: Producció i Sandbox
Canvia d'aplicació des de la targeta d'aplicació a la part superior de la barra lateral. El canvi s'aplica immediatament. El mateix menú obre Configuració de l'aplicació i Crear aplicació.
#Per què això importa més del que sembla
Gairebé tots els informes de "ho he canviat i no ha passat res" es resolen amb aquesta estructura:
- Has editat un flux de treball a l'aplicació A mentre les teves sessions s'executen a l'aplicació B.
- Has afegit un endpoint de webhook a una aplicació i esperaves esdeveniments d'una altra.
- Estàs mirant Sandbox mentre el teu trànsit s'executa a Producció, o al revés.
- Estàs fent la crida amb una clau d'una aplicació diferent del recurs que estàs adreçant, i reps un 404 o un 403 per alguna cosa que clarament existeix.
Abans de depurar qualsevol altra cosa, confirma l'aplicació. Consulta errors de l'API i què signifiquen.
#Producció i Sandbox són entorns separats
Les aplicacions noves són de Producció. Les proves es fan a Sandbox: l'aplicació de proves compartida de la teva organització, amb les seves pròpies dades i les seves pròpies claus. Canvia entre tots dos amb el selector Producció i Sandbox sota el nom de l'aplicació a la barra lateral.
Les verificacions, les claus API, els webhooks i les llistes són independents a cada entorn. La marca és compartida, i els fluxos de treball es construeixen una vegada i es poden copiar entre entorns. Aquesta separació és precisament l'objectiu: el trànsit de proves i les dades de producció no es barregen mai, i una clau sandbox no pot gastar accidentalment crèdits reals. Consulta provar en sandbox.
Anomena les aplicacions perquè mai les puguis confondre d'un cop d'ull - acme-onboarding
i acme-payments és millor que "Application" i "Application (2)". Guarda les claus al teu
gestor de secrets amb noms que incloguin l'entorn, i no deixis mai que una variable
d'entorn contingui "la clau que toqui en cada moment".
#Quantes aplicacions hauries de tenir?
La majoria d'equips comencen amb una, que ja et dona Producció i Sandbox. Més enllà d'això, separa-les per qualsevol cosa que necessiti la seva pròpia configuració o el seu propi aïllament:
- Per producte, quan diferents productes necessiten fluxos de treball i endpoints de webhook diferents.
- Per entorn de preproducció, si necessites més que l'únic Sandbox.
- Per marca, si ofereixes verificació sota diverses marques amb estils diferents.
- Per política de retenció, ja que la retenció es configura per aplicació.
El que no se separa per aplicació és el teu saldo, que és a nivell d'organització. Totes les aplicacions consumeixen els mateixos crèdits.
#Crear aplicacions addicionals
Obre la targeta d'aplicació a la part superior de la barra lateral i tria Crear aplicació, i després introdueix un Nom de l'aplicació (allà on ja s'han desplegat els productes per aplicació, també tries per a què serveix). Si l'opció no hi és, o necessites crear-ne una a través de l'API en lloc de la consola, és una qüestió de permisos a nivell de compte que val la pena preguntar a suport en lloc de buscar-hi una solució alternativa.
#Diverses organitzacions
Una persona pot pertànyer a diverses organitzacions, i canvia entre elles des del menú de l'organització a la part superior de la barra lateral, on també apareixen les invitacions pendents. Crear tu mateix més d'una organització està limitat als comptes de revenedor (contacta amb suport per activar-ho), i no hi ha manera de crear suborganitzacions ni subcomptes sota la teva. Si dones servei a diversos clients propis, l'estructura suportada és una aplicació per client dins de la teva única organització: cada aplicació té els seus propis fluxos, marca, claus d'API, resultats i informes d'ús, totalment aïllats de la resta, mentre la facturació es queda a nivell d'organització.
#Revendre Didit
Si vols integrar Didit al teu propi producte i cobrar-ho als teus clients, això és el model de reseller. Així funciona, en els termes que suport dona a tothom que ho pregunta:
- Crèdit prepagat. Una compra inicial mínima de $5,000 USD, prepagada, amb un acord d'un any. El crèdit no caduca mai, és a nivell de la teva organització i es consumeix entre tots els clients finals que incorporis, i porta un descompte per volum que creix amb l'import.
- El tauler el construeixes tu. Integres l'API de Didit al teu propi front-end i els teus clients hi gestionen els seus fluxos, la seva marca i els seus rols. Didit no ofereix una còpia de marca blanca de la Business Console; les pantalles de verificació que veuen els teus usuaris finals sí que poden portar la teva marca (consulta marca blanca), la consola no.
- El teu marge és teu. Tu fixes el preu que paguen els teus clients. Didit et factura per funció completada als preus unitaris fixats durant la vigència de l'acord.
- No és un programa de partners locals. Didit fa les demos, la incorporació i el suport directament amb els clients i no busca partners de distribució ni d'implementació.
Si prefereixes no gestionar la revenda, fes servir l'opció de referiments: a la Business Console, obre Configuració → Recomana i guanya, obtén el teu enllaç i comparteix-lo. Guanyes una comissió del 10% sobre cada dipòsit en efectiu que faci una organització referida, durant 36 mesos des del seu primer dipòsit, utilitzable com a crèdit de Didit o cobrable per transferència bancària quan maduri, sense obligacions de lliurament ni de suport. Pots construir i provar la teva integració al pla gratuït abans de comprometre't amb cap de les dues.
#Eliminar una aplicació
L'eliminació permanent d'una aplicació encara no està disponible: Configuració de l'aplicació té una Zona de perill, però indica que l'eliminació no està disponible i no elimina res. Mentrestant, les teves opcions són:
- Deixar de fer-la servir. Canvia-li el nom (per exemple
acme-old) perquè ningú la triï per error, i revoca les seves claus API a Desenvolupadors → Claus d'API. - Esborrar les dades dels seus clients. Les dades de verificació segueixen la política de retenció i les regles d'eliminació d'aquestes dades, no el cicle de vida de l'aplicació: elimina les dades explícitament. Consulta eliminar sessions i dades personals.
- Començar de zero. Suport pot eliminar l'organització sencera perquè en puguis crear una de nova; és l'últim recurs, perquè s'emporta l'equip, el saldo i l'historial.
#Tot és atribuïble
Cada canvi registra a quina aplicació pertanyia, al registre d'auditoria. Això és el que fa que una estructura de diverses aplicacions sigui auditable i no només ordenada. Consulta fer servir els registres d'auditoria.
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.