> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# SellAuth 決済自動化

> NowPayments、Heleket、Cryptomus を使って、約 5 分で SellAuth ショップでより多くの暗号通貨を受け付けましょう。

SellAuth ショップで、より多くの暗号通貨決済を受け付けたいですか？ 約 **5 分**でご自身でセットアップできます。サーバーもコードも不要です。短いフォームを 1 つ入力するだけで、チェックアウトの運用とオンライン維持は私が行います。

* SellAuth ショップ用の**暗号通貨チェックアウトページ**
* **Heleket、Cryptomus、NowPayments** から好きなものを選択
* **一度に 1 つのプロセッサー**。いつでも別のものに切り替えられます。
* ステータスと**ライブログ**を表示するシンプルなダッシュボード

![稼働中のプロセッサー、ライセンスの詳細、支払い URL と webhook URL を表示するライセンスページ](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-09-live.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=777b90af5fca72a76d66882aeffa185c)

チェックアウトが稼働中：稼働状態と 2 つの URL

## 3 ステップで完了

**1. ライセンスを入手する**

ライセンスを購入します。`ECHO-XXXX-XXXX-XXXX-XXXX` のようなキーが届きます。

**2. アカウントを作成してプロセッサーを接続する**

キーで登録し、プロセッサーを選んでフォームを 1 つ入力します。

**3. URL を 2 つ貼り付ける。完了。**

支払い URL を SellAuth に、webhook URL をプロセッサーにコピーします。これでショップが暗号通貨を受け付けるようになります。

