Advanced Commerce API の返金は iOS 開発者が返金を始められる唯一の手段。それでも最終判断は Apple にある

通常の iOS 開発者は顧客に返金できません。2026 年 6 月、ある App Store Commerce Engineer は開発者フォーラムの質問に一文で答えました。現時点では、開発者が直接返金することはできない、と。例外はひとつだけで、それは Advanced Commerce API の中にあります。Apple が承認したアプリは、Advanced Commerce API の返金リクエストを送る、返金付きでサブスクリプションを取り消す、任意の金額を求める、といったことができます。それでも、お金が動くかどうかを決めるのは Apple です。

Advanced Commerce API とは何か、誰が使えるのか

Apple は 2025 年 1 月 23 日に Advanced Commerce API をリリースしました。カスタムの単発購入、サブスクリプション、オプションのアドオン付きサブスクリプションからなる、非常に大規模なカタログの App 内課金を扱うための API です。すべての商品を App Store Connect で作成する必要はありません。SKU を自社サーバで定義し、購入時に Apple へ送ります。

利用はアプリ単位で認められます。申請フォームに記入する必要があり、Apple の適格性ページは、アプリの中核でなければならない 3 つのビジネスモデルを挙げています。

• オーディオブック、クラス、講座、ミニアプリなど、非常に大規模な単発購入のカタログ。
• クリエイターごとの提供内容がそれぞれ独立したサブスクリプションになっている、非常に大規模なサブスクリプションコンテンツのカタログ。
• プレミアムチャンネルやスポーツなど、オプションのアドオンが 1 つの購入としてまとめて更新されるサブスクリプション。

別のプログラムがこの API を必要とする場合も、Apple はアプリの申請を認めています。ホストされたミニアプリにおける対象の App 内課金売上の 85% をメンバーに支払う Mini Apps Partner Program は、この API の利用を条件としています。

返金エンドポイントは後から追加され、署名が必要

2025 年 3 月 24 日付のバージョン 1.1 で、Request Transaction Refund と Revoke Subscription が追加されました。Apple のプログラムページによれば、サブスクリプションコンテンツを提供するアプリは、解約の処理、購入後のコンテンツ検証、カタログ管理のために Cancel、Revoke、Refund の API を使える場合もあります。各エンドポイントのページには同じ条件があります。Account Holder が Advanced Commerce API Addendum に署名しなければならず、最新版に同意していなければ呼び出しはエラーを返します。各エンドポイントの想定用途を定めているのはドキュメントではなく Addendum です。

3 つのエンドポイントを並べて比較

Cancel a Subscription は次回の課金を止める

Cancel は自動更新をオフにします。Apple によれば、顧客は現在の期間が終わるまでアクセスを維持します。返金は一切ありません。顧客が解約を望み、支払った期間をすでに使い切っている場合に適した呼び出しです。

Revoke Subscription はすべてを即座に終わらせる

Revoke は自動更新を false にし、全額または日割りの返金とともにサブスクリプションを取り消します。リクエスト本文には refundReason、refundRiskingPreference、refundType、requestInfo を含めます。その後 Apple は、App Store Server Notifications V2 のエンドポイントに REFUND 通知を送ります。Apple の指示は具体的です。通知に含まれる revocationDate の時点でサービスを停止し、通知が届く前には停止しないこと。

Request Transaction Refund はアイテム単位で動く

これが精密な道具です。アイテムのリストを送り、それぞれに SKU、refundReason、refundType、revoke フラグを指定します。CUSTOM の場合は通貨の 1000 分の 1 単位で refundAmount も送ります。つまり 4990 は 4.99 を意味します。FULL や PRORATED で金額を送ると、Apple はエラー 4000155 で拒否します。レスポンスには署名付きの取引情報が含まれ、サブスクリプションの場合は署名付きの更新情報も含まれます。

