Transactions

Update StoreKit Status

Changed on

Reports a StoreKit subscription state change for a migration transaction. As of 2026-04-27, this is a trigger to verify endpoint: when the SDK reports storekit_status=2 (anything other than active), the backend queries Apple's App Store Server API itself and persists what Apple reports onto the transaction's storekit_apple_status and storekit_subscription_end fields. Billing-relevant data is never sourced from the client.

patch/iap/transactions/{transaction_id}/storekit-status

Request

  • Base URL
    https://api.zerosettle.io/v1
  • URL
    https://api.zerosettle.io/v1/iap/transactions/{transaction_id}/storekit-status
  • Auth
    API key in header X-ZeroSettle-Key

Path parameters

transaction_idstring required

The transaction ID.

Request body

storekit_status1 | 2 required

1 = active (finished successfully, no further action). 2 = anything-not-active (cancelled, expired, billing retry, grace period, revoked). When 2 is reported, the backend triggers a server-side Apple App Store Server API query to resolve the canonical state.

storekit_original_transaction_idstring

Apple originalTransactionId for the subscription. Used by the backend to query Apple's API for the canonical subscription state when storekit_status=2. Optional — the backend will fall back to the value stored at transaction creation time when omitted.

storekit_subscription_endstring date-time

Deprecated as of 2026-04-27. Accepted for backwards compatibility but ignored — the backend now resolves the actual subscription expiry from Apple's App Store Server API. Existing SDKs may continue sending this field; new SDKs should omit it.

Response

Status updated

idstring

The transaction ID.

storekit_statusinteger

The updated StoreKit status.

Changes