Post

Replies

Boosts

Views

Activity

External purchase tokens confusion
Hi, I'm trying to understand how the external purchase token reporting flow is supposed to work. The documentation says: At launch and before every potential transaction, call the token(for:) function to request the external purchase tokens, using the token types ACQUISITION and SERVICES. Associate these tokens with a customer account on your server. Doc In another article, Apple says: To send a report, call the Send External Purchase Report endpoint for each token. Send reports in all of the following cases: To report a token, with line items, when a customer completes one or more transactions. To report a token, without line items, when a customer doesn’t complete any transactions. To report an unrecognized token, when you receive an App Store Server Notification about a token that you don’t have recorded in your system. To report duplicate ACQUISITION and SERVICES tokens. Doc I'm having trouble reconciling these requirements and would appreciate some clarification. My questions are: If I receive ACQUISITION and SERVICES tokens at app launch, but the user never attempts a purchase, should I eventually report those tokens without line items (case #2)? If so, when should that report be sent? If a user starts the purchase flow but abandons it (for example, closes the browser or cancels payment), should that token be reported without line items under case #2? If I receive a new SERVICES token that covers the same validity period as a previously stored token, should it be treated as a duplicate and reported immediately under case #4? Should I still store that token on my server? The documentation says to call the Send External Purchase Report endpoint "for each token." Does that mean every transaction must be reported against all relevant tokens, or only against the specific token associated with that transaction? An end-to-end example of the expected token lifecycle (request → store → use for transactions → report) would be very helpful. Any guidance or examples of the intended workflow would be greatly appreciated.
0
0
62
2w
External purchase region
Hi everyone, I have a question regarding App Store subscriptions and tax country / storefront changes. If a customer originally purchased a subscription while their App Store country was France (so we reported France as the tax country), and later updates or renews that same subscription while located in Hungary, which country should we report going forward? Should we continue using the original country (France)? Or should we start sending the new country (Hungary) once it changes? Also, what happens if the customer changes their App Store region entirely, for example from France to the US? How is Apple’s commission calculated after the region change? If anyone has experience with this scenario or knows the official Apple behavior, I’d really appreciate your help. Thanks!
2
0
266
Apr ’26
External Purchase clarifying
Hi! I’m facing some difficulties while integrating with Apple external purchase API. I would like to clarify a few points in the documentation. Subscription Events Documentation mentions four subscription events: SUBSCRIPTION_START, SUBSCRIPTION_CHANGE, SUBSCRIPTION_PAYMENT, and RENEWAL. Could you clarify what SUBSCRIPTION_PAYMENT is used for? The examples indicate that we should send the tax and payment amounts in the SUBSCRIPTION_START and RENEWAL events. Should we also send them for SUBSCRIPTION_PAYMENT? 2. Unused Tokens Customers generate ACQUISITION and SERVICE tokens and send them to us. According to the documentation, we must report every token received. If we process balance transactions linked to an ACQUISITION token, should we send the SERVICE token with NO LINE ITEM? Should we continue sending the SERVICE token with NO LINE ITEM status in the following months? 3. Should we send reports only once a month? What should we do if, at the time a transaction is received, the token was active, but by the time the report is due, it has already expired? Do we still need to report it in that case? 4. What should we do if we receive a notification about an unreported token in the middle of the month? Should we send the report immediately, or should we take note of the token and include it in the report at the scheduled time at the beginning of the month? 5. Am I correct in understanding that if a user purchases a monthly subscription and cancels the renewals within the same month, the reports will contain only one event — SUBSCRIPTION_START with subscriptionDaysOfPaidService = 0? If a renewal for a monthly subscription fails and the payment is completed after a 7-day grace period, should we report 37 days or 30 days in subscriptionDaysOfPaidService in the RENEWAL event? Thank you in advance for your guidance!
0
0
128
Apr ’26
External purchase tokens confusion
Hi, I'm trying to understand how the external purchase token reporting flow is supposed to work. The documentation says: At launch and before every potential transaction, call the token(for:) function to request the external purchase tokens, using the token types ACQUISITION and SERVICES. Associate these tokens with a customer account on your server. Doc In another article, Apple says: To send a report, call the Send External Purchase Report endpoint for each token. Send reports in all of the following cases: To report a token, with line items, when a customer completes one or more transactions. To report a token, without line items, when a customer doesn’t complete any transactions. To report an unrecognized token, when you receive an App Store Server Notification about a token that you don’t have recorded in your system. To report duplicate ACQUISITION and SERVICES tokens. Doc I'm having trouble reconciling these requirements and would appreciate some clarification. My questions are: If I receive ACQUISITION and SERVICES tokens at app launch, but the user never attempts a purchase, should I eventually report those tokens without line items (case #2)? If so, when should that report be sent? If a user starts the purchase flow but abandons it (for example, closes the browser or cancels payment), should that token be reported without line items under case #2? If I receive a new SERVICES token that covers the same validity period as a previously stored token, should it be treated as a duplicate and reported immediately under case #4? Should I still store that token on my server? The documentation says to call the Send External Purchase Report endpoint "for each token." Does that mean every transaction must be reported against all relevant tokens, or only against the specific token associated with that transaction? An end-to-end example of the expected token lifecycle (request → store → use for transactions → report) would be very helpful. Any guidance or examples of the intended workflow would be greatly appreciated.
Replies
0
Boosts
0
Views
62
Activity
2w
External purchase API notifications
Hi! We use external purchase API and have a question What should we do if we receive a notification about an unreported token in the middle of the month? Should we send the report immediately, or should we take note of the token and include it in the report at the scheduled time at the beginning of the month?
Replies
0
Boosts
0
Views
18
Activity
2w
External purchase region
Hi everyone, I have a question regarding App Store subscriptions and tax country / storefront changes. If a customer originally purchased a subscription while their App Store country was France (so we reported France as the tax country), and later updates or renews that same subscription while located in Hungary, which country should we report going forward? Should we continue using the original country (France)? Or should we start sending the new country (Hungary) once it changes? Also, what happens if the customer changes their App Store region entirely, for example from France to the US? How is Apple’s commission calculated after the region change? If anyone has experience with this scenario or knows the official Apple behavior, I’d really appreciate your help. Thanks!
Replies
2
Boosts
0
Views
266
Activity
Apr ’26
External Purchase clarifying
Hi! I’m facing some difficulties while integrating with Apple external purchase API. I would like to clarify a few points in the documentation. Subscription Events Documentation mentions four subscription events: SUBSCRIPTION_START, SUBSCRIPTION_CHANGE, SUBSCRIPTION_PAYMENT, and RENEWAL. Could you clarify what SUBSCRIPTION_PAYMENT is used for? The examples indicate that we should send the tax and payment amounts in the SUBSCRIPTION_START and RENEWAL events. Should we also send them for SUBSCRIPTION_PAYMENT? 2. Unused Tokens Customers generate ACQUISITION and SERVICE tokens and send them to us. According to the documentation, we must report every token received. If we process balance transactions linked to an ACQUISITION token, should we send the SERVICE token with NO LINE ITEM? Should we continue sending the SERVICE token with NO LINE ITEM status in the following months? 3. Should we send reports only once a month? What should we do if, at the time a transaction is received, the token was active, but by the time the report is due, it has already expired? Do we still need to report it in that case? 4. What should we do if we receive a notification about an unreported token in the middle of the month? Should we send the report immediately, or should we take note of the token and include it in the report at the scheduled time at the beginning of the month? 5. Am I correct in understanding that if a user purchases a monthly subscription and cancels the renewals within the same month, the reports will contain only one event — SUBSCRIPTION_START with subscriptionDaysOfPaidService = 0? If a renewal for a monthly subscription fails and the payment is completed after a 7-day grace period, should we report 37 days or 30 days in subscriptionDaysOfPaidService in the RENEWAL event? Thank you in advance for your guidance!
Replies
0
Boosts
0
Views
128
Activity
Apr ’26