API de Facturación

La instantánea del saldo consciente de la fuente del proyecto que llama. Todos los montos en milicréditos son cadenas decimales canónicas. Es una instantánea, no autoridad para pagar; rails_available es falso mientras la tarjeta, impuestos y canal de retiro no estén disponibles.

Paginación estable con cursor sobre entradas de diario inmutables publicadas para el proyecto que llama. Las retenciones no son entradas publicadas. Las correcciones enlazan al evento original en lugar de reescribirlo. No hay mutación arbitraria de concesión o pago en esta superficie.

El uso del proyecto que llama durante un mes UTC, con los bytes servidos y recibidos (nunca se cobran), el almacenamiento cobrado por encima del almacenamiento gratuito del plan del pagador (allowance.storage_bytes), y las solicitudes de API, los eventos de flujo del proyecto facturados y los intentos de entrega de webhook contados frente a los 10,000 gratuitos al mes. Un proyecto que paga por sí mismo lee su propio fondo.

Un proyecto que otro pagador paga comparte el grupo de ese pagador con los otros proyectos del pagador; lee su propia parte, y payer nombra al pagador. El total del grupo del pagador permanece en las lecturas de facturación del pagador.

Lo que una organización puede comprar mediante App Store en la aplicación de screenRIG para iPhone y iPad (bundle ai.screenrig.app), y el token de cuenta que llevan sus compras.

Requiere un administrador designado de la organización activa (la persona que gestiona su plan y su facturación); el personal y los administradores del revendedor en el que está delegada la organización pueden leer la oferta sin products ni token, y cualquier otra persona recibe 404 not_found.

Una organización delegada en un revendedor no lista productos: su revendedor paga su plan. account_token es un UUID aleatorio que el servidor crea una vez por organización y conserva: la aplicación lo pasa a StoreKit como appAccountToken, de modo que cada transacción y cada notificación del servidor nombra a su organización.

Para un lector que no puede comprar, account_token es el UUID de todo ceros. products enumera los planes que quien llama puede comprar ahora, un producto de App Store cada uno: plus, education (solo mientras education_eligible sea true) y premium. education_eligible es true cuando el personal verificó una escuela o un distrito K-12, o cuando el administrador que lee la oferta tiene una dirección de correo de cuenta verificada en un dominio escolar K-12 (education_eligibility_source school_email): abrir la oferta, o registrar una transacción, como ese administrador hace elegible a la organización una vez, escribe una entrada de auditoría de la organización con el dominio coincidente e incluye Education en la misma oferta.

Una decisión del personal, en uno u otro sentido, es definitiva y la elegibilidad automática nunca la anula.

No se ofrece un plan que la organización ya tiene por otra vía (personal, facturación, otra suscripción) en el mismo nivel o en uno superior, salvo a la persona cuya suscripción de App Store lo tiene, que puede cambiar de plan dentro del grupo de suscripciones. can_purchase es true cuando products no está vacío. subscription es la suscripción de App Store de la organización, o null.

La respuesta es privada y no-store.

Registra una transacción firmada de StoreKit 2 (Transaction.jwsRepresentation) comprada para la organización y coloca a la organización en su plan. Requiere un administrador designado de la organización activa, autenticación por cookie del mismo origen y, para sesiones JWT, el encabezado CSRF.

El servidor verifica el JWS con su cadena x5c hasta Apple Root CA - G3 (fuera de producción también la raíz de pruebas de StoreKit de Xcode), el bundle id ai.screenrig.app, el id de producto, el entorno (Production solo en producción; Sandbox en todas partes, porque App Review y TestFlight compran con cuentas sandbox contra producción; Xcode solo fuera de producción) y que appAccountToken sea igual al account_token de la organización (getAppStoreOffer); nada en la solicitud nombra quién pagó.

El plan sigue el producto de la transacción más reciente de la suscripción: un plan superior se aplica de inmediato y uno inferior cuando lo alcanza el siguiente límite mensual UTC de la facturación, como en cualquier cambio de plan. Enviar una transacción de nuevo, o una anterior, no cambia nada y responde con la suscripción tal como está; una transacción vencida se registra y no cambia ningún plan.

La aplicación finaliza la transacción tras un 2xx o un 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, la organización está delegada en un revendedor, que paga su plan).

App Store Server Notifications V2 de Apple (el cuerpo signedPayload), la URL configurada en App Store Connect para los entornos de producción y sandbox. Pública: la carga útil firmada es la credencial, verificada igual que recordAppStoreTransaction verifica una transacción, junto con la transacción firmada y la información de renovación que contiene.

SUBSCRIBED, DID_RENEW, DID_CHANGE_RENEWAL_PREF y DID_CHANGE_RENEWAL_STATUS (y OFFER_REDEEMED, RENEWAL_EXTENDED y REFUND_REVERSED) aplican la transacción más reciente: una renovación amplía la suscripción, una mejora cambia el plan de inmediato y una degradación cuando el producto inferior se renueva al final del periodo.

EXPIRED, GRACE_PERIOD_EXPIRED, REFUND y REVOKE terminan la suscripción y quitan el plan que estableció, como la facturación quita cualquier plan: en el siguiente límite mensual UTC, sin devolver nada ya concedido. Un plan que el personal o la facturación hayan puesto después en la organización nunca se quita.

Cualquier otro tipo, una notificación de un producto que no es un plan y una que no nombra ninguna organización se confirman y se registran. 200 confirma. Una carga útil que no se verifica es un problema 422 app_store_transaction_invalid; un fallo del lado del servidor es un 5xx, que Apple vuelve a enviar. Limitado por dirección de cliente.