Emissione di crediti

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Introduzione

La monetizzazione ti offre la flessibilità di emettere credito sviluppatore.

Per uno sviluppatore con abbonamento prepagato, un credito viene visualizzato come una riduzione dell'utilizzo, il che aumenta o diminuisce il saldo prepagato dello sviluppatore in futuro. Proprio come con una carta di debito, i fondi vengono prelevati dal saldo prepagato di uno sviluppatore quando quest'ultimo acquista un bundle di prodotti API. Lo sviluppatore deve mantenere un saldo adeguato per gli acquisti. Consulta l'articolo Come faccio a calcolare il saldo rimanente dell'account prepagato?

Per uno sviluppatore con fatturazione postpaid, un credito viene visualizzato come una riga separata in una fattura, riducendo l'addebito.

Esplorare la pagina dei riconoscimenti

Accedi alla pagina Crediti ed esplorala, come descritto di seguito.

Emissione di un credito

1. Accedi alla pagina Crediti.
2. Fai clic su + Credito.
3. Immetti le seguenti informazioni:

   Campo	Descrizione
   Mese di fatturazione	Mese di fatturazione in cui si applica il credito. Seleziona un mese dall'elenco.
   Sviluppatore	Nome dello sviluppatore o dell'azienda a cui si applica il credito. Inserisci il nome nella casella di testo. Mentre digiti, in un elenco a discesa viene visualizzato un elenco di sviluppatori/aziende che contengono la stringa. Fai clic sul nome dello sviluppatore o dell'azienda nell'elenco a discesa. Nota: dopo aver selezionato uno sviluppatore o un'azienda, vengono visualizzati i campi rimanenti. Se selezioni una società o uno sviluppatore che non ha accettato un piano tariffario, non puoi emettere un credito.
   Pacchetto di prodotti	Set di prodotti API a cui si applica il credito. Seleziona un pacchetto di prodotti API dall'elenco disponibile.
   Prodotto	Prodotto API nel pacchetto di prodotti API selezionato a cui si applica il credito. Seleziona Tutti i prodotti o un singolo prodotto API dall'elenco.
   Valuta	Valuta utilizzata per il credito. La valuta è configurata per il piano tariffario nel pacchetto di prodotti API acquistato dall'autore e non può essere modificata. Se in un piano tariffario sono definite più valute, puoi selezionarne una.
   Importo	Importo del credito (nella valuta specificata). Specifica un valore positivo o negativo. Il valore non può essere zero.
   Nota	Nota facoltativa per descrivere il motivo del credito.

4. Fai clic su Salva credito.

Emissione di crediti tramite l'API

Utilizzando l'API, emetti credito a uno sviluppatore per l'intero pacchetto di prodotti API o per l'utilizzo di un prodotto API specifico in un pacchetto di prodotti API.

Per emettere un credito utilizzando l'API, invia una richiesta POST a /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions, dove {package_id} e {rate-plan_id} definiscono rispettivamente l'identificazione del pacchetto di prodotti API e del piano tariffario a cui si applica il credito.

Quando invii la richiesta, devi specificare come parametri di query:

• ID sviluppatore (indirizzo email) a cui si applica il credito.
• Importo del credito.
• Valuta utilizzata per il credito.
• Nota che descrive il motivo del credito.

Se vuoi, puoi specificare i seguenti parametri di query aggiuntivi:

• Mese di fatturazione a cui si applica il credito. Per impostazione predefinita, questo valore corrisponde al mese corrente.
• Anno di fatturazione a cui si applica il credito. Per impostazione predefinita, questo valore è impostato sull'anno corrente.
• Prodotto API a cui si applica il credito. Se non specifichi un ID prodotto API, il credito si applica a tutti i prodotti API presenti nel pacchetto.

Ad esempio, la seguente richiesta emette un credito di 100 $per il mese di fatturazione di aprile 2018 a uno sviluppatore identificato come dev1@myorg.com. Il credito si applica al pacchetto di prodotti API payment e al piano tariffario payment_standard_plan:

Consulta Parametri di query per l'API Credits per un elenco completo dei parametri di query che puoi specificare in una richiesta di credito.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/rate-plans/payment_standard_plan/real-currency-credit-transactions?currencyId=usd&developerId=dev1@myorg.com&transactionAmount=100&transactionNote=Credit+for+failed+transactions&billingMonth=APRIL&billingYear=2013" \
-u email:password

Di seguito è riportato un esempio di estratto della risposta:

{
  "currency" : "USD",
  "developer" : {
    "address" : [ {
      "address1" : "Dev One Address",
     ...
    } ],
    "approxTaxRate" : 0.0000,
    "billingType" : "PREPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev1@myorg.com",
    "hasSelfBilling" : false,
    "id" : "K4jW2QLjZ1h8GFA8",
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
     ...
    },
    "registrationId" : "TestRegId",
    "status" : "ACTIVE",
    "type" : "TRUSTED"
  },
  "endTime" : "2013-09-04 15:54:36",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8107,
  "gbpExchangeRate" : 0.6860,
  "id" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "isVirtualCurrency" : false,
  "notes" : "Credit for failed transactions",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  "providerTxId" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "rate" : 100,
  "ratePlan" : {
    ...
      },
      "status" : "ACTIVE",
      "virtualCurrency" : false
    },
    "description" : "Standard Plan",
    "displayName" : "Standard Plan",
    …
    "monetizationPackage" : {
      "description" : "Payment",
      ...
        } ],
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Payment",
        "displayName" : "Payment",
        "id" : "payment",
        "name" : "payment",
        "organization" : {
          ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Standard Plan",
    "organization" : {
     ...
    },
    ...
      },
      ...
      },
      ...
  },
  "revenueShareAmount" : 0,
  "startTime" : "2013-09-04 15:54:36",
  "status" : "SUCCESS",
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "CREDIT",
  "usdExchangeRate" : 1.0675,
  "utcEndTime" : "2013-09-04 15:54:36",
  "utcStartTime" : "2013-09-04 15:54:36"
}

Parametri di query per l'API Credits

I seguenti parametri di query sono disponibili per l'utilizzo con l'API Credits:

Nome	Descrizione	Predefinito	Obbligatorio?
billingMonth	Mese di fatturazione a cui si applica il credito, ad esempio APRIL.	N/D	No
billingYear	Anno di fatturazione a cui si applica il credito, ad esempio 2018.	N/D	No
currencyId	Valuta utilizzata per il credito. La valuta è configurata per il piano tariffario nel pacchetto di prodotti API acquistato dall'autore e non può essere modificata.	N/D	Sì
developerId	Nome dello sviluppatore o della società a cui si applica il credito.	N/D	Sì
productId	Prodotto API a cui si applica il credito. Se non specifichi un ID prodotto, il credito si applica a tutti i prodotti API nel pacchetto di prodotti API.	N/D	No
transactionAmount	Importo del credito (nella valuta specificata). Specifica un valore positivo o negativo. Il valore non può essere zero.	N/D	Sì
transactionNote	Tieni presente che descrive il motivo dell'accredito.	N/D	Sì