Postar reembolsos

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Introdução

Com a monetização, é possível postar reembolsos para desenvolvedores por "transações de compra". Suponha que você é uma operadora de celular e oferece aos desenvolvedores uma API de pagamento para cobrar os assinantes de dispositivos móveis pelo compra de um aplicativo ou conteúdo dentro dele. Sempre que um assinante usa a API de fazer uma compra, é uma transação de compra.

As transações de compra podem resultar em reembolsos. Por exemplo, o conteúdo pode não ser entregue, ou o terceiro esteja insatisfeito com a compra. Nesses casos, o desenvolvedor emite um reembolso ao terceiro. A monetização permite que você faça um reembolso análogo. Isso é especialmente pertinentes aos planos de participação na receita.

Imagine que o desenvolvedor que emitiu o reembolso ao assinante de dispositivo móvel comprou uma receita plano de compartilhamento do seu produto de API. Suponha que o plano chame o desenvolvedor para receber 70% dos preço líquido/bruto da transação de compra. Ao publicar um reembolso, você, de fato, reverte a transação de compra, ou seja, você deduz 70% do pagamento devido ao desenvolvedor no mês quando o reembolso foi aplicado (o mês pode ser diferente do mês em que o valor real de compra ocorreu).

Como postar um reembolso usando a interface clássica do Edge (somente no Edge para nuvem privada)

Você pode publicar um reembolso para qualquer transação de compra, ou seja, em que a API cobrado do terceiro e para o qual você ainda não emitiu uma reembolso. A publicação de um reembolso resulta na criação de uma transação de reembolso com um familiar responsável. ID da transação, em que o ID da transação é o ID da transação de compra.

Você pode postar um reembolso do valor total da transação de compra original ou de um um valor parcial. Também é possível publicar vários reembolsos parciais, mas o valor total deles não pode ser maior do que o montante original da compra.

Para postar um reembolso, siga estas etapas:

1. Na guia "Monetização", selecione "Reembolsos".

   

   A página "Reembolsos" será aberta.

   

2. No menu suspenso Mês de faturamento, selecione o mês em que a transação de compra o incidente. Em seguida, clique em "+ Reembolsos".

   Isso mostra uma lista de todas as transações de compra concluídas no mês.

   

   É possível filtrar a lista de reembolso por nome do desenvolvedor ou pesquisando na transação.

   Para filtrar por desenvolvedor, selecione-o no menu suspenso "Desenvolvedor". Isso exibe uma lista apenas das transações relacionadas ao desenvolvedor selecionado.

   

   Para filtrar por ID da transação, insira o ID da transação original que você deseja reembolsar. Isso retorna a transação para esse ID.

   

3. Marque a caixa "Selecionar" nas linhas das transações que você quer reembolsar.
4. Selecione Total ou Parcial no menu suspenso Tipo.

   Se você selecionar "Total", o valor total da compra será reembolsado. Se você selecionar Parcial: um valor parcial da compra vai ser reembolsado.

   Se você selecionar Parcial, insira o valor do reembolso parcial no campo Valor. Você pode reembolsar apenas até o valor total da compra. Se você já postou uma reembolso, só poderá inserir um valor até o valor restante na compra. Além disso, se o transação de compra original tiver preços brutos e líquidos, você também precisará declarar se o valor parcial que você quer reembolsar é bruto ou líquido.

   

5. Clique em "Salvar" para processar o reembolso ou em "Cancelar" para cancelar.

   O reembolso será lançado no mês da compra original se o mês de faturamento ainda estiver aberto. Caso contrário, o reembolso será lançado na data atual.

   No caso de um reembolso parcial, o valor parcial e qualquer participação na receita serão processados. é deduzido com base na proporção entre o valor parcial e o valor total. Na de reembolso parcial acima, o valor parcial é 0,50/1,12 = 45% do preço bruto. 45% da participação na receita do desenvolvedor será deduzida.

Verificar na interface se um reembolso foi realizado processados

Para determinar se um reembolso foi processado, selecione o mês de faturamento na parte superior na página "Reembolsos". Este é o mês da compra se o mês de faturamento ainda estiver em aberto ou o mês atual, se o mês de faturamento estiver encerrado. Isso exibe uma lista de todos os reembolsos que foram postado no mês.

Como postar um reembolso usando a API

Para postar um reembolso, envie uma solicitação POST para /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions, em que {package_id} é a identificação do pacote da API para o qual o reembolso se aplica.

Ao emitir a solicitação, você precisa especificar como parâmetros de consulta:

• Identificação da transação de compra que está sendo reembolsada.
• É o tipo de receita (GROSS ou NET) da transação de compra.
• O valor do reembolso.
• Uma observação descrevendo o motivo do reembolso.

Como opção, é possível identificar como parâmetro de URL um pacote de API para o qual o reembolso se aplica.

Consulte Configurações de reembolso para ver uma lista completa dos URLs que podem ser especificados em uma solicitação de reembolso.

Por exemplo, a solicitação a seguir emite um reembolso para uma transação de compra. O reembolso é 50% do valor bruto da transação de compra.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \
-u email:password

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

{
  "application" : {
    ...
    },
    "product" : [ {
      ...
      
     {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    } ],
    ...
  },
  "currency" : "USD",
  "developer" : {
    ...
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
      ...
    },
    ...
  },
  "endTime" : "2013-09-01 21:59:59",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8123,
  "gbpExchangeRate" : 0.6910,
  "grossPrice" : 0.5,
  "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33",
  "isRevOnGrossOrNet" : "NET",
  "isVirtualCurrency" : false,
  "notes" : "Refund for purchase transaction",
  "itemDesc" : "test application",
  "netPrice" : 0.4464,
  "orgRevenueShareAmount" : 0.1339,
  "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  ...
  },
  "ratePlanLevel" : "STANDARD",
  "revenueShareAmount" : 0.3125,
  "startTime" : "2013-09-01 21:59:59",
  "status" : "SUCCESS",
  "tax" : 0.0536,
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "REFUND",
  "usdExchangeRate" : 1.0724,
  "utcEndTime" : "2013-09-01 21:59:59",
  "utcStartTime" : "2013-09-01 21:59:59"
}

Configurações de reembolso para a API

Os seguintes parâmetros de consulta podem ser especificados em uma solicitação de reembolso:

Próximas etapas

Saiba como programar jobs relacionados à monetização e ver os jobs já agendados automaticamente em Programar jobs de monetização.