Nabeyond ltd t/a CartDNA è un CartDNA è un Shopify Partner di sviluppo app di pagamento
Usa l'API CartDNA per autenticarti in modo sicuro, creare richieste di pagamento, controllare la selezione del metodo di pagamento e mantenere i tuoi sistemi aggiornati tramite flussi di callback. Costruita per team che necessitano di un'infrastruttura di pagamento flessibile e un controllo backend affidabile.
L'API CartDNA ti fornisce le azioni principali necessarie per l'orchestrazione dei pagamenti. Puoi richiedere un token di accesso, inviare richieste di pagamento, definire i dati del cliente e dell'ordine, scegliere i metodi di pagamento supportati e ricevere aggiornamenti di stato tramite URL di callback.
Usa le credenziali client per richiedere un token di accesso, poi includi quel token nelle richieste autorizzate.
Crea richieste di pagamento con dettagli dell'ordine, importo, valuta, dati del cliente e selezione del metodo di pagamento.
Proteggi ogni richiesta con validazione del timestamp, chiavi di idempotenza e firme delle richieste.
Usa l'URL di pagamento restituito per indirizzare i clienti nell'esperienza di pagamento.
Ricevi aggiornamenti sui pagamenti nel tuo backend in modo che il tuo sistema degli ordini rimanga accurato.
Le richieste API CartDNA supportano azioni di transazione comuni come creazione di pagamenti e flussi di preautorizzazione, a seconda della configurazione del tuo merchant. Questo offre agli sviluppatori flessibilità quando gestiscono acquisizioni dirette, pagamenti a fasi o logiche di checkout specifiche del metodo.
Il riferimento API pubblico mostra supporto per diversi metodi di pagamento e valute, incluse carte e alcuni metodi locali. Questo offre ai merchant maggiore flessibilità nella vendita in diversi mercati e aiuta gli sviluppatori a costruire esperienze di pagamento che corrispondano alle aspettative dei clienti.
Esempi:
CartDNA usa una protezione delle richieste a più livelli. I token controllano l'accesso all'API. I timestamp aiutano a ridurre i problemi di replay. Le chiavi di idempotenza riducono i duplicati accidentali. Le firme proteggono i campi di pagamento critici dalla manomissione. Questa struttura è pratica per i sistemi di produzione dove conta l'affidabilità dei pagamenti.
La tua integrazione dovrebbe gestire i casi di errore comuni dell'API come token non validi, richieste scadute, richieste duplicate e firme non valide. Costruisci retry chiari dove sicuro, registra il contesto delle richieste e mostra messaggi di errore interni utili ai team di supporto.
Tieni tutti i segreti lato server
Usa chiavi di idempotenza UUID
Standardizza i formati degli ID ordine
Registra le consegne di callback
Riconcilia gli esiti del redirect con lo stato finale del backend
Separa le credenziali sandbox e live
Testa la generazione delle firme con campioni di payload fissi
Per header esatti, esempi di richieste, campi del payload e formati di risposta, usa il riferimento API CartDNA completo.
Vai al riferimento API