Braintree

Braintree è un connettore self-serve costruito su tre valori: un ID commerciante, una chiave pubblica e una chiave privata. Ciò che decide se la connessione è qualsiasi bene è il ruolo di accesso limitato che si attacca all'utente API — ottenere sbagliato e interi domini arrivano vuoti senza un errore.

Cosa ottieni#

Transazioni con dati di pagamento mascherati, registri di fatturazione e abbonamenti, controversie, registri del cliente e del metallo di pagamento, verifiche e dati di dichiarazione e di relazione. Le definizioni di livello di campo vivono in Athia Data Dictionary.

Più forte per gli abbonamenti. Braintree trasporta dettagli ricorrenti la maggior parte dei connettori della carta non lo fanno, il che lo rende la fonte di riferimento per il successo di rinnovo e per il churn involontario da rinasci falliti.

Più debole dove i permessi sono stretti. La copertura è una funzione diretta del ruolo che concedete; le dispute e i clienti sono i domini che più spesso mancano.

Prima di iniziare#

Nella console Braintree, creare una ruolo limitato di accesso per Athia e assegnarlo all'utente API. Il ruolo ha bisogno di:

• Transazioni: Scarica Transazioni con i dati di pagamento mascherati
• Reporting: Creare, eseguire e scaricare report; Visualizza Grafici Dashboard
• Fatturazione ricorrente: Scarica Abbonamento, Visualizza le modifiche, Visualizza Abbonamento, Visualizza Abbonamenti, Cerca Abbonamenti
• Gestione delle controversie: Visualizza, gestisci e contesta le controversie
• Webhooks: Gestire Webhooks (Aggiungi/Edit/Delete)
• Dichiarazioni: Visualizza le dichiarazioni
• Accesso libero: Visualizza indirizzo, Visualizza i clienti, Visualizza Account Merchant, Visualizza metodi di pagamento, Visualizza transazioni, Visualizza le verifiche, Scarica i file
• Ricerca: Cerca transazioni, verificazioni di ricerca

Visualizza Indirizzo e Visualizza i Clienti sono i due più spesso lasciati. Senza di loro l'indirizzo e le tabelle dei clienti si sincronizzano vuoti e non viene sollevato alcun errore.

Quindi assegnare all'utente API di tutto il resto conti commerciali — Gli ambiti di Braintree accesso per conto commerciante, quindi un account lasciato fuori non contribuisce nulla.

Creare l'utente e le chiavi API#

1. Accedi al Pannello di controllo Braintree come amministratore e crea il ruolo sopra.
2. Creare un nuovo utente e abilitare Accesso API per quell'utente.
3. Assegna il ruolo di accesso limitato che hai creato.
4. Seleziona tutti gli account mercantili.
5. Accedi e accedi come nuovo utente, poi generare e copiare Merchant ID, Chiave pubblica e Chiave privata.

Credentials Athia chiede#

Impostazione della connessione#

1. Creare il ruolo, assegnarlo all'utente API e assegnare a ogni account commerciante.
2. In Impostazioni → Connessioni, scegliere + Aggiungi connessione e selezionare Braintree.
3. Su Configurare il connettore, entrare in un Nome e scegliere un Programma.
4. Su Inserisci le credenziali, entrare nel Merchant Id, Chiave pubblica e Chiave privata.
5. Scegli Verificare la connessione.

La connessione mostra poi come ACTIVE e la prima sincronizzazione inizia. Verificare che le controversie e i clienti siano effettivamente popolati — che è la conferma più veloce che il ruolo è giusto.

Registra il webhook Athia a Braintree#

Braintree spinge transazioni, abbonamenti e aggiornamenti di contenzioso ad Athia in tempo reale una volta che la destinazione è registrata.

1. Nella procedura guidata di connessione, copiare il URL della destinazione Athia Webhook.
2. Accedi al Pannello di controllo Braintree come utente limitato-accesso e creare un webhook.
3. Incolla l'URL di Athia URL della destinazione.
4. Sottotitoli Notifiche, abilitare tutto il resto opzioni di notifica.
5. Prova e salva, quindi abilitare il webhook.

Sincronizzazione della cadenza#

Scegli un Programma che corrisponde a quanto monitori attentamente l'accettazione. I registri di abbonamenti e controversie avanzano sui cicli di fatturazione e di disputa di Braintree, qualunque cosa tu scelga.

Limiti e cose da sapere#

• Le autorizzazioni mancanti producono domini vuoti, non errori. Senza diritti di lettura, dispute e clienti si sincronizzano vuoti mentre la verifica riesce ancora.
• La copertura segue l'assegnazione del conto mercantile. Gli account a cui l'utente API non è assegnato sono assenti.
• Produzione e Sandbox sono connessioni separate. Ogni ambiente emette il proprio ID commerciante e coppia chiave — creare una connessione per ambiente e mai mescolare credenziali tra di loro.
• I campi di insediamento e di esborso sono in ritardo fino a due giorni dietro la transazione. Leggere le cifre di insediamento nei giorni maturi, non su quello di oggi.
• Gli importi sono decimali — mai dividere di 100.
• I dati della carta sono minimizzati. Il ruolo sopra accorda solo dati di pagamento mascherati.

Risoluzione dei problemi#

Correlato#

Altri fornitori e percorsi di ingestione sono elencati in Connettori di Athia. Per le gocce di file e le alternative di magazzino-a magazzino-consiglio a un connettore diretto, vedi Integrazione di Athia.