暗号資産を送ったのに注文が未払いのままになる理由
取引、ネットワークとトークン、実際に使った支払い試行の情報、金額、インボイスの状態を確認します。すでに paid なら、注文の紐付けと webhook 処理の不具合を調べます。
更新日:
利用者が暗号資産を送ったのに注文が未払いのままであれば、どの段階で問題が起きたかを調べます。送信、ネットワークの承認、インボイスとの照合、サイト側の注文処理を切り分けてください。最初の送金がどうなったか確認するまでは、再度の支払いを求めないでください。
本ガイドは、Cryptanio のインボイスで支払いを受け付ける販売者向けです。プロジェクトへのアクセスと注文データが必要です。ハンドラーの設定は、webhook による注文確認ガイドで説明しています。
一つの支払いに関する情報を集める
注文番号、インボイス番号、トランザクション ID、ネットワーク、資産、送信額、受取先、時刻を記録します。利用者が支払い方法を変更していた場合は、実際に使った支払い試行の情報を保存してください。トランザクション ID のないスクリーンショットだけでは、照合に不十分です。
金額だけで入金を注文に紐付けないでください。価格や利用者が同じこともあり、一つのインボイスに複数の支払い試行がある場合もあります。
手順 1. 送信が実行されたか確認する
選んだネットワークのブロックエクスプローラーで、トランザクション ID から取引を開きます。実行結果と受取先を確認してください。取引所に出金を申請しただけでは、送金の完了を意味しません。
ブロックへの取り込み待ちや取引エラーは、支払いの証明になりません。取引が見つかった場合も承認を確認してください。必要な時間はネットワークとその状況によって変わります。詳しくは「トランザクションの承認とは」をご覧ください。
手順 2. ネットワーク、トークン、すべての支払い情報を照合する
実際に使った支払い試行のネットワーク、資産、アドレス、追加情報を照合します。二つのアプリに同じ USDT という名前が表示されても、ネットワークやトークンが同じ証拠にはなりません。偽物や似た名前のトークンでは、指定された資産の請求を支払えません。
destination tag、memo、コメントが必要だった場合は、それらも確認します。Solana Pay の reference は、支払いリクエストの独立した要素であり、任意の memo テキストではありません。アドレスが一致するだけでは、入金の照合に足りない場合があります。
これらの値が分かりにくければ、「ネットワークとトークンの違い」をお読みください。管理画面のフィルターを変更しても、すでに別のネットワークで実行された送金は変わりません。
手順 3. 正しい支払い試行を探す
「支払い」で、対象のプロジェクトとインボイスを開きます。「支払いの試行」を展開し、該当する試行の「送金履歴」を開いてください。履歴が複数ページある場合は、それぞれ確認します。最初の画面に、すべての記録が表示されるとは限りません。
資産の変更や支払い情報の再取得によって、同じインボイスに新しい試行が作成される場合があります。送金は、実際に使った試行と照合してください。現在のアドレスは、以前に案内されたものと異なることがあります。支払い情報が似ていても、別の注文の入金として扱うことはできません。
送金がチェーン上にあるのに「イベント」に表示されない場合は、選択中のプロジェクト、ネットワーク、資産、イベントのモードを確認します。実際の支払いを、テスト記録やシミュレーションで確認済みにしてはいけません。
手順 4. インボイスの状態を読む
個別の取引の状態だけでなく、インボイス全体の状態を確認します。
pendingとseen：注文を履行できる状態まで支払いが完了していません。partial：金額の一部だけが承認され、追加の支払いを待っています。underpaid：許容される金額より入金が少なく、判断が必要です。overpaid：プロジェクトのルールにより、過払いが審査対象になっています。expired、late、canceled：それぞれ、期限切れ、支払いの確認判断が必要、インボイスのキャンセルを意味します。paid：インボイスは支払い済みとして記録されています。続いて、注文の履行を確認する必要があります。
プロジェクトのポリシーで認められていれば、過払いでも paid になります。料金を上回る金額だけで状態が決まるわけではありません。詳しくは「インボイスとは」をご覧ください。
手順 5. 金額と期限を確認する
実際の受取額を、支払い試行の正確な金額と比較します。送信者側の手数料によって入金額が減っている場合があります。チャットで丸めて伝えた価格は、支払いページの値の代わりにはなりません。
一部入金については、残額を待つ場合と、手動判断が必要な場合があります。「差額を支払ってください」と案内する前に、現在のプロジェクトのルールを確認してください。期限後の送金を、どれか新しい注文の支払いとして自動で扱うこともできません。試行の履歴、期限、記録された入金時刻を照合します。
問題のある支払いを手動で受け入れるか拒否できる場合は、先に利用者と対応を合意してください。インボイスの状態を変えても、ご自身のウォレットから返金の送金が実行されるわけではありません。
手順 6. すでに paid ならサイトを確認する
アプリ内の注文状態を更新します。インボイスとの紐付けと webhook の配信ログを確認してください。配信エラー、紐付けの誤り、ハンドラーの不具合によって、注文が確定しない場合があります。
再処理では最新の状態を照合し、商品を二重に提供しないようにします。承認後に取引がロールバックされた場合は、最新イベントを確認し、注文を履行すべきか改めて判断してください。
サポートに連絡するタイミング
原因が分からない場合は、インボイス番号、トランザクション ID、ネットワーク、資産、金額、時刻、状態、実施した確認内容をサポートに伝えてください。パスワード、API キー、シードフレーズ、webhook の署名シークレットは必要ありません。