Stripe

Una chiave API limitata dà Athia la tua attività Stripe fine alla fine: oneri, approvazioni e riduzioni, rimborsi e controversie, e ciò che Stripe ha deciso e addebitato per voi.

Cosa ottieni#

Pagamenti e tentativi di pagamento con i loro risultati, rimborsi, controversie e la tassa registrata contro ogni transazione.

Più forte per la larghezza da una credenziale. Una chiave limitata copre ogni dominio — non ci sono rapporti per abilitare prima, che rende questo il connettore più veloce per alzarsi.

Più debole per la granularità dei costi. Le fee arrivano miscelato, così lo scambio non può essere diviso da componenti di schema e gateway. Per il lavoro a livello di interscambio, aggiungere Adyen o Checkout.com data.

Prima di iniziare#

La versione API del tuo account Stripe deve essere 2019-02-19 o versioni successive.

Creare un chiave API limitata (rk_…) per Athia nella console Stripe — non la vostra chiave segreta standard:

1. Vai a Sviluppatori → chiavi API e scegliere Creare una chiave limitata.
2. Scegli Costruire la propria integrazione e continuare.
3. Nominare la chiave — per esempio, Athia Integration.
4. Impostare i permessi qui sotto.
5. Creare la chiave e copiare il token.

Tre borse sono facili da perdere. Si ferma il collegamento morto; gli altri due falliscono silenziosamente.

Credentials Athia chiede#

Impostazione della connessione#

1. In Impostazioni → Connessioni, scegliere + Aggiungi connessione e selezionare Stripe.
2. Su Configurare il connettore, entrare in un Nome e scegliere un Programma.
3. Su Inserisci le credenziali, incollare la chiave in Api chiave, scegliere un Cornice temporale storica Sync, e impostare il Limite di sincronizzazione posteriore data se Limite di data ne rivela uno.
4. Scegli Verificare la connessione.
5. Copiare URL della destinazione Athia Webhook mostrata nella mago.
6. A Stripe, vai a Sviluppatori → Webhooks → Aggiungi endpoint, incolla l'URL e seleziona gli eventi charge.succeeded, dispute.created e payout.paid. Testare, salvare e abilitare l'endpoint.

La connessione mostra poi come ACTIVE e la prima sincronizzazione inizia. Per ogni account Stripe aggiuntivo — compreso Conti connessi — creare una chiave separata e una connessione separata.

Sincronizzazione della cadenza#

Scegli un Programma che corrisponde a quanto si guarda attentamente l'accettazione. Più veloce inquinamento non migliora i record di pagamento e di commissione, che cambiano solo quando Stripe si stabilisce.

Limiti e cose da sapere#

• La sincronizzazione storica è bloccata ad un anno. Tutto il tempo backfill l'anno intero Athia può raggiungere; Limite di data prende un Limite di sincronizzazione posteriore data, che non può essere prima di un anno prima di oggi. Per la storia più vecchia, caricarlo attraverso una caduta di file sicura (SFTP/S3) — vedi Integrazione di Athia.
• Le fee sono mescolate. Lo scambio granulare non è disponibile attraverso questo connettore.
• Gli importi sono unità minori — dividere per 100. Athia si occupa di ingerire; conta quando si riconcilia con un'esportazione di Stripe grezza.
• I dati della carta sono minimizzati. Per quello che ogni campo ingerito ha in mano, vedi Athia Data Dictionary.

Risoluzione dei problemi#

Correlato#

• Connettori di Athia — il catalogo completo dei connettori.
• Integrazione di Athia — percorsi di integrazione, compresi i gocce di file e il magazzino-a-consiglio.
• Athia Data Dictionary — definizioni di livello di campo.