Passa al contenuto principale
Tutti i sistemi operativiNovitàv1
Accedi

Chase

In questa pagina

Chase è il commerciante di acquisizione e pagamento di elaborazione di affari di JP Morgan Chase — il suo portale di sviluppo e la documentazione usano il nome JP Morgan Chase. I dati raggiungono Athia tre modi: Athia sonda i pagamenti globali e le API di reporting per lo stato di pagamento e i rapporti, riceve le spinte sul webhook che si registra nel portale JPMC, e raccoglie i file di batch SFTP dove l'integrazione è basata sulla forma. I prerequisiti del provider — accesso API sul portale di sviluppo JP Morgan Chase Payments, e qualsiasi modulo DFR che deve andare al tuo JPMC Relationship Manager — sono organizzati con il tuo team Athia. Una volta che hai le credenziali, completa la connessione da solo.

Cosa ottieni#

  • Pagamenti — informazioni di pagamento in tempo reale e di stato.
  • Transazioni — dettaglio delle transazioni e bilanciamenti.
  • Relazioni — vendite, rimborsi, depositi e tasse, prefinanziati e post-finanziati.
  • Notifiche — eventi e raccomandazioni.

I report personalizzati sono definiti attraverso i parametri API, o attraverso un modulo DFR in cui il report di cui hai bisogno non è uno il ritorno delle API.

Prima di iniziare#

Hai bisogno di accesso al JP Morgan Chase Payments Developer Portal con il permesso di generare certificati, credenziali OAuth o chiavi API.

Nel portale:

  1. Richiedi o configura l'accesso al Pagamenti globali e Relazione APIs.
  2. Abilitare le caratteristiche di cui hai bisogno — ad esempio pagamenti in tempo reale e notifiche.
  3. Genera le credenziali che Athia userà.

Scegli un tipo di credenziali

O opere:

  • A. — generare un ID cliente e segreto, e impostare gli scopi payments:read e reports:read. Entrambi gli ambiti sono di sola lettura: questa credenziale non può spostare i soldi.
  • A base di certificati — scaricare il .pem / .crt file dal portale e caricarli ad Athia.

Associare le credenziali con il tipo di entità — Società o Unità di business.

Il modulo DFR

Ulteriori relazioni richiedono DFR (Relazione file limitata) forma. E' una domanda. Nome di affari e Numero di entrata, e invia il modulo compilato al tuo JPMC Responsabile relazioni. Contatta il tuo account team di Athia se vuoi aiutare con i moduli DFR o con la configurazione iniziale.

Credentials Athia chiede#

CampoObbligatorioChe cosa è / dove trovarlo
NomeSì.La tua etichetta per questo collegamento — identificare l'entità Chase che copre
ProgrammaSì.Quante volte Athia sonda Chase — ogni giorno o ora
OAuth Client IdSolo aDalle credenziali OAuth generate nel portale JPMC
Segreto cliente di destraSolo aThe matching secret for that client ID
Caricamento del certificatoSolo certificatoIl .pem / .crt file scaricati dal portale — utilizzare questi invece della coppia OAuth
Numero di entrataSì.Il tuo identificativo di entità JPMC, lo stesso numero utilizzato nel modulo DFR

Impostazione della connessione#

  1. Nel portale JPMC, confermare l'accesso API, abilitare le funzionalità necessarie e generare la coppia OAuth con payments:read e reports:read o i file di certificato.
  2. Athia, vai a Impostazioni → Collegamenti → + Aggiungi connessione e selezionare Chase.
  3. Su Configurare il connettore, entrare in un Nome e scegliere un Programma.
  4. Su Inserisci le credenziali, entrare nel OAuth Client Id e Segreto cliente di destra, o caricare il .pem / .crt file, quindi inserire il Numero di entrata.
  5. Definire la rete e l'operazione — selezionare o creare un gruppo e aggiungere le operazioni che questa connessione copre.
  6. Scegli Verificare la connessione. Athia gestisce un ping leggero di pagamento contro l'API.
  7. Copiare URL della destinazione Athia Webhook dal wizard e registrarlo nel portale JPMC — vedere di seguito.

La connessione mostra poi come ACTIVE e la prima sincronizzazione inizia. Per diverse entità, generare un certificato separato o utilizzare i sub-ID, e creare una connessione per entità.

Webhook#

Registra Athia come destinazione di notifica in modo che i cambiamenti di stato di pagamento arrivino come si verificano piuttosto che al sondaggio successivo.

  1. Copiare URL della destinazione Athia Webhook dal mago di connessione.
  2. Nel portale Sviluppatore JP Morgan Chase Payments, apri le notifiche / configurazione webhook.
  3. Incolla l'URL di Athia e seleziona gli eventi che vuoi — cambia stato di pagamento, più aggiornamenti di pagamento e raccomandazioni se li usi.
  4. Attivare il webhook, quindi testare la configurazione dal portale.

Salta questo e Athia vede solo quello che il sondaggio programmato ritorna.

Sincronizzazione della cadenza#

Quotidiano o oraria. Dove la vostra integrazione è basata sulla forma piuttosto che basata su API, gli stessi dati arrivano come SFTP lotto file invece di sondaggi API.

Limiti e cose da sapere#

  • Numero di entrata è richiesto. Senza di essa la connessione non può essere portata alla giusta entità JPMC.
  • Una credenziale per entità. Certificati separati o sub-ID, e una connessione Athia separata per ciascuno.
  • DFR forma percorso attraverso il vostro responsabile relazioni. Consentire il tempo di consegna prima che i rapporti che sbloccano appaiono.
  • Gli ambienti di produzione e di prova sono separati. Utilizzare le credenziali di produzione sulla connessione in cui ci si aspetta dati di produzione.
  • I dati della carta sono minimizzati. Dettaglio di livello di campo su ciò che Athia negozi è in Athia Data Dictionary.

Risoluzione dei problemi#

Cosa vediCome causaCosa fare
La verifica non viene eseguita su un caricamento del certificatoFile sbagliato esportato, o il certificato non è quello associato a questa entitàRicaricare il .pem / .crt dal portale JPMC e carica di nuovo
La verifica non è stata verificata su OAuthScopes mancante dal clienteAggiungi payments:read e reports:read nel portale, poi verifica di nuovo
I pagamenti arrivano ma i rapporti sono vuotiSegnala l'accesso API non concesso, o il report ha bisogno di un modulo DFRRichiedi l'accesso alle API nel portale; per ulteriori report, invia il modulo DFR al tuo responsabile relazioni
La connessione è ACTIVE ma i dati appartengono ad un'altra entitàSbagliato Numero di entrata sulla connessioneCorreggere il numero di entrata e verificare di nuovo
Non arriva nulla tra sondaggiWebhook non registrato o non abilitato nel portaleRe-add il URL della destinazione Athia Webhook, selezionare gli eventi di cambiamento dello stato di pagamento e abilitarlo
Nessun dato dopo la prima sincronizzazionecredenziali di prova ambientale su un collegamento di produzioneRistampare le credenziali nell'ambiente in cui si elabora, quindi riconnettere