Apple が受け付ける refundReason の値は UNINTENDED_PURCHASE、FULFILLMENT_ISSUE、UNSATISFIED_WITH_PURCHASE、LEGAL、OTHER、MODIFY_ITEMS_REFUND です。7 つ目の SIMULATE_REFUND_DECLINE はサンドボックスと TestFlight でのテスト専用です。この値があるのは、App Store が断ることがあるからです。

自分の返金リクエストでも Apple は拒否できる

このエンドポイントの名前は正直です。これはあくまで「リクエスト」です。決定権が本当はどこにあるかは、2 つのフィールドを見るとわかります。

refundRiskingPreference は消費データの確認を招く

Apple は refundRiskingPreference を、返金判断の参考として App Store が開発者に消費データを求めるかどうかを示すもの、と説明しています。デフォルトは true です。true の場合、自分の返金リクエストについて CONSUMPTION_REQUEST を受け取り、Send Consumption Information で応答します。Apple は、CONSUMPTION_REQUEST の受信から 12 時間以内に応答するよう開発者に求めています。false にすれば、この通知は届きません。

「ノー」を告げるエラー

備えておくべきは PendingRefundError です。よくある原因は、サポートチームが対応する前に、顧客がすでに Report a Problem から Apple に申し出ているケースです。Apple の適格性ルールでは、これらのアプリはいずれにせよアプリ内に返金への導線を用意する必要があります。Report a Problem へのリンクか beginRefundRequest API のどちらかです。そのため、2 つの扉が同時に開いた状態になります。

Advanced Commerce API の返金で失うお金

自分から返金するほうが、争うより安く感じられます。それでもお金は出ていきますし、この API では、ある種のミスを大規模に繰り返しやすくなります。

カスタム金額に含まれる税

Apple によれば、リクエストする refundAmount は、カナダと米国を除くすべての地域で税込みでなければなりません。税抜きの SKU 価格から CUSTOM の返金額を計算するチームは、それ以外のすべてのストアフロントで返金額が不足し、1 件ずつ修正するためにサポートの工数を払うことになります。

戻ってこないコスト

• 支払い済みの分配金：クリエイターカタログやミニアプリのホストでは、クリエイターの取り分が販売時に支払われていることがよくあります。顧客への返金でそれは回収できません。
• コンテンツのライセンス料：オーディオブックや講座について権利者に支払うタイトルごとの料金は、契約によってはアクセスの時点で発生し、返金しても元に戻りません。
• 計算資源：その購入のために行ったストリーミング、トランスコード、あらゆるサーバ処理は、すでに請求額に含まれています。
• API 呼び出し：音声からモデル推論まで、リクエスト単位で課金される外部サービスは、返金後も請求されたままです。

1 アイテムのつもりが全額返金

Revoke Subscription は、アドオンを含むサブスクリプション全体を返金し、終了させます。顧客が異議を唱えているのが 1 つのアドオンだけなら、Request Transaction Refund でその SKU だけを返金し、そのアイテムにだけ revoke を設定できます。1 アイテムへの苦情に Revoke Subscription を使うと、基本プランの売上まで返すことになります。

有効にする前の実装チェックリスト

• Account Holder が現行の Advanced Commerce API Addendum に同意していることを確認し、失効時に返ってくるエラーにアラートを設定する。
• リクエストごとに新しい requestReferenceId の UUID を生成し、同じ値を再利用するのはタイムアウトした呼び出しの再試行時だけにする。
• 返金の呼び出しはキューに入れる。上限はアプリごとに毎秒 5 件で、429 には UNIX ミリ秒で表した Retry-After ヘッダが付く。
• サンドボックスで SIMULATE_REFUND_DECLINE を使って拒否をテストし、サンドボックスの上限が本番の 10% であることを忘れない。
• refundRiskingPreference はケースごとに決め、true のままにする場合は 12 時間の期限に備えて消費データの応答処理を用意しておく。
• アクセスを終了するのは REFUND 通知が届いてからにし、その revocationDate を基準にする。
• すべてのリクエストについて理由、金額、SKU を記録し、Apple より先に自社の返金率を把握できるようにする。