Gerenciar saldos pós-pagos usando limites de crédito

Você está visualizando a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Introdução

Ao adicionar uma moeda aceita para uma organização, é possível definir um limite de crédito para um desenvolvedor pós-pago, conforme descrito em Adicionar moedas aceitas. O limite de crédito se aplica a todos os desenvolvedores pós-pagos na organização. Além disso, é possível definir o limite de crédito de um desenvolvedor pós-pago individual, conforme descrito nas seções a seguir. Nesse caso, o limite de crédito substitui qualquer limite definido para a moeda apenas para o desenvolvedor especificado.

Como definir um limite de crédito usando a API

Para definir um limite de crédito para um desenvolvedor individual, emita uma solicitação POST para /organizations/{org_name}/developers/{developer_id}/developer-credit-limit, em que {developer_id} é o endereço de e-mail do desenvolvedor. Ao emitir a solicitação, você precisa especificar como parâmetros de consulta o valor do crédito e a moeda usada para o crédito. Por exemplo, a solicitação a seguir define um limite de crédito de US $1.000 para um desenvolvedor:

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev7@myorg/developer-credit-limit?amount=1000&supportedCurrencyId=usd" \
-u email:password

Como recuperar um limite de crédito usando a API

Para recuperar um limite de crédito para um desenvolvedor pós-pago, envie uma solicitação GET para /organizations/{org_name}/developers/{developer_id}/developer-credit-limit, em que {developer_id} é o endereço de e-mail do desenvolvedor. Exemplo:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev7@myorg/developer-credit-limit" \
-u email:password

A resposta deve ser semelhante a esta (apenas parte da resposta é exibida):

{
  "developerBalance" : [ {
    "amount" : 1000.0000,
    "id" : "ddd98cd5-06bc-481b-ae42-76a7345933a9",
    "supportedCurrency" : {
      "description" : "United States Dollar",
      "displayName" : "United States Dollar",
      "id" : "usd",
      "name" : "USD",
      "organization" : {
        ...
      },
      "status" : "ACTIVE",
      "virtualCurrency" : false
    },
    "usage" : 76.6052
  } ],
  "totalRecords" : 1
}

Próximas etapas

Você pode postar reembolsos (somente para transações de compra) usando a monetização. Saiba como fazer isso em Post refunds.