仕組み
ステップ1
そのコインで請求書を作成
顧客があなたのページでコインを選びます。サーバーがそのコインを指定した署名付きリクエストを1回送信し、正確な金額、アドレス、有効期限を受け取ります。
- 2
ステップ2
ページに表示
あなたのページが、金額、アドレス、QRコード、カウントダウンを独自のデザインで表示します。顧客は任意のウォレットや取引所から支払います。
ステップ3
支払い完了の通知を受け取る
ArionPayが支払いを検知し、承認数をカウントします。サーバーに署名付きのinvoice.paid Webhookが届き、注文を確定します。
リクエスト1回
ページに必要なものはすべてレスポンスに
「asset」に顧客が選んだコインを指定すると、請求書にすぐにアドレスが割り当てられます。amount_cryptoはそのまま正確に表示してください。末尾の桁で、ArionPayは支払いがどの請求書のものかを判別します。
アドレスはご自身のウォレットのメインアドレスなので、資金がArionPayを経由することはありません。リクエストは、ほかのAPIと同じくストアのAPIシークレットで署名します。
{
"amount": "49.00",
"currency": "USD",
"orderId": "ORD-1042",
"asset": "USDT_TRC20"
}{
"status": "success",
"data": {
"id": "6732b1e4f0a9c35d2e18a7c4",
"status": "new",
"asset": "USDT_TRC20",
"address": "TQ4x…your wallet…k9Rm",
"amount_crypto": "49.004173",
"amount_fiat": "49.00",
"currency": "USD",
"expires_at": "2026-11-12T21:30:00.000Z",
"invoice_url": "https://merchant.arionpay.com/pay/…"
}
}あなたのページ、私たちのエンジン
あなたのページに表示するもの
- 独自のデザイン、言語、ドメイン
- 請求書の作成前に行う、独自のコイン選択
- 正確な金額、アドレス、QRコード、カウントダウン
- 顧客が待っている間のステータス
ArionPayが行うこと
- すべてのネットワークでのブロックチェーン監視
- 正確な金額による、各支払いと請求書の照合
- 承認数のカウントと、金額違いのためのPayment Radar
- 署名付きWebhookと、ダッシュボードでのすべての支払いの表示
正しく構築する
ページで必ず行うべき6つのこと
- 1APIはサーバーからのみ呼び出してください。APIシークレットは決して公開しないでください。
- 2金額はすべての桁を表示し、コピーボタンとネットワークも表示してください。
- 3expires_atまでカウントダウンし、ヘルプ用にinvoice_urlへのリンクを設置してください。
- 4注文の確定は、署名付きのinvoice.paid Webhookを受け取ったときだけにしてください。
- 5未払いの請求書の状態の問い合わせは、最大でも10秒に1回にしてください。
- 6まずはテストモードで試してください。テスト請求書に実際のお金が届くことはありません。
ホワイトラベルAPIに関する質問
支払いが自社サイト上で完結する仕組み、費用、今後の予定について。
いいえ。あなたのページに正確な金額、アドレス、QRコードが表示され、顧客は自分のウォレットから支払います。必要に応じて、サポートが必要な顧客向けにArionPayの支払いページへのリンクを追加できます。
いいえ。アドレスはご自身のウォレットのアドレスなので、支払いはあなたに直接届きます。ArionPayはブロックチェーンを監視し、支払いを請求書と照合して、支払いが完了したらサーバーに通知します。
ストアが受け付けるすべてのコインです。コードはGET /api/v1/currenciesに一覧があります(例:USDT_TRC20、USDC_POLYGON、BTC)。請求書は1つのコインに対して作成されるため、まず顧客にコインを選んでもらい、そのコインで請求書を作成してください。
ネットワークが支払いを承認すると、サーバーに署名付きのinvoice.paid Webhookが届きます。顧客が待っている間は、サーバーからGET /api/v1/invoices/:idでステータスと承認数を問い合わせることもできます。
ArionPayの決済ページと同じルールです。正確な金額と、該当する請求書が1件だけの場合の許容範囲内の小さな差は、自動で承認されます。それ以外の金額はPayment Radarが見つけてダッシュボードに表示し、あなたが判断します。
いいえ。ArionPayの決済ページと同じく1回の支払いにつき0.5%で、月額料金はかかりません。
まだできません。ロードマップに入っています。現在、ArionPayの決済ページではストアのロゴとブランドカラーを表示でき、ホワイトラベルAPIを使えば支払いページ全体を自分で構築できます。