Quem paga, e quem é limitado
Um envio precisa dos dois: uma unidade na conta de unidades e crédito na conta-pai. Unidades são um
limite, não dinheiro pré-pago. Uma mensagem de três partes consome três unidades.
Uma conta de unidades é sempre filha direta de uma conta que tem dinheiro. Uma conta de unidades não
pode ter filhas próprias.
Como as unidades são contadas
As unidades são contadas pelo mesmo motor que conta o crédito pré-pago: cada nó do gateway reserva um bloco, gasta-o da memória sem nenhuma chamada ao banco por mensagem, e liquida o que foi gasto. A contagem é exata após um crash.- Uma mensagem reembolsada devolve a sua unidade, uma vez: uma recusa do fornecedor, uma expiração, um descarte, uma mensagem que não pôde ser enfileirada.
- Pequenas franquias são repartidas com justiça. Um nó nunca reserva mais do que a sua parte do que está livre, e devolve um bloco que não usou por alguns segundos, então cinco unidades num gateway de dois nós são cinco mensagens enviáveis, seja qual for o nó que o cliente alcance.
- As unidades são aplicadas onde quer que o crédito pré-pago seja. Num gateway com a aplicação do pré-pago desligada, os logins de uma conta de unidades não são carregados e não podem fazer bind nem enviar: nada as estaria contando.
O que um cliente vê quando elas acabam
Nada é cobrado em nenhum dos três, e no terceiro a unidade é devolvida.
0x403 deliberadamente não é o 0x402 de sem crédito: um cliente consegue distinguir “estou sem
unidades” de “meu provedor está sem dinheiro”. O status é definido por listener com
conf.status.noUnits, em hexadecimal ou decimal; o padrão é 0x00000403.
unitsPending é o único que vale a pena repetir: unidades retidas em outro lugar voltam em segundos.
De onde vêm as contas de unidades
Uma conta de unidades é criada, recebe unidades e tem unidades retiradas pela plataforma que a gerencia (o FireFlo OMNI, por exemplo), pela API de gerenciamento do gateway. O painel de controle mostra as contas de unidades e o seu ledger; ele não as cria nem move unidades. Toda concessão, retirada e movimentação é escrita num ledger de unidades somente de inclusão, sob uma referência, e uma repetição com a mesma referência não muda nada. Para toda conta e produto, livres + reservadas + usadas é igual à soma do seu ledger. Uma plataforma só pode criar contas de unidades enquanto a aplicação do pré-pago estiver ligada e todo nó do gateway em execução for 0.16.0 ou mais novo. Durante uma atualização gradual, isso começa assim que o último nó mais antigo sai. Uma conta existente nunca é convertida. Uma conta de dinheiro continua sendo uma conta de dinheiro; uma conta de unidades é uma conta nova sob a conta-pai. Dinheiro não pode ser movido para ou de uma conta de unidades: top-ups, débitos e transferências de crédito que nomeiem uma são recusados.O que um login de unidades não pode fazer
Um login de unidades não é a sua conta-pai na API de autoatendimento.- Balance responde com as suas próprias unidades, nunca com o dinheiro da conta-pai. Veja Balance.
- Um envio aceito não mostra o preço da conta-pai.
- A cotação de tarifa, as transferências de crédito, os registros de sender ID e de template e a lista
de lotes respondem
403com códigoUNITS_LOGIN. Eles pertencem à conta que paga.
Com que velocidade ela pode enviar
Uma conta de unidades pode ter um limite de velocidade próprio, além do da sua conta-pai. A plataforma que a gerencia o define; dois valores, e qualquer um deles pode ficar sem definição.
Precedência. Um submit é verificado primeiro contra o limite próprio da conta de unidades. Acima
dele, o submit é recusado sem consumir o limite da conta-pai, então um cliente enviando rápido demais
não esgota a franquia do seu reseller. Dentro dele, os limites da conta-pai se aplicam como sempre: o
conf.maxRate próprio da conta-pai, o padrão do listener e o orçamento da porta. Um login com um
limite próprio mais rápido continua preso ao limite da sua conta de unidades.
0x58 significa “vá mais devagar”; 0x14 significa “tente de novo em instantes”. Vazio ou 0
significa que a conta de unidades não tem limite próprio, e só os da conta-pai se aplicam.
Os binds de um login de unidades contam contra o limite de conexões da sua conta-pai. Não há limite de
binds separado por conta de unidades.
No painel de controle
A página de uma conta de unidades diz units no lugar de um saldo e nomeia a conta em que ela é cobrada. A sua aba Billing mostra as unidades restantes e usadas por produto, os seus logins, as unidades usadas neste mês e por dia, os seus limites de velocidade e o ledger de unidades. As abas Tariff e Statement não são mostradas: os preços e o extrato são da conta-pai. Nenhuma ação de dinheiro é oferecida. A aba Billing de uma conta-pai lista as suas subcontas, com as unidades restantes por produto e um estado “no units”. Se as contas de unidades ainda não podem ser usadas, porque um nó é mais antigo que 0.16.0 ou a aplicação do pré-pago está desligada, a aba diz qual dos dois. As mensagens recusadas aparecem em Refused sob No units left e Units being reserved; try again. A conta mostrada ali é a conta-pai, que paga; o login é o da conta de unidades.Atualizando para a 0.16.0
O schema passa de 1.129.0 para 1.131.0, então atualize com--migrate. Isso adiciona tabelas de
unidades vazias e uma coluna anulável no registro de chamada. Uma instalação sem contas de unidades se
comporta como na 0.15.13. Uma chave é nova, conf.status.noUnits; nada precisa ser definido.
Atualize o painel de controle junto com o gateway: um painel mais antigo reporta o schema como mais
novo do que espera.
Relacionado
Crédito pré-pago
O motor pelo qual as unidades são contadas.
Códigos de status
0x403, e o que ele deliberadamente não é.