コンテンツへスキップ
ArionPay

PHPライブラリ

PHPアプリで暗号資産決済を受け付け

どのPHPサイトからでも暗号資産の請求書を作成し、顧客を支払いページに誘導して、支払い時に署名付きWebhookを検証します。資金はご自身のウォレットに直接届きます。

インストール

composer require arionpay/arionpay-php
GitHubのソースコード
例

機能

PHP開発者向けArionPay

arionpay/arionpay-phpは、PHP 7.4以降向けのArionPay公式クライアントです。依存関係はなく、cURLがインストールされていればcURLを、なければPHPのストリームを使います。
続きを読むComposerでインストールすることも、フォルダをアップロードしてautoload.phpをrequireすることもできるため、共有ホスティングにも適しています。ArionPayが資金を預かることはありません。各支払いはご自身のウォレットに直接届きます。
  • PHP 7.4以降。依存関係なし。
  • cURLがインストールされていればcURLを、なければPHPのストリームを使用。リダイレクトをたどることはありません。
  • Composerでも、Composerなしでも動作:フォルダをコピーしてautoload.phpをrequireします。
  • 同じidempotencyKeyは常に同じ請求書を返すため、ページを再読み込みしても2件目は作成されません。独自のキーがない場合は、ランダムなキーが再試行を保護します。
  • 請求書の各リクエストに、HMAC-SHA256とAPIシークレットで署名します。シークレット自体が送信されることはありません。
  • Webhook::fromGlobalsは生のボディとArionPay-Signatureヘッダーを読み取り、署名が誤っている場合や5分以上前のものである場合はSignatureExceptionをスローします。
  • simulatePaymentとsendTestWebhookを使えば、実際のお金を使わずに全体の流れを試せます。

動作要件とライセンス

対応環境
PHP 7.4以降 · Composerあり・なしの両方、共有ホスティングにも対応 · cURLまたはPHPのストリーム
費用
ライブラリは無料です。ArionPayの手数料は1回の支払いにつき0.5%で、月額料金はかかりません。
ソースコード
GitHubでオープンソース(MIT)として公開。

セットアップ

5つのステップで設定

  1. ステップ1

    ライブラリをインストール

    composer require arionpay/arionpay-php を実行します。Composerを使わない場合は、サイトの隣にフォルダをアップロードし、require __DIR__ . '/arionpay-php/autoload.php' と記述します。

  2. ステップ2

    キーをコピー

    ArionPayダッシュボードでストアを開き、APIキー(pk_)とAPIシークレット(sk_。認証アプリのコードが求められます)をコピーします。Webhook署名シークレット(whsec_)は「Webhooks」ページにあります。環境変数か、Webルートの外にある設定ファイルに保管してください。

  3. ステップ3

    請求書を作成

    金額、通貨、orderId、idempotencyKeyを指定してcreateInvoiceを呼び出し、顧客を$invoice['invoiceUrl']にリダイレクトします。

  4. ステップ4

    Webhookを検証

    「Webhooks」ページで、ポート443または8443の公開https://アドレスを設定するか、請求書ごとにcallbackUrlで指定します。そのスクリプトでWebhook::fromGlobals($secret)を呼び出し、invoice.paidで注文の商品を提供します。

  5. ステップ5

    実際のお金を使わずにテスト

    'test' => trueとUSDT_TRC20などのassetを指定して請求書を作成し、simulatePayment($invoice['id'], 'exact')を呼び出します。本物の支払いと同じように、Webhookにinvoice.paidが届きます。

設定の後

支払いがコードに届くまで

  • invoice.pending:ネットワーク上で支払いが検知され、承認を待っています。まだ商品を提供しないでください。
  • invoice.paid: fully paid and confirmed, or accepted by you by hand in the dashboard. Deliver only on this event (or when getInvoice() says paid). Coming back to successUrl does not prove payment.
  • 商品を提供する前に、請求書を注文と照合してください。orderIdまたはmetadataが一致し、金額と通貨が注文の現在の合計と同じであることを確認します。
  • invoice.partial、invoice.expired、invoice.needs_reviewは、どれも商品を提供してよいという意味ではありません。期限切れの請求書でも、遅れた支払いによって支払い済みになることがあります。
  • サーバーが2xxで応答しない場合、ArionPayは約3日間再送します。各イベントIDは1回だけ処理してください。

9つのネットワークで16種類のコインとトークン

すべてのコイン
  • BTCBitcoin
  • ETHEthereum
  • USDTEthereum
  • USDCEthereum
  • BNBBNB Smart Chain
  • USDTBNB Smart Chain
  • USDCBNB Smart Chain
  • POLPolygon
  • USDTPolygon
  • USDCPolygon
  • TRXTRON
  • USDTTRON
  • LTCLitecoin
  • DOGEDogecoin
  • BCHBitcoin Cash
  • DASHDash

ArionPay PHPライブラリに関するよくある質問

コードに組み込む前に知っておきたいことを簡潔にお答えします。

はい。サイトの隣にarionpay-phpフォルダをアップロードし、そのautoload.phpをrequireします。共有ホスティングでも使えます。

開発者向けライブラリ