> For the complete documentation index, see [llms.txt](/llms.txt)

# 通貨ショップ

通貨を購入できる商品と価格を扱います。




**このデモについて**

デモは匿名アカウントで自動的にログインします。このアカウントはショールームのすべてのデモで共有されるため、あるデモで手に入れたアイテムや通貨が別のデモにも反映されます。読み込みには少し時間がかかります。画面が小さい場合は新しいタブで開いてお試しください。

## 概要

コインパックを並べた通貨ショップです。**Buy coins** に並ぶ商品の **Buy** を押すと、テスト用レシートで購入が成立し、購入したコインが **Your coins** のウォレットに入ります。商品・価格・付与量は GS2-Showcase の陳列棚として定義され、購入は GS2-Money2 のレシート検証と入金を 1 つのトランザクションで実行します。

## 試し方

1. **Your coins** で、現在の **Free balance**（無償）、**Paid balance**（有償）、**Total balance**（合計）を確認します。
1. **Buy coins** には **10 coins**、**50 coins**、**250 coins** の 3 商品が並びます（デモ通貨 `XXX` でそれぞれ 1、2、3 の価格）。
1. いずれかの商品の **Buy** を押すと、ストアのテスト用レシートで購入が実行され、「Purchased.」と表示されます。
1. **Your coins** の **Paid balance** と **Total balance** が、購入した商品のコイン数だけ増えます。

デモで扱うレシートはプラットフォームのテスト用ストアが返すもので、実際の課金は発生しません。

## 使用している GS2 のサービス

- [GS2-Showcase](/ja/microservices/showcase/): GS2-Showcase の陳列棚が、通貨種別（JPY / USD / XXX）ごとにコインパックとその価格・付与量を定義し、購入を受け付けます。
- [GS2-Money2](/ja/microservices/money2/): 購入時に GS2-Money2 がストアのレシートを検証し（デモではテスト用レシートを受け入れる設定）、有償コインとしてウォレットへ入金します。

## GS2 Studio で使う

GS2 Studio のシンプルモードで **機能を追加** を開き、**通貨ショップ** の **追加** を押すと、この機能を自分のプロジェクトに取り込めます。パッケージを直接指定する場合は **GitHub から追加** を選び、次のパッケージを指定します。

```text
https://github.com/gs2io/gs2-studio-package/tree/main/micro-shop-currency/packages/micro-shop-currency
```

- オーナー: `gs2io`
- リポジトリ: `gs2-studio-package`
- サブディレクトリ: `micro-shop-currency/packages/micro-shop-currency`

## ソースコード

- デモのプロジェクト: <https://github.com/gs2io/gs2-studio-package/tree/main/micro-shop-currency/live-demo>
- 機能パッケージ: <https://github.com/gs2io/gs2-studio-package/tree/main/micro-shop-currency>



