EPay 互換連携(リダイレクト決済)
EPay形式の転送注文入力が必要な場合に、以下の手順を使用してください。
エンドポイント
GET /payments/epay/v1/order/create-transaction/submit.php
POST /payments/epay/v1/order/create-transaction/submit.php商人の資格要件
受信リクエストは、古い環境変数(epay_pid や epay_key など)を使用する方法で検証されません。
現在の状況では、以下のようになります。
- 受信中の
pidを読み取る - そのPIDに対応する、有効な
api_keysの行を見つけてください。 - 該当する行の
secret_keyを使用してsignを検証します - オプションでIPホワイトリストの確認を適用する
必要な入力項目
pidmoneyout_trade_nonotify_urlsign
オプションの共通項目:
return_urlnametypetokennetworkcurrencysign_type
type には次の2つの形式を指定できます。
alipay— 互換性値; トークン/ネットワークは、明示的なtoken+networkリクエストパラメータから、さらに管理者のEPay設定から解決されます。token.networkのようなセレクター(例:usdt.tron)は、そのトークン/ネットワークのペアが現在サポートされている場合にのみ適用されます。有効なセレクターは、token、network、epay.default_token、およびepay.default_networkを上書きします。
その他の非空の type の値は無効なパラメータとして拒否されます。選択された、または互換性のある type は、後の EPay の返金/通知コールバックのために保存されます。
EPay のデフォルト
署名認証が成功した場合、現在のソースが管理者設定を含む内部共有注文ペイロードを作成します。
epay.default_tokenepay.default_currencyepay.default_network
EPay 提交の PHP ファイルの解決手順は:
type=token.networkタイプのセレクターがサポートされます(指定された場合)。- 明示的な要求:
token/networkパラメータ - Admin
epay.default_token/epay.default_network - トークンとネットワークがどちらも空の場合、レジ選択フローのための「ステータス
4」の代替注文を作成します。
通貨は独立しています: currency を指定 → epay.default_currency → cny
成功するための行動
成功した場合、ブラウザは以下のURLにリダイレクトされます:
/pay/checkout-counter/{trade_id}現在のソースでは、この経路はホストされたカシヤSPAの再配置のエントリとして機能しています。チェックアウトページのデータは、以下の方法で提供されます:
/pay/checkout-counter-resp/{trade_id}直接的なトークン/ネットワークの選択
上流の「New API」で決済手段を設定する場合は、対応する token.network セレクターを type に指定し、選択肢を個別に登録します。例えば usdt.tron は TRON の USDT 注文を直接作成します。usdt.binance は当該資産が有効な場合に Binance/BSC の USDT 注文を作成します。
例:上流工程リスト
[
{ "color": "rgba(var(--semi-blue-5), 1)", "name": "GM Pay", "type": "custom1" },
{ "color": "rgba(var(--semi-blue-5), 1)", "name": "GM Pay usdt.binance", "type": "usdt.binance" },
{ "color": "rgba(var(--semi-blue-5), 1)", "name": "GM Pay usdt.tron", "type": "usdt.tron" }
]custom1は、単なる上流の汎用的なオプション名です。EPayのsubmit.phpにそのまま送信しないでください。type、type=alipay、または有効なセレクター(例:usdt.tron)を送信しないでください。
コールバックの検証
作成された注文が payment_type = Epay の場合、作業者は後にあなたの notify_url に EPay 形式のパラメータを付与し、同じ商事 secret_key を使用して署名します。
コールバックの type は、保存されたリクエストのタイプを再利用します。つまり、alipay または受け入れられたセレクター(例:usdt.tron)を返します。リクエストに type が含まれていない場合、外部へのコールバックは互換性のために alipay にフォールバックします。
古い単独の epay_key で、それらのコールバックを検証しないでください。