PayPal diretto

PayPal Direct è un connettore self-serve: un ID client e un segreto, due ambiti di lettura e cinque impostazioni API abilitate sull'app. È la migliore fonte di disputa nel catalogo, e si è stabilito reporting, che forma ciò che si può e non può chiedere.

Cosa ottieni#

Settled transazioni, saldi e pagamenti, e record di contenzioso con il loro ciclo di vita.

Più forte per le dispute. I dati di controversia di PayPal sono più completi della maggior parte, il che rende questo il connettore a sporgere su per il tasso di disputa per segmento, risultati di vincita e di perdita, e il ritardo tra una transazione e la controversia che attrae. Le controversie si estendono da 30 a 180 giorni dopo, per questo motivo qui conta un anno intero di storia.

Più debole per l'analisi di guasti di livello di tentativo. Transaction Search è stabilito reporting — esso dice che cosa completato, non quello che è stato provato, quindi i codici di declino perattempt non sono disponibili here.

Prima di iniziare#

Il tuo conto commerciale deve essere abilitato per i pagamenti diretti. L'uso dal vivo richiede l'approvazione di PayPal — chiederlo prima di iniziare.

Nella console PayPal, creare una App per API REST per Athia e nota la sua Client ID e Segreto segretoQuesto è il percorso normale. I conti dei pagamenti diretti legacy invece utilizzano NVP/SOAP — le Nome utente, Password e Firma.

Collegare esattamente due ambiti:

• transactions:read
• payouts:read

Questi due ambiti sono solo in lettura: questa credenziale non può catturare, rimborsare o inviare denaro.

Attivare le impostazioni API dell'app

Le stringhe di portata non cancellano i dati da soli — le impostazioni API dell'app fanno. Abilitare tutti e cinque sull'app:

Senza Fatturazione e Abbonamenti i dati del piano di fatturazione e attivati arrivano vuoti.

Creare un ruolo di sola lettura

Accedi al Dashboard Sviluppatore PayPal come amministratore e crea un ruolo personalizzato — per esempio Integrazione dell'Athia — con autorizzazioni di sola lettura per:

1. Transazioni (ricerca, dettagli)
2. Reporting (equilibrio, transazioni)
3. Pagamenti (dettagli)
4. Abbonamenti
5. Controversie

Produzione e Sandbox sono connessioni separate. Creare un'app e una connessione Athia per ogni ambiente. Utilizzare le credenziali in diretta per la connessione di produzione, o verifica e non porta nulla che si riconosce.

Credentials Athia chiede#

Impostazione della connessione#

1. Crea l'app, abilita le cinque impostazioni API e conferma che entrambi gli ambiti sono collegati.
2. In Impostazioni → Connessioni, scegliere + Aggiungi connessione e selezionare PayPal diretto.
3. Su Configurare il connettore, entrare in un Nome e scegliere un Programma.
4. Su Inserisci le credenziali, entrare nel Identità del cliente e Chiave segreta.
5. Scegli Verificare la connessione.
6. Copiare URL della destinazione Athia Webhook dal mago.
7. Nella console PayPal, vai a Le mie app e credenziali → selezionare la tua app → Webhooks → Aggiungi Webhooks, incolla l'URL e seleziona PAYMENT.CAPTURE.COMPLETED, DISPUTE.CREATED e PAYOUTS.BATCH.PROCESSED. Salvare, quindi abilitare il webhook.

La connessione mostra poi come ACTIVE e la prima sincronizzazione inizia. Per diversi account commerciali PayPal, creare un'app e una connessione per ciascuno.

Sincronizzazione della cadenza#

Settled reporting premia frequenti inquinare meno di un connettore gateway, e inquinare più velocemente non produrrà dettagli di livello di tentativo la fonte non trasporta. Abbina il programma a quanto spesso si legge effettivamente i dati.

Limiti e cose da sapere#

• Nessun codice di declino per-attempt. Transaction Search report attività risolta; motivi di declino della fonte da un connettore gateway invece.
• Gli importi sono decimali — mai dividere di 100.
• Tempo di conversazione. Le controversie appaiono bene dopo la transazione, così i tassi di disputa recenti-periodo sembrano sempre meglio di quanto si rivelerà essere. Confronta coorte che hanno avuto il tempo di maturare.
• La storia torna indietro di tre anni. Resoconto di ricerca di transazioni alla maggior parte dei tre anni di transazioni. Per qualsiasi cosa più vecchio, file di carico — vedere Integrazione di Athia.
• I dati della carta sono minimizzati. Dettaglio di livello di campo su ciò che Athia negozi è in Athia Data Dictionary.

Risoluzione dei problemi#

Correlato#

• Connettori di Athia — il catalogo completo del connettore
• Athia Data Dictionary — definizioni di campo
• Integrazione di Athia — cadute di file, quote di magazzino e altri percorsi di integrazione