Domande frequenti
Trova la guida DEUNA mantenuta per le domande comuni su Admin, API, checkout, SDK, plugin, test e webhook.
In questa pagina
Queste risposte puntano alla fonte di verità attuale invece di duplicare i contratti di configurazione o API che possono cambiare. Se una pagina non documenta una funzionalità, considerala non confermata e chiedi al tuo Technical Account Manager (TAM) di DEUNA prima di utilizzarla.
Amministrazioni#
Come ottenere l'accesso a DEUNA Admin?
Un operatore autorizzato della vostra organizzazione deve invitarvi e assegnarvi il ruolo necessario per il vostro compito. Iniziate con Gestione degli utenti e dei ruoli, quindi seguite Autenticazione a due fattori se il vostro account o organizzazione lo richiedono. Le credenziali API non creano una sessione Admin.
Dove posso configurare un processore o un metodo di pagamento?
Apri Connessioni Nell'area Amministrazione, seguendo la guida specifica per quel fornitore. Credenziali e disponibilità sono specifiche per l'account e l'ambiente. Utilizza Connessioni per comprendere il flusso di lavoro e catalogo fornitori per verificare la funzionalità prima di configurarla.
Posso personalizzare l'aspetto del processo di checkout?
Sì, all'interno dei controlli supportati dalla tua esperienza di checkout. Utilizza Tema e controlli condivisi per la configurazione del tema DEUNA e la pagina di personalizzazione specifica per l'integrazione quando un plugin o un SDK aggiunge vincoli propri. Assicurati che contrasto, focus e layout mobile rimangano utilizzabili dopo ogni modifica.
Integrazione API#
Posso integrare direttamente tramite l'API?
Sì. Esegui la quickstart API da un backend attendibile, quindi utilizza catalogo degli endpoint per il contratto esatto di richiesta e risposta pubblica. Non inserire mai una chiave API privata in un browser o in un'applicazione mobile.
Quale credenziale devo utilizzare?
La risposta dipende da dove viene eseguita la richiesta e da chi ne ha l'autorità. Un SDK lato client utilizza il contesto di applicazione pubblico documentato; operazioni server-to-server attendibili utilizzano una chiave API privata; i flussi di checkout clienti supportati possono utilizzare anche un token Bearer del cliente. La tabella decisionale e gli esempi di intestazioni sono in Autenticazione e chiavi API.
Come posso testare senza influire sull'ambiente di produzione?
Utilizzare le credenziali di test e l'URL di base del sandbox documentato in Elementi di integrazione. Mantenere separate le chiavi di test e di produzione, i webhook, gli account del provider e la configurazione del merchant. Verificare sia i flussi di successo che di errore prima di richiedere l'abilitazione in produzione.
Dove sono documentati i codici di risposta e di errore?
Il Errori e recupero La documentazione di riferimento spiega i codici di stato pubblici e le procedure di ripristino. La documentazione di riferimento specifica per un endpoint rimane autorevole per i suoi requisiti relativi alla richiesta, alla risposta, al pubblico e all'autorizzazione.
Checkout, SDK e plugin#
Quale integrazione di checkout dovrei scegliere?
Scegliere in base all'esperienza utente desiderata, alla piattaforma su cui viene implementata e al limite di fiducia per i dati di pagamento. Web Checkout confronta il percorso principale del web, mentre il Panoramica SDK Gestisce le applicazioni per Web, iOS, Android e React Native.
Dove si trovano i metodi e le callback dell'SDK?
Inizia con Panoramica SDK, seleziona la tua piattaforma e utilizza quella condivisa. evento e risposta Riferimenti pertinenti, ove applicabile. Non presumere che funzionalità con nomi simili utilizzino metodi identici su ogni piattaforma.
Quali metodi di pagamento posso visualizzare?
La disponibilità dei metodi di pagamento dipende dal paese, dalla valuta, dal canale, dalla connessione al fornitore e dalla configurazione dell'account. Filtra i risultati generati. catalogo fornitori, quindi seguire le istruzioni specifiche per il fornitore o il metodo di pagamento scelto. Non fare affidamento su screenshot o sul processo di checkout di altri commercianti per verificare la disponibilità.
Posso integrare tramite un plugin per e-commerce?
Uso Plugin Per visualizzare le integrazioni con piattaforme di e-commerce supportate, consultare la documentazione per VTEX, iniziando con... Panoramica di VTEXCompletare le guide di installazione e configurazione, e eseguire un test di acquisto prima del lancio in produzione.
Come influiscono coupon, tasse, spedizioni o mance sul processo di checkout?
Questi possono utilizzare callback sincroni specifici per il commerciante, se tale funzionalità è configurata per il tuo account. Webhook di checkout dinamico Questa guida illustra i limiti di esecuzione, la mappatura delle richieste e delle risposte, la validazione e la gestione degli errori. Non utilizzare callback o campi modificabili non certificati per il tuo merchant.
Webhook e risultati dei pagamenti#
È necessario un webhook?
Utilizzare i webhook di stato quando il backend deve reagire a modifiche nei pagamenti in modo asincrono, senza fare affidamento sul browser, su un reindirizzamento o su una callback SDK. Alcuni metodi di pagamento raggiungono il loro stato finale dopo che il cliente ha completato l'acquisto. Implementare il flusso di notifica firmata e verificare lo stato autoritativo dell'ordine prima della spedizione o di un'altra azione irreversibile.
Cosa succede se un webhook è in ritardo, duplicato o arriva in ordine errato?
Verificare la firma, accettare in modo persistente la notifica, eliminarne le duplicazioni e impedire che un evento precedente sposti il record locale all'indietro. La consegna non è prova di semantica "esattamente una volta" o di ordine di ciclo di vita. Seguire Accetta e riconcilia e utilizzare un processo di riconciliazione separato per i pagamenti non risolti.
Un callback SDK o un reindirizzamento del browser sono prova di pagamento?
No. La finalizzazione lato client è utile per l'esperienza del cliente, ma il backend deve utilizzare il risultato e il flusso di stato asincrono documentato lato server prima della spedizione. Mantenere lo stato dell'interfaccia utente, lo stato del pagamento e lo stato di liquidazione come preoccupazioni separate.
Documentazione e strumenti di IA#
Un agente di codifica basato sull'IA può cercare in queste documentazioni?
Sì. Collegare un client compatibile all'accesso in sola lettura. Documentazione DEUNA per il server MCP. Cerca la stessa documentazione pubblica, l'inventario di endpoint e il catalogo fornitori pubblicati su questo sito e non richiede o accetta le tue credenziali DEUNA.
Una funzionalità non è documentata. Devo presumere che funzioni?
No. Verificare con il vostro rappresentante DEUNA TAM o con il proprietario del contratto pubblico pertinente. Includere l'ambiente, il prodotto, il fornitore, l'operazione prevista e la pagina pubblica consultata, ma rimuovere le chiavi API, i token, i dati della carta, le chiavi private e i dati del cliente.