> [!TIP]
>
> ジャンプ：[アカウントを作成](#1-create-account)、[プロセッサーを接続](#2-connect-processor)、[2 つの URL](#3-your-two-urls)、[プロセッサーを切り替える](#4-switch-processor)、[別のライセンスを追加](#5-add-license)、[更新](#6-renewals)、[FAQ](#faq)。

## 必要なもの

> [!NOTE]
>
> **次のものをご用意ください：**
>
> * 購入時に得た**ライセンスキー**
> * **SellAuth のショップ ID** と **SellAuth API キー**
> * **Heleket、Cryptomus、NowPayments** いずれかのアカウントと、その API 認証情報

> [!NOTE]
>
> スクリーンショットには架空のサンプルデータを使っています（ショップ ID `12345`、`test-api-key-xxxx` のようなキー）。ご自身の値を使い、絶対に共有しないでください。

## 1. アカウントを作成する

**1. 登録ページを開く**

ダッシュボードの登録ページを開きます。すでに登録済みですか？ その場合は **Sign in** をクリックしてください。

**2. フォームを入力する**

ユーザー名を選び、メールアドレスを追加し、10 文字以上のパスワードを設定します。下部にライセンスキーを貼り付け、**Create account** をクリックします。

![ユーザー名、メール、パスワード、プレースホルダーのライセンスキーがあるアカウント作成フォーム](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-02-register.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=de5d4ca59d962cf12845af6d8fb11f03)

ライセンスキーで登録します（ここに表示されているキーはプレースホルダーです）

**3. ログイン完了**

すぐにサインインされます。ライセンスは有効になり、ここから期間が始まります。

> [!WARNING]
>
> 各キーは**一度だけ**使えます。"This license key is invalid or has already been used" と表示された場合は、キーにタイプミスがないか確認してください。それでも失敗する場合は、サポートに問い合わせてください。キーは他人に見せないでください。

## 2. プロセッサーを接続する

プロセッサーは、暗号通貨の支払いを処理するサービスです。**1 つ**選んでください。後で切り替えられます。

**1. ライセンスを開く**

上部の **Licenses** をクリックし、あなたのライセンスを開いて、**Set up processor** をクリックします。

**2. プロセッサーを選ぶ**

![Heleket、Cryptomus、NowPayments を一覧表示する Choose a processor ページ](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-12-swap-pick.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=37c8d5376e810510e3154b83a831249d)

NowPayments、Heleket、Cryptomus から選択

**3. フォームを入力する**

どのフォームでも、**SellAuth のショップ ID**、**SellAuth API キー**（必要なスコープ：Invoice Read、Update、Process）、そしてプロセッサーの認証情報を求められます。下のタブをご覧ください。

**4. 緑のボタンをクリックする**

セットアップには最大 1 分かかります。完了するまでページを開いたままにしてください。その後、ステータスと 2 つの URL が表示されます。

> [tab] NowPayments
>
> **NowPayments API キー**と **NowPayments IPN secret** が必要です。
>
> ![ショップ ID、SellAuth API キー、NowPayments API キー、IPN secret がある NowPayments セットアップフォーム](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-07-form-nowpayments.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=39fed9e70b8671401993c77d8b68de88)
>
> NowPayments のセットアップフォーム

> [tab] Heleket
>
> **Heleket API キー**と **Heleket マーチャント ID** が必要です。
>
> ![ショップ ID、SellAuth API キー、Heleket API キー、マーチャント ID がある Heleket セットアップフォーム](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-05-form-heleket.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=bc33047c3633b689a025a94a80352bad)
>
> Heleket のセットアップフォーム

> [tab] Cryptomus
>
> **Cryptomus API キー**と **Cryptomus マーチャント ID** が必要です。
>
> ![ショップ ID、SellAuth API キー、Cryptomus API キー、マーチャント ID がある Cryptomus セットアップフォーム](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-06-form-cryptomus.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=be948733d2644f3232a5e31bb93118e2)
>
> Cryptomus のセットアップフォーム

> [!NOTE]
>
> API 認証情報は、プロセッサー自身のダッシュボードで確認してください。メニュー名は時期によって異なって見えることがあります。SellAuth のショップ ID は、初回セットアップ後に**ライセンスに固定**されるため、実際に販売したいショップを使ってください。

> [!WARNING]
>
> \*\*よくあるミス：\*\*SellAuth API キーやショップ ID のタイプミス、API キーとマーチャント ID（または IPN secret）の取り違え、キーの先頭や末尾にコピーされたスペース。セットアップに失敗すると赤いメッセージが表示され、フォームには入力した内容が残ります。秘密鍵をもう一度入力してください。
>
> ![SellAuth のショップキーに関する赤いエラーメッセージが表示されたセットアップフォーム](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-08-setup-error.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=4651d603206104f9347e9b7a7cad394d)
>
> エラー例：SellAuth キーが誤っていた

## 3. 2 つの URL とテスト決済

これが最後のステップです。ライセンスページに **2 つの URL** が表示されます。それぞれ異なる場所に貼り付けます。

![支払い URL と webhook URL を表示し、それぞれに Copy ボタンがある Your URLs カード](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-10-urls.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=d99a12e3fa909c00b4e3b5d9d9ece4b3)

Copy ボタンを使いましょう

| URL | 役割 | 貼り付ける場所 |
| - | - | - |
| **Pay URL** | 購入者を暗号通貨チェックアウトへ誘導します。 | SellAuth。支払い方法のリダイレクト URL として |
| **Webhook URL** | 支払いが完了したときにプロセッサーが通知し、注文を支払い済みにします。 | プロセッサーのダッシュボード。callback または IPN URL として |

**1. 支払い URL を SellAuth に貼り付ける**

**Pay URL** の横にある **Copy** をクリックします。SellAuth で支払い方法を開き、リダイレクト URL をそれに設定します。ダッシュボードには次のように表示されます：*SellAuth, Payment methods, redirect URL*。

**2. webhook URL をプロセッサーに貼り付ける**

**Webhook URL** の横にある **Copy** をクリックします。プロセッサーのダッシュボードで、callback または IPN URL をそれに設定します。ダッシュボードにはたとえば次のように表示されます：*NowPayments dashboard, callback / IPN URL*。

**3. ステータスを確認する**

ライセンスページのプロセッサーカードに、緑色の **running** バッジが表示されます。

![緑の running バッジと、Swap processor、Start、Stop、Restart ボタンがあるアクティブなプロセッサーカード](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-11-status.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=2e12cc1d83c2ff0ab711fe0c9c175f1f)

稼働中のプロセッサー

**4. 少額のテスト注文を行う**

ご自身の商品を 1 つ、少額で暗号通貨で購入してみます。ライセンスページの **Logs** までスクロールします。支払いリクエストが届くと、新しい行がリアルタイムで表示されます。支払いが確認されると、注文は支払い済みとしてマークされ、納品されます。

> [!NOTE]
>
> SellAuth やプロセッサーのダッシュボードのメニュー名は、ここに書かれているものと少し異なる場合があります。リダイレクト URL と、callback または IPN URL を探してください。

> [!WARNING]
>
> 支払い URL の `{unique_id}` は**書かれたとおりに**残してください。SellAuth が注文ごとに埋め込みます。

何かが引っかかっているようなら、まずライセンスページで **Restart** を試してください。

## 4. プロセッサーを切り替える

ライセンスごとに**一度に 1 つのプロセッサー**を使え、いつでも切り替えられます。たとえば、NowPayments から Heleket への切り替えです。

* \*\*そのまま残るもの：\*\*ライセンス、有効期限、SellAuth のショップ ID とキー。
* **変わるもの：新しいプロセッサーの認証情報を入力し、もう一度貼り付ける新しい URL** を受け取ります。

**1. Swap processor をクリックする**

ライセンスを開き、**Swap processor** をクリックして新しいプロセッサーを選びます。

**2. 新しいフォームを入力する**

フォームには、新しいチェックアウトが稼働すると現在のチェックアウトが停止するという警告が表示されます。新しい認証情報を入力し、チェックボックスをオンにして確認します。

![切り替え警告と確認チェックボックスがある Heleket セットアップフォーム](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-08-swap-heleket-form.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=0b1ba849c6addc55ea760a6675ffc7b2)

NowPayments から Heleket へ切り替え

**3. 新しい URL を貼り付ける**

*Swap complete* と表示されます。SellAuth のリダイレクト URL と、新しいプロセッサーの callback または IPN URL を更新します。

> [!WARNING]
>
> 切り替え後、**古い URL はすぐに使えなくなります**。購入者が無効なリンクに到達しないよう、すぐに SellAuth を更新してください。

> [!TIP]
>
> 安全です。新しいチェックアウトが先に開始され、何かが変わる前に正常に動作する必要があります。切り替えに失敗した場合は、古いチェックアウトが**まだ有効**であるというメッセージが表示されます。何も失われません。問題を修正して、もう一度試してください。

## 5. 別のライセンスを追加する

各ライセンスには**プロセッサー枠が 1 つ**あります。**2 つ目の SellAuth ショップ**や、同時に使う**2 つ目のプロセッサー**用に、別のライセンスを追加します。

**1. Add license をクリックする**

上部メニューの **Add license** を使います。新しいキーを貼り付け、**Add as new license** を選択します。

![プレースホルダーのキーと、新しいライセンスとして追加するか既存のライセンスを延長するかの選択肢がある Add license フォーム](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-13-add-license.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=14b2d3b92a2864aae399a966fdd550e0)

ライセンスを追加（プレースホルダーのキー）

**2. セットアップする**

ダッシュボードには、すべてのライセンスがそれぞれのステータスと有効期限とともに一覧表示されます。新しいライセンスを開き、プロセッサーを接続します。各ライセンスには独自のショップと独自の URL があります。

![ステータスと有効期限とともに 2 つの暗号通貨ライセンスを一覧表示するダッシュボード](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-14-dashboard.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=af3a32d6459ba6339956c335debd28e1)

複数のライセンスがあるダッシュボード

現在、ライセンスは**暗号通貨**決済向けです。スキンやカード決済などの他のカテゴリは **coming soon** と表示され、まだ利用できません。

## 6. 更新と有効期限

ライセンスは **1、3、6、12 か月**から選べます。期間は購入時ではなく、**キーを登録または引き換えた時**から始まります。引き換えるたびに、セットアップとテスト用に **2 日間のボーナス**が付きます。有効期限は、ライセンスページの上部とダッシュボードに表示されます。

ライセンスの期限が切れると：

* チェックアウトが**一時停止**します。更新するまで、購入者は暗号通貨で支払えません。
* \*\*何も削除されません。\*\*設定とログは保持されます。

![expired バッジと、更新キーを引き換えるよう促すメッセージがあるライセンスページ](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-16-expired.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=97ca7e9f755a852e93465194003b0691)

更新を促す表示がある期限切れのライセンス

**1. 更新キーを入手する**

新しいライセンスキーを購入します。

**2. 引き換える**

ライセンスページで **Redeem a renewal key** または **Extend with a new key** をクリックし、キーを貼り付けます。

**3. 完了**

ライセンスが再び有効になり、チェックアウトが再開されます。URL はそのままです。

> [!TIP]
>
> 期限が切れる**前**にも更新できます。新しい期間は現在の終了日に加算されるので、損することはありません。

> [!WARNING]
>
> ライセンスキーはパスワードと同じように扱ってください。公開の場で投稿しないでください。ダッシュボードに表示されるのは末尾の 4 文字だけです。パスワードは **Settings** で変更できます。

## FAQ

> [accordion] ライセンスキーが無効、またはすでに使用済みと表示される
>
> タイプミスや余分なスペースがないか確認してください。各キーは**一度だけ**使えます。すでにそのキーで登録した場合は、サインインしてください。新しいキーであると確信がある場合は、Echo にお問い合わせください。

> [accordion] セットアップで赤いエラーが表示される
>
> 最も多いのは、SellAuth API キー、ショップ ID、プロセッサーの認証情報の誤りです。各項目を確認し、スペースを取り除いて、もう一度試してください。フォームには、失敗した試行の最後のログ行が表示され、原因の手がかりになります。

> [accordion] 購入者が支払ったのに注文が未払いのまま
>
> プロセッサーのダッシュボードにある **webhook URL** を確認してください。ライセンスページのものと完全に一致している必要があります。その後、ライセンスページの **Logs** でエラーを確認してください。

> [accordion] 購入者がチェックアウトでエラーページに到達する
>
> SellAuth の**リダイレクト URL** を確認してください。`{unique_id}` をそのまま残した支払い URL である必要があります。また、ライセンスが有効で、バッジが **running** と表示されていることも確認してください。

> [accordion] プロセッサーを切り替えたらチェックアウトが止まった
>
> 切り替え後は**新しい URL** を貼り付けてください。古い URL は使えなくなります。

> [accordion] 切り替えに失敗した
>
> 古い設定は**保持され、引き続き有効**です。赤いメッセージを読み、認証情報を修正して、もう一度試してください。

> [accordion] サインインできない
>
> パスワードを何度も間違えると、しばらくブロックされます。**約 15 分待って**からもう一度試してください。ユーザー名またはメールアドレスも確認してください。

> [accordion] 後でやり直すよう表示される
>
> 時間あたりのセットアップ、切り替え、認証情報の変更の回数には上限があります。少し待ってからもう一度試してください。

> [accordion] SellAuth ショップを変更したい
>
> ショップは初回セットアップ後にライセンスへ固定されます。サポートに変更を依頼するか、別のショップ用に別のライセンスを使ってください。

> [accordion] パスワードを忘れた
>
> メールは送信されません。サポートにパスワードのリセットを依頼してください。後から **Settings** でパスワードを変更できます。

> [accordion] ライセンスが期限切れになった
>
> チェックアウトは一時停止されていますが、何も失われていません。更新キーを引き換えてください。[更新と有効期限](#6-renewals)をご覧ください。

まだ解決しませんか？ 私の[サポートサーバー](https://discord.echoauth.dev)でチケットを開いてください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.