Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Introdução
A monetização oferece a flexibilidade de emitir crédito ao desenvolvedor.
Para um desenvolvedor pré-pago, um crédito aparece como uma redução no uso, o que aumenta ou diminui o saldo pré-pago do desenvolvedor daqui para frente. Da mesma forma que o uso de um cartão de débito, os fundos são retirados do saldo pré-pago de um desenvolvedor quando ele compra um pacote de produtos da API. O desenvolvedor precisa manter um saldo adequado para compras. Consulte Como calcular o saldo restante da conta pré-paga?
Para um desenvolvedor pós-pago, um crédito aparece como uma linha separada em uma fatura, reduzindo a cobrança em uma fatura.
Conheça a página "Créditos"
Acesse e explore a página "Créditos", conforme descrito abaixo.
Edge
Para acessar a página "Créditos" usando a interface do usuário do Edge:
- Faça login em apigee.com/edge.
- Selecione Publicar > Monetização > Créditos na barra de navegação à esquerda.
A página Créditos é exibida.
Como destacado na figura, a página Créditos permite que você:
- Conferir informações resumidas de todos os créditos, incluindo nome do destinatário, valor do crédito, data e hora em que o crédito entrou em vigor, pacote de produtos da API e produtos de API a que o crédito se aplica e todas as observações adicionadas
- Emitir um crédito
- Pesquisar na lista de créditos
Borda clássica (nuvem privada)
Para acessar a página "Créditos" usando a interface clássica do Edge:
- Faça login em
http://ms-ip:9000
, em que ms-ip é o endereço IP ou o nome DNS do nó do servidor de gerenciamento. - Selecione Monetização > Relatórios de monetização na barra de navegação superior.
Na página "Créditos", você pode:
- Conferir informações resumidas de todos os créditos, incluindo nome do destinatário, valor do crédito, data e hora em que o crédito entrou em vigor, pacote de produtos da API e produtos de API a que o crédito se aplica e todas as observações adicionadas
- Emitir um crédito
- Pesquisar na lista de créditos
Como emitir um crédito
- Acesse a página "Créditos".
- Clique em + Crédito.
- Digite as seguintes informações:
Campo Descrição Mês do faturamento Mês do faturamento em que o crédito se aplica. Selecione um mês na lista.
Desenvolvedor Nome do desenvolvedor ou da empresa a que o crédito se aplica. Insira o nome na caixa de texto. Conforme você digita, uma lista de desenvolvedores/empresas que contêm a string é exibida em um menu suspenso. Clique no nome do desenvolvedor ou da empresa na lista suspensa.
Observação: depois que você selecionar um desenvolvedor ou empresa, os campos restantes serão exibidos. Se você selecionar uma empresa ou um desenvolvedor que não aceitou um plano de tarifas, não será possível emitir um crédito.
Pacote de produtos Pacote de produtos da API a que o crédito se aplica. Selecione uma opção na lista de pacotes de produtos de API disponíveis.
Produto Produto da API no pacote de produtos de API selecionado a que o crédito se aplica. Selecione Todos os produtos ou um único produto de API na lista.
Moeda Moeda usada para o crédito. A moeda é configurada para o plano de tarifas no pacote de produtos da API que o desenvolvedor comprou e não pode ser alterada. Se houver várias moedas definidas em um plano de tarifas, selecione uma delas.
Valor Valor do crédito (na moeda especificada). Especifique um valor positivo ou negativo. O valor não pode ser zero.
Observação Observação opcional para descrever o motivo do crédito.
- Clique em Salvar crédito.
Como emitir créditos usando a API
Usando a API, emita crédito para um desenvolvedor em relação a um pacote de produtos de API como um todo ou ao uso de um produto de API específico em um pacote de produtos de API.
Para emitir um crédito usando a API, emita uma solicitação POST para /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions
, em que {package_id}
e {rate-plan_id}
definem a identificação do pacote de produtos da API e o plano de tarifas a que o crédito se aplica, respectivamente.
Ao emitir a solicitação, você precisa especificar como parâmetros de consulta:
- ID do desenvolvedor (endereço de e-mail) a que o crédito se aplica.
- Valor do crédito.
- Moeda usada para o crédito.
- Nota que descreve o motivo do crédito.
Também é possível especificar os seguintes parâmetros de consulta adicionais:
- Mês de faturamento a que o crédito se aplica. Por padrão, esse valor é o mês atual.
- Ano de faturamento a que o crédito se aplica. Por padrão, esse valor é o ano atual.
- Produto da API a que o crédito se aplica. Se você não especificar um ID do produto da API, o crédito vai ser aplicado a todos os itens no pacote.
Por exemplo, a solicitação a seguir emite um crédito de US $100 no mês de faturamento de abril de 2018 para um desenvolvedor identificado como dev1@myorg.com
. O crédito se aplica ao
pacote de produtos da API payment
e ao plano de tarifas payment_standard_plan
:
Consulte Parâmetros de consulta para API de créditos e confira uma lista completa dos parâmetros de consulta que podem ser especificados em uma solicitação de crédito.
$ 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
Confira abaixo um exemplo da resposta:
{ "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" }
Parâmetros de consulta para API de créditos
Os seguintes parâmetros de consulta estão disponíveis para uso com a API Credit:
Nome | Descrição | Padrão | Obrigatório? |
---|---|---|---|
billingMonth |
Mês de faturamento a que o crédito se aplica, como ABRIL. |
N/A | Não |
billingYear |
Ano de faturamento a que o crédito se aplica, como 2018. |
N/A | Não |
currencyId |
Moeda usada para o crédito. A moeda é configurada para o plano de tarifas no pacote de produtos da API que o desenvolvedor comprou e não pode ser alterada. |
N/A | Sim |
developerId |
Nome do desenvolvedor ou da empresa a que o crédito se aplica. |
N/A | Sim |
productId |
Produto da API a que o crédito se aplica. Se você não especificar um ID do produto, o crédito será aplicado a todos os produtos da API no pacote de produtos. |
N/A | Não |
transactionAmount |
Valor do crédito (na moeda especificada). Especifique um valor positivo ou negativo. O valor não pode ser zero. |
N/A | Sim |
transactionNote |
Essa informação descreve o motivo do crédito. |
N/A | Sim |