API de Faturamento

O snapshot do saldo consciente da fonte do projeto chamador. Todos os valores em milicréditos são strings decimais canônicas. É um snapshot, não autoridade para pagar; rails_available é falso enquanto cartão, imposto e rail de saque estão indisponíveis.

Paginação cursor estável sobre entradas de diário imutáveis postadas para o projeto chamador. Holds não são entradas postadas. Correções linkam ao evento original em vez de reescrevê-lo. Não há mutação arbitrária de concessão ou pagamento nesta superfície.

O uso do projeto chamador em um mês UTC, com os bytes servidos e recebidos (nunca cobrados), o armazenamento cobrado acima do armazenamento gratuito do plano do pagador (allowance.storage_bytes) e as solicitações de API, eventos de stream do projeto faturados e tentativas de entrega de webhook contados contra os 10.000 gratuitos por mês. Um projeto que paga por si mesmo lê seu próprio pool.

Um projeto que outro pagador paga compartilha o pool desse pagador com os outros projetos do pagador; ele lê sua própria parte, e payer nomeia o pagador. O total do pool do pagador permanece nas leituras de cobrança do pagador.

O que uma organização pode comprar pela App Store no app do screenRIG para iPhone e iPad (bundle ai.screenrig.app) e o token de conta que suas compras carregam.

Exige um administrador designado da organização ativa (a pessoa que gerencia seu plano e sua cobrança); a equipe e os admins do revendedor ao qual a organização está delegada podem ler a oferta sem products ou token, e qualquer outra pessoa recebe 404 not_found.

Uma organização delegada a um revendedor não lista produtos: o revendedor dela paga pelo plano. account_token é um UUID aleatório que o servidor cria uma vez por organização e guarda: o app o passa ao StoreKit como appAccountToken, de modo que cada transação e cada notificação do servidor nomeia sua organização.

Para um leitor que não pode comprar, account_token é o UUID só de zeros. products lista os planos que quem chama pode comprar agora, um produto da App Store cada: plus, education (somente enquanto education_eligible for true) e premium. education_eligible é true quando a equipe verificou uma escola ou um distrito K-12, ou quando o administrador que lê a oferta tem um endereço de e-mail de conta verificado em um domínio escolar K-12 (education_eligibility_source school_email): abrir a oferta, ou registrar uma transação, como esse administrador torna a organização elegível uma vez, grava uma entrada de auditoria da organização com o domínio correspondente e inclui o Education na mesma oferta.

Uma decisão da equipe, em qualquer sentido, é definitiva e a elegibilidade automática nunca a substitui.

Um plano que a organização já tem por outra origem (equipe, faturamento, outra assinatura) no mesmo nível ou em um nível superior não é oferecido, exceto à pessoa cuja assinatura da App Store o mantém, que pode trocar de plano dentro do grupo de assinaturas. can_purchase é true quando products não está vazio. subscription é a assinatura da App Store da organização, ou null.

A resposta é privada e no-store.

Registra uma transação assinada do StoreKit 2 (Transaction.jwsRepresentation) comprada para a organização e coloca a organização no seu plano. Exige um administrador designado da organização ativa, autenticação por cookie da mesma origem e, para sessões JWT, o cabeçalho CSRF.

O servidor verifica o JWS com sua cadeia x5c até a Apple Root CA - G3 (fora da produção também a raiz de teste do StoreKit do Xcode), o bundle id ai.screenrig.app, o id do produto, o ambiente (Production somente na produção; Sandbox em todo lugar, porque App Review e TestFlight compram com contas sandbox contra a produção; Xcode somente fora da produção) e que appAccountToken seja igual ao account_token da organização (getAppStoreOffer); nada na requisição nomeia quem pagou.

O plano segue o produto da transação mais recente da assinatura: um plano superior vale de imediato e um inferior quando o próximo limite mensal UTC da cobrança o alcança, como em qualquer mudança de plano. Enviar uma transação de novo, ou uma mais antiga, não muda nada e responde com a assinatura como está; uma transação expirada é registrada e não muda nenhum plano.

O app conclui a transação após um 2xx ou um problema 4xx definitivo. Problemas: app_store_transaction_invalid (422), app_store_account_mismatch (409), education_not_eligible (403), app_store_plan_conflict (409), billed_by_reseller (409, a organização é delegada a um revendedor, que paga pelo plano dela).

App Store Server Notifications V2 da Apple (o corpo signedPayload), a URL definida no App Store Connect para os ambientes de produção e sandbox. Público: o payload assinado é a credencial, verificado do mesmo modo que recordAppStoreTransaction verifica uma transação, junto com a transação assinada e as informações de renovação dentro dele.

SUBSCRIBED, DID_RENEW, DID_CHANGE_RENEWAL_PREF e DID_CHANGE_RENEWAL_STATUS (e OFFER_REDEEMED, RENEWAL_EXTENDED e REFUND_REVERSED) aplicam a transação mais recente: uma renovação estende a assinatura, um upgrade muda o plano de imediato e um downgrade quando o produto inferior é renovado no fim do período.

EXPIRED, GRACE_PERIOD_EXPIRED, REFUND e REVOKE encerram a assinatura e removem o plano que ela definiu, como a cobrança remove qualquer plano: no próximo limite mensal UTC, sem retirar nada já concedido. Um plano que a equipe ou o faturamento colocaram na organização depois nunca é removido.

Qualquer outro tipo, uma notificação de um produto que não é um plano e uma que não nomeia nenhuma organização são confirmadas e registradas. 200 confirma. Um payload que não é verificado é um problema 422 app_store_transaction_invalid; uma falha do lado do servidor é um 5xx, que a Apple reenvia. Limitado por endereço do cliente.