Shopify

Dev Dashboard のアプリを通じて Shopify ストアを接続し、注文、返金、手数料、サブスクリプション契約を読み込みます。

RevGlance は Shopify の GraphQL Admin API を通じてストアを読み込みます。アプリのクライアント ID とシークレット（クライアントクレデンシャルグラント）でサインインするため、アプリと同じ組織のストアでのみ使えます。

接続

Shopify の Dev Dashboard で、ストアと同じ組織にアプリを作成します。
read_orders、read_all_orders、read_own_subscription_contracts、read_customers のスコープを付与し、バージョンをリリースして、ストアにアプリをインストールします。
アプリの Settings から Client ID と Client secret（shpss_ で始まります）をコピーします。
ストアの .myshopify.com アドレスと 2 つの値を入力し、Shopifyを接続を選びます。

Shopify はソースがすでに持っているアプリのクライアントシークレットで Webhook に署名するため、貼り付けるシークレットはありません。

RevGlance で 設定 › ソース を開き、Shopify ソースのメニューを開いて Webhook を選びます。URL をコピーします。
アプリの設定で、その URL をエンドポイントとして注文、返金、サブスクリプション契約のトピックをサブスクライブし、変更をリリースします。

支払い済みの注文。税抜き、ストアの通貨で、Shopify Payments の手数料を含みます。テスト注文は含めません。read_all_orders スコープがあれば、最初の同期で Shopify のデフォルトの 60 日より前までさかのぼれます。
返金。税は注文と同じ割合で差し引きます。
Shopify Subscriptions とそれを基盤にしたアプリのサブスクリプション契約。MRR に使います。販売プランが作成した注文は継続課金として集計します。

Shopify は解約日も解約理由も提供しないため、解約された契約は最後に変更された時点で終了したとみなします。

支払い済みの注文をストアの通貨で税抜きで計上し、Shopify Paymentsの手数料を手数料とします。テスト注文は除外されます。
返金は税込みのため、RevGlanceが注文と同じ割合で税を差し引きます。
MRRはサブスクリプション契約（Shopify Subscriptionsおよびそれを基盤とするアプリ）から、割引適用後の額で取得します。販売プランによって作成された注文は定期として計上します。
Shopifyは解約日や理由を提供しません：解約、期限切れ、失敗、一時停止中の契約は、最後に変更された日に終了します。
一部支払い済みの注文は、これまでに入金された額を計上します。
価格が税込みの場合、MRRは最初の注文の税の割合で、税引き前で計上します。
サブスクリプション契約にはトライアルの日付がないため、トライアルは表示されません。
チャージバックは読み込まないため、敗訴したものは、プロバイダーが返金としても報告しない限り請求として計上されたままになります。
失敗した請求は報告されないため、その数値は0のままです。