暗号通貨決済API統合:あなたのチームが実際に構築する必要があるもの
プレローンチガイドとステップバイステップのビデオ解説

暗号通貨の支払いがカードの支払いと異なる点
あなたのチームが以前にカード決済を統合したことがある場合、いくつかの習慣は引き継がれません。カードの場合、商人が顧客に請求します。暗号通貨の場合、顧客は自分のウォレットから資金を送信し、あなたのシステムは実際に到着したものに反応する必要があります。それにより、統合が処理しなければならない内容が変わります。
金額は請求書と異なる場合があります。 顧客は、ネットワーク手数料や為替レートの違いのために、要求された金額よりも少し少ないまたは多い金額を送信することがあります。事前に、過小支払いと過剰支払いを受け入れるかどうかを決定してください。
例えば、小さな差異を受け入れたり、顧客に連絡したり、返金を発行したりできます。何を決定しても、それを販売条件に明記し、返金ルールと返金時のネットワーク手数料を誰が支払うかを記載してください。
ネットワークが重要です。 同じトークンが複数のブロックチェーンに存在します。間違ったネットワークまたは間違ったアドレスに送信された資金は失われる可能性があります。
見積もりは期限切れになります。 請求書のレートは、同じ通貨で決済する場合は60分間有効で、変換が必要な場合は15分間有効です。遅れて支払う顧客は、新しい支払いリクエストが必要になる場合があります。
確認には時間がかかります。 資金はブロックチェーンが支払いを確認した後にのみ入金されるため、あなたのインターフェースと注文ロジックは待機を処理する必要があります。
チャージバックはなく、自動的な取り消しもありません。 確認されたオンチェーン取引はキャンセルできません。返金は、あなた自身のポリシーおよび適用される消費者保護規則に基づく別の支払いです。
決済はビジネス上の決定です。 資金は支払いが完了するとあなたのVolet.comアカウントに入金されます。受け取った暗号通貨を保持するか、安定コインまたは法定通貨に自動変換することができるため、財務は1つの通貨で調整し、ボラティリティを回避できます。
詳細: Volet.comのビジネスアカウント手数料
Volet.comが担当すること
ネットワーク確認を代行します。 Volet.comはブロックチェーンを監視し、必要な確認を待って資金を入金しますので、バックエンドでブロックや確認数を追跡する必要はありません。
ネットワーク間での安定したコイン残高。 あるネットワークで受け取った安定コインは、別のサポートされているネットワークを通じて引き出すことができ、別途クロスチェーンブリッジサービスは必要ありません。
ロールオーバーリザーブなし。 Volet.comは、完了した支払いの一部をロールオーバーリザーブとして保持しません。
不足払いと過剰払いのルール。 ゲートウェイの設定で、請求額を下回るか上回る支払いを受け入れるかを決定します。たとえば、顧客があなたのところで残高を補充する場合、実際に到着した金額を正確に入金し、不足払いを受け入れることができます。過剰払いの場合は、注文金額のみがあなたのアカウントに入金されます。
遅延支払いの処理。 請求書の有効期限が切れた後に支払いが到着した場合、Volet.comはそれを顧客に返却するか、場合によってはあなたのアカウントに入金します。
入金と出金。 同じVolet.comの残高が、契約者、クリエイター、パートナーへの大量支払い、または自社ユーザーの引き出しを資金提供できます。たとえば、取引所はユーザーの暗号預金を受け入れ、同じVolet.comの残高から暗号引き出しをAPIを通じて処理できます。
Volet.com がグローバル決済の構築を支えます
法定通貨、暗号資産、ステーブルコインに対応。API、Hosted Checkout、導入かんたんなプラグインから選べます。受取、送金、資金管理をすべてコードで。
APIまたはホステッドチェックアウト:実用的な比較
重要な決定は、あなたの製品がどれだけの支払い体験を所有する必要があるか、そしてそれにどれだけのエンジニアリング労力を投資する準備があるかです。
独自の支払いUIと完全な支払いファネルの制御が必要な場合はAPIのみを選択してください。 あなたのアプリケーションは、支払い指示の表示から、支払いが確認されるまでまたは期限切れになるまで顧客に情報を提供するまで、すべての顧客向けステップを所有します。あなたのチームがそれをすべて構築し、維持します。
Volet.comのガイド: API統合
カスタム決済UIとすべてのステップに対する完全な制御が必要ない場合は、Hosted Checkoutを選択してください。 Volet.comが決済ページをホストし、一般的にこれがより簡単で労力の少ない道となります。また、決済ページはTelegramボットやミニアプリ内でも機能し、アプリ内ブラウザウィンドウ(ウェブビュー)で開きます。

