blockwallets への移行
blockwallets には 3 つのゲートウェイ向けの互換 API があります。以下から該当するものを選んでください。表に、変更が必要な点だけをまとめています。
変更する点
| 移行元 | 移行前 | 移行後 | 新しい認証情報 | Webhook 署名 | |
|---|---|---|---|---|---|
| Cryptomus | https://api.cryptomus.com | https://blockwallets.io | merchant + API key | ボディの sign フィールド、md5(base64(…) + API key) | 詳しいガイド → |
| NOWPayments | https://api.nowpayments.io/v1 | https://blockwallets.io/nowpayments/v1 | API key + IPN secret | x-nowpayments-sig(HMAC-SHA512) | 詳しいガイド → |
| Coinbase Commerce | https://api.commerce.coinbase.com | https://blockwallets.io/coinbase/ | API key + webhook shared secret | X-CC-Webhook-Signature(HMAC-SHA256) | 詳しいガイド → |
blockwallets は Cryptomus 互換 APIに加えて、NOWPayments 互換と Coinbase Commerce 互換の API も提供しています。パス、認証ヘッダー、リクエスト / レスポンスのフィールド、ステータス、Webhook 署名は各社の公式ドキュメントに従うため、既存のコードは通常新しいベース URL と新しいキーに変えるだけで動きます。Coinbase Commerce は 2026-03-31 に米国とシンガポール以外の加盟店へのサービスを終了したので、そのまま乗り換えられます。
内部では通常の blockwallets の請求です。受取アドレスはあなたのもの、決済ページは当社のホスト型決済ページで、支払いはオンチェーンで承認され、2つ目のノードでも照合されて初めて有効になります。以下では、3つのステップに続けて、各 API の対応範囲と元のサービスとの違いを説明します。実装していないパラメーターは、黙って無視されることなくエラーを返します。
テストモード
テスト用の認証情報で作成したチャージと決済は各チェーンのテストネットで動き、その Webhook はテスト用の IPN secret / shared secret で署名されます。本番とは完全に分離されており、テスト用のキーから本番の決済は見えません。
そのほか(決済ページ、承認、ネットワークと最低額、返金)はメインのドキュメントのとおりに動作します。