Aggiunta di una risorsa di integrazione di fatturazione

Per abilitare la monetizzazione dei tuoi piani di prodotto, devi aggiungere una risorsa di integrazione della fatturazione nella tua organizzazione provider IBM® API Connect che definisce i dati di configurazione necessari per la sincronizzazione con un sistema di fatturazione della sottoscrizione esterno.

Prima di iniziare

Per utilizzare Stripe come fornitore di elaborazione delle carte di credito, è necessario che la porta 443 sia aperta alla comunicazione HTTPS tra l'API di Stripe e i server di gestione del portale per sviluppatori e del cluster di gestione. Per ulteriori informazioni su questo requisito, vedere Requisiti del firewall su Kubernetes.

Prima di poter creare risorse di fatturazione nelle organizzazioni di provider, il microservizio di fatturazione deve essere abilitato sul sistema di gestione dall'amministratore di sistema. Per ulteriori informazioni, vedere Configurazione della monetizzazione su Kubernetes.

È necessario essere il proprietario dell'organizzazione provider o avereSettings: Manageper completare questa attività.

È necessario disporre di un account con Stripe per poter completare questa attività. Se non avete ancora un account Stripe, potete crearne uno all'indirizzo: www.stripe.com

Informazioni su questa attività

API Connect supporta l'integrazione con Stripe Subscription Billing, un servizio cloud indipendente che gestisce i piani di prodotti monetizzati, i clienti, le informazioni di pagamento e la cronologia degli abbonamenti, al fine di generare fatture mensili e addebitare automaticamente i clienti. Con questa integrazione, Stripe funge sia da sistema di fatturazione degli abbonamenti che da sistema di elaborazione dei pagamenti. Quando i consumer API si sottoscrivono ai piani del prodotto con fatturazione nel Developer Portal, configurano i pagamenti automatici tramite una carta di credito registrata con Stripe. Per attivare questo processo di fatturazione, è necessario prima specificare le informazioni sull'account Stripe creando una risorsa di integrazione della fatturazione. L'importo di pagamento della sottoscrizione viene elaborato dall'account fornito dal consumer API e accreditato all'account che fornisci come provider API.

Importante: ogni account Stripe viene fornito con due serie di chiavi API, una per il test e una per la produzione. Ogni serie di chiavi API ha uno spazio dei nomi distinto per gli oggetti Stripe. Le chiavi API di test non possono vedere oggetti creati dalle chiavi API di produzione e viceversa. Non puoi cambiare le chiavi API di una delle tue integrazioni di fatturazione con le chiavi di un altro account o scambiare le tue chiavi di test e di produzione, in quanto ciò impedirebbe a API Connect di risolvere gli oggetti Stripe creati utilizzando le vecchie chiavi. Se si desidera utilizzare le chiavi di test Stripe, è necessario creare un catalogo separato per il test e non aggiungere le chiavi di test Stripe ai cataloghi di produzione.

Procedura

Per creare una risorsa di integrazione di fatturazione, completa la seguente procedura:

  1. In API Manager, fare clic su Risorse Resources.
  2. Assicurarsi di essere nell'organizzazione provider a cui si desidera aggiungere l'integrazione di fatturazione
  3. Selezionare Fatturazione, quindi fare clic su Aggiungi.
    Viene visualizzata la pagina Aggiungi integrazione di fatturazione per Integrazione Stripe .
  4. Immettere un Titolo per l'integrazione di fatturazione.
  5. Il Nome viene generato automaticamente in base al Titolo che immetti ed è una stringa singola che può essere utilizzata nei comandi della CLI del toolkit dello sviluppo.
  6. Immetti la chiave pubblicabile e la chiave segreta per il tuo account Stripe.
    Consultare il cruscotto di Stripe per ottenere la chiave pubblicabile e la chiave segreta; vedere https://dashboard.stripe.com/apikeys
  7. Fai clic su Aggiungi per creare la tua risorsa di integrazione di fatturazione.

Risultati

La tua nuova risorsa di integrazione della fatturazione viene elencata nella tabella nel dashboard Fatturazione . La tabella visualizza anche lo stato della coda lavori per l'integrazione della fattura. Qualsiasi problema con la coda lavori viene visualizzato in questa tabella. Per ulteriori informazioni, vedere Code di lavoro delle risorse di integrazione della fatturazione.

Cosa fare successivamente

Per poter pubblicare piani di prodotto monetizzati, è necessario aggiungere la risorsa di integrazione della fatturazione al proprio catalogo e al catalogo Sandbox. Per ulteriori informazioni, vedere Aggiunta di una risorsa di integrazione della fatturazione a un catalogo.