💵

【Shopify.dev和訳】Apps/App billing/One-time charges

2021/11/26に公開

Shopify

apps

tech

この記事について

この記事は、Apps/App billing/One-time chargesの記事を和訳したものです。

記事内で使用する画像は、公式ドキュメント内の画像を引用して使用させていただいております。

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

Shopify アプリである、「らくらく日本語フォント設定｜リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

Billing API を用いた one-time charges の管理

one-time charges を利用して、2 つの異なる課金モデルを実装することができます。

1 回限りの支払い

appPurchaseOneTimeCreateミューテーションを使用してチャージを作成することができます。1 回限りの購入のためのname、price、returnUrlを提供します。currencyCodeはUSDのみとなります。returnUrlは、マーチャントがチャージを受け入れた後にリダイレクトされる場所で、チャージ ID も含まれます。

POST /admin/api/2021-10/graphql.json

mutation {
  appPurchaseOneTimeCreate(
    name: "Email template"
    price: { amount: 100.00, currencyCode: USD }
    returnUrl: "http://super-duper.shopifyapps.com"
  ) {
    userErrors {
      field
      message
    }
    confirmationUrl
    appPurchaseOneTime {
      id
    }
  }
}

レスポンスを見る

JSON response:

{
  "data": {
    "appPurchaseOneTimeCreate": {
      "userErrors": [],
      "confirmationUrl": "https://domain.myshopify.com/admin/charges/406454328/confirm_application_charge?signature=BAh7BzoHaWRpBDgAOhg6EmF1dG9fYWN0aXZhdGVU--59c04b2c6b0f73f10f97ae24af2f248c5831a3e8",
      "appPurchaseOneTime": {
        "id": "gid://shopify/AppPurchaseOneTime/406454328"
      }
    }
  },
  ...
}

従量制

appPurchaseOneTimeCreateミューテーションを使用して、多くのチャージを作成することができます。

POST /admin/api/2021-10/graphql.json

mutation {
  appPurchaseOneTimeCreate(
    name: "100 emails for $1"
    price: { amount: 1.00, currencyCode: USD }
    returnUrl: "http://super-duper.shopifyapps.com"
  ) {
    userErrors {
      field
      message
    }
    confirmationUrl
    appPurchaseOneTime {
      id
    }
  }
}

レスポンスを見る

JSON response:

{
  "data": {
    "appPurchaseOneTimeCreate": {
      "userErrors": [],
      "confirmationUrl": "https://domain.myshopify.com/admin/charges/406454328/confirm_application_charge?signature=BAh7BzoHaWRpBDgAOhg6EmF1dG9fYWN0aXZhdGVU--59c04b2c6b0f73f10f97ae24af2f248c5831a3e8",
      "appPurchaseOneTime": {
        "id": "gid://shopify/AppPurchaseOneTime/406454328"
      }
    }
  },
  ...
}

次のステップ

Shopify アプリのご紹介

Discussion

ログインするとコメントできます