よくある質問（Ｑ＆Ａ）

着金トリガーサービスとはどんなサービスですか？

JavaScript（Node.js）を使ったプログラムにより仮想通貨の入金を監視することができます。当サービスは仮想通貨（シンボル/XYM）の入金を監視し、通知があった場合に指定されたURLのプログラムにPOSTリクエストを送信するものです。
※この仕組みはwebhookやイベントトリガーなどと呼ばれています。

このサービスは有料ですか？

当サービスは仮想通貨のアドレスを1個まで無料で登録しご利用いただけます。2個以上の登録を望まれる場合には、次のどちらかの方法で10個まで登録可能となります。

1．当社のSymbolノードに委任ハーベストを実施する。

下記のノードに委任ハーベストを実施後、マイページから委任アドレスの登録にお進みください。⇒ マイページ

コピー

2．会費を支払う。

会費（年額にして1,200円）は、Ripple(XRP)、又は、Symbol(XYM)で支払うことができます。日割り計算していますので、任意の金額をご送金でき、必要な日数だけご利用可能です。ただし、日額に満たない金額は切り捨てになりますことをご了承ください。詳しくは、こちらをご覧ください。⇒ 会費のお支払い
※会費はサーバー維持費などに対する寄付と考えていただければ幸いです。

このサイトの利用の仕方を教えてください？

1．まず、会員登録（無料）が必要です。

2．着金トリガーの管理のページに全ての機能がまとめられています。

仮想通貨のアドレスと着金時に起動するプログラムのURLを登録すると、登録されているアドレスの一覧に表示され、始動/停止、更新、削除の操作ができるようになります。
更新/削除は停止後に利用できます。
赤字のアドレスは不正又は未使用のアドレスですので、更新ボタンで修正してから始動してください。 ON（稼働中）の状態で着金があると、指定したURLのプログラムにPOSTリクエストが送信されます。

3．トリガーログ一覧のページで、トリガー発生時に記録されたログデータを閲覧できます。

4．監視用コードのページには、当サービスで用いているトランザクション監視用のプログラムコードがまとめられています。

5．着金の履歴の取得のページでは、入金履歴のCSVファイルをダウンロードできます。

6．マイページでは、アカウントの更新と削除（退会手続き）ができます。

7．会費のお支払いのページでは、会費を仮想通貨Ripple(XRP)、又は、Symbol(XYM)によってお支払いができます。

このサービスを使うメリットは何ですか？

入金をリアルタイムに知るには通常JavaScript（Node.js）を使ったプログラムが必要となります。そのため、クラウドサービスやVPSを用意しなければならず、ハードルが高くなります。しかし、当サービスを利用することにより、通常のレンタルサーバーにUPされたphpやperlのプログラムを簡単に起動できます。
また、ご自分で入金を監視するプログラムを組めるとしても、継続的に監視するのはそう簡単ではありません。その難しさは実際にやってみると分かります。着金トリガーサービスでは可能な限り確実な監視ができるように努力しています。その点でも当サービスはお役に立てるに違いありません。

このサービスを利用するためにはどんな準備が必要ですか？

着金のタイミングで起動させるプログラムを準備してそのURLを登録する必要があります。これはアイデア次第ですが、例えば次のようなプログラムです。
1．着金があった時、トランザクションを確認してそれに対応した処理をするプログラム。
2．着金と同時に動作させたいプログラム。
3．着金をメールで知らせるプログラム（テストプログラムが用意されています）。
なお、下記のトランザクション解析用のテストプログラム（着金をメールで知らせる）をご利用になれます。

CRONを用いたポーリングとどのように異なりますか？

CRONを1分ごとに動作させてトランザクションを定期的に確認する、いわゆる、ポーリングによっても、ほぼリアルタイムな処理を実現できます。しかし、やはり多少の遅れが生じます。それに対し、着金トリガーサービスは、着金との同時処理を可能にします。
一方、着金トリガーサービスは、失敗した場合、それを再度繰り返し実行することはできません。それに対して、CRONは何度でも繰り返し実行でき、その点でより確実であると言えます。
それで、両方を利用することによりリアルタイム性と確実性を実現できます。 例えば、着金トリガーサービスを利用し、同時にCRONで1分ごとに処理させるなどの利用ができます。この場合、CRONは着金トリガーが動作しなかった場合の保険となります。

トリガーの頻度とは何ですか？

当サービスではトリガーの頻度を計算して、制限を設けています。それはサーバーの負荷を軽減し、正常な動作を保つためです。
トリガーの頻度は、単位時間あたりに何回トリガーが発生したか、つまり、着金があったかを示します。これは直近のデータに基づき、通貨ごとに計算されます。その値はトリガーログ一覧のページで確認できます。
その値が大きい場合、それに関係したアドレスが自動的に停止されます。停止されたアドレスはトリガーの管理のページでオレンジ色のアドレスで示されます。この制限の値に関しては、トリガーログ一覧のページで確認できます。この制限値は変更されることがあります。

POSTリクエストでどんなデータがポストされるのですか？

POSTされるデータは、POSTされるデータのところにまとめられています。例えば、キー「data」はトランザクションデータです。
着金をメールで知らせる下記のトランザクション解析用のテストプログラムでは、取得したトランザクションデータがそのメールに記されていますので、それにより確認することをお勧めいたします。

トリガーログ一覧のHTTPレスポンスについて説明してください。

トリガーログ一覧のHTTPレスポンスは、指定されたURL（プログラム）に対してHTTPリクエストしたときのレスポンスを表しています。それで、表示されるステータスコード（statusCode）を調べるならプログラムの動作などを確認できます。代表的なものを上げておきます。

トリガーが発生しないことがあるのはなぜですか？

ノードの状態やネットワークの状態などによりトリガーが発生しないことがあります。そのようないくつかの場合について取り上げます。
※承認数(0)又は承認数(1)については、こちらをご覧ください。⇒ 承認数について

このサービスを使ったプログラムにはどのようなものがありますか？

当社で開発のショッピングカートではRipple、及びSymbolによる決済ができますが、当サービスを利用することによりリアルタイムな着金の処理が可能となります。ご利用方法はこちらをご覧ください。⇒ 仮想通貨による決済システム