Checkout.com
In questa pagina
Checkout.com è un connettore self-serve e la fonte di costo più forte nel catalogo. Si basa su due cose in una sola volta: i dettagli di pagamento dal gateway, e i rapporti di riconciliazione che decompongono ciò che ogni transazione realmente costa. Abilitare i rapporti prima, o si ottiene i pagamenti metà e nessuno della metà del costo.
Cosa ottieni#
Pagamenti e le loro azioni con risultati, controversie, pagamenti, e dettagli di riconciliazione che coprono le tasse e FX. Le definizioni di livello di campo vivono in Athia Data Dictionary.
Più forte per la decomposizione a pagamento. Di tutti i fornitori di carte, Checkout.com rotture costo più lontano — interscambio, spese di regime, tasse di gateway, commissioni di rete, spese di rimborso e FX tutti arrivano separatamente, che è ciò che rende il vero costo per ordine approvato possibile piuttosto che stimato.
Più debole per la consistenza delle unità. I pagamenti vengono in unità minori, rapporti di riconciliazione in decimali.
Prima di iniziare#
1. Abilitare i rapporti di riconciliazione sul Checkout.com - Lato. Fino a quando non sono accesi, i dati dei costi non compariranno tuttavia le credenziali sono oggetto di applicazione.
2. Creare la coppia chiave di accesso. Nel centro, vai a Sviluppatori → Keys → Creare una nuova chiave. La credenziale è un Access key ID più un segreto chiave di accesso; Athia ha bisogno di entrambi.
3. Selezionare Scopi personalizzati e il set completo di portata. Abilitare al minimo gateway, vault e reports famiglie di portata. gateway:payment-details (pagamenti e azioni) e reports:read (relazioni di riconciliazione) deve essere incluso, ma non sono l'elenco completo — che la coppia non copre i dati di bilancio, di pagamento e di relazione di azione finanziaria Athia ingerisce, e un set di portata stretta produce HTTP 401 errori piuttosto che dati parziali.
4. Selezionare l'entità le coprichiavi. Il Entità Id è ciò che separa la connessione di un'entità da quella di un'altra.
5. Scegli l'ambiente esplicitamente. A Test di prova mappe dell'account Sandbox; Vivo mappe dell'account Produzione. Una chiave dall'ambiente sbagliato verifica e poi non porta nulla che si riconosce.
Credentials Athia chiede#
| Campo | Obbligatorio | Che cosa è / dove trovarlo |
|---|---|---|
| Nome | Sì. | La vostra etichetta per questo collegamento — identificare l'entità che copre |
| Programma | No. | Quante volte sonda Athia Checkout.com |
| Accesso chiave Id | Sì. | Il Access key ID della coppia creata sotto Sviluppatori → Keys |
| Accesso segreto | Sì. | Il timbro segreto chiave di accesso |
| Entità Id | Sì. | Il Checkout.com entità questa connessione copre |
Impostazione della connessione#
- Attivare report di riconciliazione, impostare Consentire qualsiasi canale di elaborazione a ON, e creare la coppia chiave di accesso con Uvaggi doganali e l'intero campo di applicazione impostato, per l'entità e l'ambiente giusti.
- In Impostazioni → Connessioni, scegliere + Aggiungi connessione e selezionare Checkout.com.
- Su Configurare il connettore, entrare in un Nome e scegliere un Programma.
- Su Inserisci le credenziali, entrare nel Accesso chiave Id, Accesso segreto e Entità Id.
- Scegli Verificare la connessione.
La connessione mostra poi come ACTIVE e la prima sincronizzazione inizia. Se si opera diverse entità, creare una connessione per entità — Entità Id è ciò che li separa.
Registrare il webhook di Athia#
Gli eventi di pagamento e di disputa raggiungono Athia in tempo reale attraverso un Checkout.com workflow.
- Nella procedura guidata di connessione, copiare il URL della destinazione Athia Webhook.
- Nel centro, vai a Impostazioni → Flussi di lavoro → Crea flusso di lavoro.
- Selezionare gli eventi
payment_captured,payment_approvededispute_created. - Aggiungi un webhook azione e incollare URL della destinazione Athia Webhook.
- Configurare l'intestazione firma, quindi testare, salvare e abilitare il flusso di lavoro.
Sincronizzazione della cadenza#
Questa connessione ha due orologi: i dettagli di pagamento si aggiornano come transazioni avvengono, mentre i rapporti di riconciliazione seguono Checkout.comE' il ciclo di segnalazione piu' lento. I dati sui costi non saranno più freschi di quel ciclo, qualunque sia il programma scelto.
Limiti e cose da sapere#
- Unità di misura miste. I pagamenti sono importi API Unità minori (dividere per 100); gli importi della relazione di riconciliazione sono decimale. Athia normalizza su ingerimento, ma controlla quale fonte una cifra proveniva prima di concludere che è sbagliato.
- I rapporti devono essere abilitati prima, o la decomposizione della tassa questo connettore è migliore a non è lì.
- Il set completo è necessario. Creare la chiave con Uvaggi doganali almeno la copertura
gateway,vaultereportsfamilies.gateway:payment-detailsereports:readda solo non coprono i dati di bilancio, di vincita e di relazione di azione finanziaria, e un set di portata stretta restituisce HTTP401piuttosto che dati parziali. - I dati della carta sono minimizzati.
Risoluzione dei problemi#
| Cosa vedi | Come causa | Cosa fare |
|---|---|---|
| I pagamenti arrivano, senza costi o dettagli di scambio | Rapporti non abilitati, o reports:read mancante | Attivare report, confermare il set di portata, riconnettere |
HTTP 401 su verifica o durante la sincronizzazione | Chiave creata con un set di portata stretta | Ricreare la chiave con Uvaggi doganali e il pieno gateway, vault e reports famiglie |
| Alcuni pagamenti non arrivano mai, niente segnala un errore | Consentire qualsiasi canale di elaborazione a sinistra | Impostare per ON nella chiave Canali di elaborazione sezione, quindi ricollegare |
| La connessione verifica ma trasporta dati non riconosciuti | Chiave dall'ambiente sbagliato | Utilizzare una chiave di prova per Sandbox e una chiave di conto in tempo reale per la produzione |
| Nessun pagamento in tempo reale o eventi di disputa | Flusso di lavoro mancante, disabilitato o intestazione firma non configurato | Ricreare il flusso di lavoro sotto Impostazioni → Flussi di lavoro, ridipingere il URL della destinazione Athia Webhook, e controllare l'intestazione firma |
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.