Moove API
呼び出しは1回. 受け取りは全額.
コードから支払いリンクを作成。顧客はどのトークンでも支払え、あなたは自分のトークンで全額を受け取れます。
キー発行から最初の入金まで.
API キーを作成
Moove Business で Moove Receive Agent 用のキーを作成します。キーは一度しか表示されないため、すぐに環境変数へ設定してください。支払いリンクを作成
1回の POST でチェックアウト URL が返ります。顧客はそこで、どのチェーンのどのトークンでも支払えます。支払われたら通知
HTTPS エンドポイントを登録すると、リンクが支払われた瞬間に Moove が署名付きイベントを送信します。
API は小さく、保証は確かに.
どのトークンでも支払い、着金はあなたのトークン
顧客は手持ちの資産で、30以上のブロックチェーンネットワークから支払えます。すべての支払いは、あなたが選んだチェーンとトークンでウォレットに着金します。安心して開発できる API 仕様
パスでバージョン管理し、v1 では追加のみ。OpenAPI スキーマも常に最新で公開。明確な制限、明確なエラー
キーごと・IP ごとの制限、シンプルな 429、安定したコードを持つ統一エラー形式。API の利用自体は無料.
サブスクリプションも呼び出しごとの料金もありません。別のトークンやチェーンで支払う顧客が 0.02% を負担するため、あなたは全額を受け取れます。- API の利用
- 無料
- 同じトークン・同じネットワーク
- 無料
- トークン間・ネットワーク間
- 0.02%
Moove と自社開発の比較.
| Moove と自社開発の比較。 | Moove | 自社開発 |
|---|---|---|
| 対応チェーン | Moove: 1つのエンドポイントで30以上 | 自社開発: チェーンごとに個別の統合 |
| あなたのトークンへの変換 | Moove: すべての支払いに組み込み済み | 自社開発: スワップとブリッジのルーティングを自前で |
| 着金の確認 | Moove: 署名付き Webhook と一覧エンドポイント | 自社開発: チェーンごとに自前で動かすリスナー |
| チェックアウトページ | Moove: ホスト済みのリンクをそのまま共有 | 自社開発: 設計・開発・ホスティングまで自前 |
| キーが漏洩した場合 | Moove: できるのはあなたへの支払いの請求だけ | 自社開発: ホットウォレットの全資産 |
よくある質問.
API キーはどうやって取得できますか？
Moove Business のコンソールにサインインし、「API キー」を開きます。キーに名前を付けて Moove Receive Agent を選ぶと、支払いリンクの作成と読み取りの権限が付与されます。完全なキーは作成時に一度だけ表示され、その後は二度と表示されないため、シークレットマネージャーに保管してください。キーを作成するエンドポイントは存在しないため、あるキーが別のキーを発行することはできません。
顧客が支払ったお金はどこに届きますか？
キー所有者のデフォルトウォレットに、そのウォレットのチェーンと決済トークンで届きます。呼び出し側が別の送金先を指定することはできません。そのため、最初の呼び出しの前に、取得済みの Moove handle と、決済トークンを設定したデフォルトウォレットの両方が必要です。どちらかが欠けていると、リンクの作成時に、アカウントが支払いを受け取る準備ができていないことを示す 409 が返ります。
ペイアウト API はありますか？
まだありません。この API は支払いを受け取るためのもので、送金はできません。現在、仕入先や業務委託先に支払うには、Moove Business コンソールの「送信」を使ってください。Moove Send Agent はすでに発表されており、リリース時にドキュメントに掲載されます。
Moove の Webhook はどのように機能しますか？
コンソールで最大5つの HTTPS エンドポイントを登録できます。各エンドポイントは2種類のイベントを受け取ります。リンクへの支払いが決済されたときと、リンクが完了したときです。配信は一度だけ表示されるシークレットを使って HMAC-SHA256 で署名されます。配信は「少なくとも1回」のため、イベント ID で重複を排除してください。失敗した配信は最大6回まで再試行されます。
レート制限はありますか？
はい。リクエストは API キーごとと送信元 IP ごとに制限され、先に上限に達した方が適用されます。超過すると 429 が返ります。拒否されたリクエストもカウントされるため、すぐに再試行せず、ジッターを加えた指数バックオフを使ってください。支払いステータスは単一のリンクをポーリングせず Webhook で受け取り、複数の連携が同じホストを共有する場合は IP ごとの上限を考慮して計画してください。
API のバージョン管理はどうなっていますか？
パスで管理します。現在の公開バージョンは v1 のみです。バージョン内の変更は、新しいエンドポイント、新しい任意フィールド、新しいレスポンスフィールドなど、追加だけです。フィールドの削除や型の変更など、クライアントを壊しうる変更は、新しいパスバージョンとして公開されます。クライアントは未知のフィールドを無視し、分岐はメッセージではなく必ずエラーコードで行うよう実装してください。
