Hi,
I’m trying to understand the availability of previousOriginalTransactionId in App Store Server Notifications.
According to Apple documentation, the field exists here:
https://developer.apple.com/documentation/appstoreservernotifications/previousoriginaltransactionid
And the App Store Server Notifications changelog indicates it was added in March 2025:
However, I cannot find this field in practice.
What I checked
I’m using the Java App Store Server Library version 5.1.1 (latest on Maven Central).
JWSTransactionDecodedPayload does not expose a property/getter for previousOriginalTransactionId.
Example:
JWSTransactionDecodedPayload payload =
verifier.verifyAndDecodeTransaction(signedTransaction);
There does not appear to be something like:
payload.getPreviousOriginalTransactionId()
I initially assumed this was an SDK lag issue, so I decoded the raw JWS payload JSON manually. However, I also do not see previousOriginalTransactionId in the decoded payload.
Questions
- Is
previousOriginalTransactionIdonly included for specific transaction/subscription migration scenarios? - Has anyone actually observed this field in production or sandbox payloads?
- Is the Java SDK simply behind, or is the field conditionally emitted and I’m testing the wrong flow?
Environment:
- App Store Server Library Java:
5.1.1 - Dependency source: Maven Central
- Class:
JWSTransactionDecodedPayload - Verified by inspecting decoded raw JWS payload as well