Volet.comのホステッドチェックアウトはこのようになります
詳細を読む: テレグラムミニアプリにおける暗号通貨決済 — セットアップガイド、スターズルール & 実際の手数料
ホステッドチェックアウトとAPIを組み合わせて、注文の照会と調整を行うこともできます。いずれにせよ、ホステッドチェックアウトにはバックエンドの作業が必要です。あなたのアプリケーションは独自の注文記録を保持し、それをVolet.com側の支払い状況と照合します。あなたのバックエンドは、ホステッドチェックアウトに送信するリクエストに署名し、顧客の支払いをあなたのストアから逸脱させる可能性のある改ざんされたリクエストから保護します。
| 決定要因 | API専用 | ホステッドチェックアウト |
|---|
| 顧客向けの支払いUI | あなたのチームによって構築および維持される | Volet.comによってホストされる |
| 支払いファネルの制御 | 高: あなたのアプリケーションが体験を所有する | より制限された: 顧客はホストされたフローに従う |
| エンジニアリングの労力 | 高い: UI、ステータスチェック、期限切れおよびエッジケース | 支払いUIに対しては低い; バックエンドは依然として支払いリクエストに署名し、通知を処理し、注文を更新します |
| 最適な適合 | ウェブサイトまたはアプリ、ボット、プラットフォームでのカスタムチェックアウト | ホストされたページへのリダイレクトが許容される標準的な支払いフロー、テレグラムボットやミニアプリを含む |
| ステータス処理 | バックエンドはAPIを通じて支払い状況をチェックします | ステータスURL通知と必要に応じた調整のためのAPI照会 |
| Volet.comアカウント残高からの支払い | 利用不可: API専用は外部ウォレットからの暗号通貨を受け入れます | 利用可能: 顧客はVolet.comアカウント残高から支払うことができ、手数料は0.25% |
Volet.comのガイド: ホステッドチェックアウトの統合
Volet.com がグローバル決済の構築を支えます
法定通貨、暗号資産、ステーブルコインに対応。API、Hosted Checkout、導入かんたんなプラグインから選べます。受取、送金、資金管理をすべてコードで。
チームが実際に構築する必要があるもの
請求書エンドポイントはAPI専用実装の一部に過ぎません。これにコミットする前に、以下の製品および運用責任を考慮してください。
API専用でのフローの動作:
- 自分のシステムで注文を作成します。
- APIを通じて暗号請求書を作成します。
- 顧客にAPIから返されたアドレス、金額、通貨、ネットワーク、期限を表示します。
- 顧客は自分のウォレットから支払いを送信します。
- バックエンドがAPIを通じて支払い状況を確認します。
- 支払いが確認されたら、注文を支払い済みとしてマークし、履行します。
Hosted CheckoutとAPIでのフローの動作:
- システムで注文を作成し、顧客をHosted Checkoutにリダイレクトします。orderIdを使用します。
- 顧客はHosted Checkoutページで支払いを行います。
- Volet.comがあなたのステータスURLに通知を送信します。これは、支払い更新を受信するサーバー上のエンドポイントです。
- バックエンドが署名を確認し、必要に応じてAPIを通じて注文を確認します。
- 注文を支払い済みとしてマークし、履行します。
支払いUIと請求書ライフサイクル。 アプリケーションはAPIから返された支払い詳細を正確に表示する必要があります: 送信する金額、通貨、ブロックチェーンネットワーク、アドレス、任意の宛先タグまたはメモ、および期限。指定されたネットワークを通じてのみ資金を送信するよう顧客に警告する必要があります。不正確な支払い指示は資金の損失を引き起こす可能性があるため、これは視覚的な詳細ではなく機能要件です。
支払い状況が確認される前に、顧客に支払いが失敗したまたは完了したと伝えないでください。
バックエンドの注文と支払いモデル。 内部の注文を支払い試行または請求書から分離しておきます。これにより、放棄されたチェックアウト、期限切れの請求書、再試行する顧客、およびユーザーがページを離れた後に到着するステータス更新を処理しやすくなります。
各支払い試行に対してユニークなorderIdを使用してください。APIドキュメントに記載されているように、各試行が注文にどのようにマッピングされるかを独自のデータベースで定義します。各注文に対してVolet.comの取引ID、受け取った金額、決済通貨を保存し、財務部門が手動のスプレッドシートなしで各支払いを請求書に照合できるようにします。暗号受領の税務処理はあなたの管轄に依存するため、会計士と合意してください。
請求書金額モデルを選択します。 注文が受け取ることを期待する通貨で価格設定されるか、顧客が特定の暗号通貨の固定金額を送信するべきかを決定します。この選択は価格表示、調整、および支払うべき金額の説明に影響します。価格設定および会計モデルと整合させ、実際の請求書を作成する前に計算された値を検証します。APIドキュメントは各オプションの設定方法を説明しています。
Volet.comのガイド: API統合
顧客が€120の注文を行い、暗号通貨で支払ったとします。バックエンドは、完了した支払いを元の注文に一致させるために十分な情報を保持する必要があります。この支払いについては、以下の情報を保存します:
- あなたの注文ID (ORD-10482) は、システム内の購入を特定します。
- Volet.comの取引ID (VLT-839201) は、支払いをVolet.com側の取引にリンクします。
- 受け取った金額 (約139 USDT) は、顧客が実際に送信した金額を示します。
- 決済通貨 (EUR) は、財務チームが会計に使用する通貨を記録します。
- 支払いステータス (最終、APIによって確認済み) は、支払いが完了として扱えるかどうかを示します。
照合するには、Volet.comの取引を支払い試行と注文に一致させ、次に取引ID、期待される金額と受け取った金額、通貨、最終支払いステータスを比較します。支払いが欠落している、遅れている、または期待される金額と一致しない場合は、自動的に注文を支払い済みとしてマークするのではなく、調査のためにフラグを立てます。
顧客は注文を作成し、支払いページを開いて必要な暗号通貨を送信します。ブロックチェーンが取引を確認する前に、ブラウザタブを閉じてウェブサイトを離れます。
あなたのバックエンドは支払いを追跡し続けます:
- 顧客の注文はあなたのシステムで保留中のままです。
- 支払いの試みは独立して続行されます。APIのみの場合、あなたのバックエンドはAPIを通じてそのステータスを確認します。ホステッドチェックアウトの場合、Volet.comはあなたのステータスURLに通知を送信します。
- あなたのバックエンドはAPIを通じて支払いステータスを確認します。
- 支払いが完了として確認されると、あなたのシステムは注文を支払い済みとしてマークし、履行をトリガーします。
- 顧客があなたのウェブサイトに戻ると、更新された注文ステータスが表示されます。
重要な点:チェックアウトページを閉じることは支払いをキャンセルしたり確認したりすることはありません。注文が履行されるタイミングを決定するのはブラウザのリダイレクトではなく、あなたのバックエンドです。
ステータス処理と回復。 APIのみの場合、チームはポーリング戦略(バックエンドがステータスをチェックする頻度)を選択し、不必要なリクエストを避け、一時的な検索失敗を処理して、注文状態を誤って変更しないようにする必要があります。
通知を信号として扱い、支払いの証拠として扱わないでください:その署名を確認し、履行する前にAPIを通じて注文を検索してください。各注文は一度だけ処理し、自分のorderIdでキー付けするので、繰り返しの通知や二回目のステータスチェックで二重に履行されることはありません。
APIが支払いが完了したことを確認した後のみ、注文を履行してください。請求書の作成が成功したときやブラウザがリダイレクトしたときではありません。正確なステータス値とそれぞれの処理方法はAPIドキュメントに記載されています。
Volet.comのガイド:API統合
リモートシステムが処理を行っている場合でも、リクエストがタイムアウトすることがあります。あいまいな失敗の後に請求書の作成を盲目的に再試行しないでください。次に何をすべきか決定する前に、APIのerrorIdを記録し、既存の注文と支払いの状態を確認し、文書化されたエラー処理に従ってください。自動的に重複注文を作成することは決してせず、安全な場合にのみリクエストを再試行してください。
セキュリティと運用準備。 APIの秘密と認証情報はサーバーに保管してください。フロントエンドコード、モバイルアプリ、ボット、またはクライアント側のスクリプトにそれらを公開しないでください。統合に必要な権限のみを構成し、APIアクセスをサーバーのIPアドレスに制限してください:すべてのIPを許可することは本番環境では推奨されません。
信頼できる支払いフローの設計
支払いフローは、成功したケース以上のものを処理する必要があります。
製品が何をすべきかを決定してください:
- 請求書の作成がタイムアウトし、結果が不明な場合;
- ステータスの検索が一時的に失敗した場合;
- 顧客が支払う前に請求書が期限切れになった場合;
- 顧客がチェックアウトを放棄し、後で戻ってきた場合;
- 顧客が別の支払い試行を開始した場合;
- ステータス通知が遅延したり、複数回受信された場合。
目標は、重複履行を避け、内部の注文状態を一貫性を保ち、顧客に明確な次のステップを提供することです。
Volet.comのガイド:正確なステータス定義と応答フィールドを持つAPIガイド
サンドボックスなしでのテスト
Volet.comにはサンドボックスやテスト環境がありません。これを早めに計画し、ローンチ時に発見しないようにしてください:
- Volet.comの営業チームにライブデモをリクエストして、構築する前に支払いフロー、API、ホステッドチェックアウトを確認してください。
- ゲートウェイを早めに作成してください。新しいカストディアルゲートウェイ(Volet.comが受け取った資金をあなたのアカウントに保持するもの)は、通常数時間かかるコンプライアンスレビューを経て、統合をその間に完了できます。
- 実際の支払いで本番環境でテストしてください:成功、失敗、期限切れ、過少支払い、過剰支払い。各暗号テスト支払いは、ネットワーク手数料を伴う実際のオンチェーン取引です。
- ホステッドチェックアウトの場合、ステータスURLの配信、署名の検証、成功と失敗のリダイレクトも確認してください。
- テスト注文をデータベースにマークして、調整中に実際の収益と混ざらないようにしてください。
現実的な作業の見積もり
実際の労力は、既存のチェックアウトアーキテクチャ、必要なユーザーエクスペリエンス、エンジニアの支払いAPIに関する経験、テスト(QA)の範囲に依存します。
| 作業ストリーム | APIのみ | ホステッドチェックアウト |
|---|
| アカウントとゲートウェイの設定 | アカウントの確認、APIの設定、権限と承認 | アカウントの確認、ホステッドチェックアウトの設定と必要な承認 |
| コア実装 | 請求書の作成、支払いUI、ステータスチェックと注文の更新 | リダイレクトフロー、ステータスURLの処理とバックエンドの注文更新 |
| エッジケース | 期限切れ、あいまいなタイムアウト、再試行、重複試行およびネットワーク指示 | 通知の検証、リダイレクトのエッジケースおよび調整 |
| QA | 支払い詳細の表示、ステータスチェック、期限、失敗および回復 | リダイレクト、通知の配信、署名の検証および調整 |
| 継続的な所有権 | UIメンテナンス、監視、サポート診断およびステータス処理 | バックエンドの監視、注文の調整およびコールバック操作 |
成功パスと失敗パスを別々に見積もり、エンドツーエンドのテストおよび本番監視のための時間を含めます。
Volet.comの料金
ステーブルコインおよび暗号通貨の支払いは0.25%からです。USD、USDT、USDC間の変換は固定の1:1レートで行われ、その他の変換は別途料金が設定されます。顧客がブロックチェーンネットワーク手数料を支払います。設定費用や月額費用はありません。処理手数料を誰が支払うかは選択できます。大量の取引には、営業を通じてカスタム価格が適用される場合があります。
USDT、USDC、主要な暗号資産を世界中で受け取る
暗号資産決済ゲートウェイから始めましょう。着金は即時、手数料は 0.25% から。
よくある質問
いいえ。Volet.comにはテスト環境がありません。営業チームからライブデモをリクエストできます。ローンチ前に成功、失敗、期限切れ、不足支払い、過剰支払いをテストしてください。
新しい保管型ゲートウェイは、最初にコンプライアンスレビューを受けます。通常、数時間かかります。ゲートウェイを作成する前にアカウントを確認する必要があります。待機時間を利用して統合を完了してください。
いいえ。APIのみの場合、バックエンドが支払い状況を自分で確認します。通知が必要な場合は、APIと一緒にHosted Checkoutを使用してください。
ゲートウェイの設定により、不足支払いと過剰支払いが受け入れられるかどうかが決まります。請求書の期限が切れた後に支払いが到着した場合、Volet.comはそれを顧客に返金するか、場合によってはあなたのアカウントにクレジットします。まだ支払いを希望する顧客は、新しい支払いリクエストが必要になる場合があります。
返信する前に、APIを通じてorderIdで注文を確認してください。
転送はオンチェーンで表示されることがありますが、請求書と一致しない場合があります:不足、遅延、または別のネットワークを通じて送信された可能性があります。
サポートチームに支払いの詳細へのアクセスを提供し、彼らがVolet.comサポートにケースをエスカレーションする際の合意を事前に取り決めてください。
いいえ。確認されたオンチェーントランザクションはキャンセルできず、カードネットワークのチャージバックはありません。返金は、あなた自身のポリシーおよび適用される消費者保護規則に基づく別の支払いです。
いいえ。Volet.comはカード取得を提供していません。直接カード支払いのためにカード取得業者を保持してください。