Alipay H5決済:稳付pay接続手順・通知処理・USDT精算

モバイルサイトでAlipayを選んで支払い、サイトが結果を確認して残高や会員権限を反映する流れがH5決済です。公式WAPの仕組みとともに、稳付payの具体的な接続手順、チャネルの特長、精算の取り決めを説明します。

テーマ別に読む

1.Alipay H5決済が適する場面

モバイルサイトのチャージ、購読、注文代金にはAlipayのWAP決済を検討できます。公式の方式はalipay.trade.wap.payで、PCサイト決済とネイティブAPP決済は別製品です。スマートフォン上のページという理由だけでAPIを混用しません。

Alipayアプリの起動、中間ページ、別の対応経路は、端末、アプリの導入状況、ブラウザ制限、製品設定によって変わります。すべての内蔵ブラウザでの自動起動を約束せず、利用者の支払確認を省略できる仕組みとも説明しません。

稳付payでは割り当てられたAlipayチャネルが対象のWeb環境に対応するか確認します。通常は共通の注文・通知仕様で接続し、利用可能な決済入口を技術担当者と確認します。集約注文へ公式Alipayパラメータを独自に追加しません。

2.稳付payの接続手順:チャネル確認から本番運用まで

手順1:@tonyyydsへドメイン、事業内容、ブラウザやアプリの利用環境、チャージ・購読の流れ、注文量、USDT精算の希望を伝えます。技術担当者がH5対応、利用チャネル、料金、精算条件、テスト方法を確認します。名称だけで開通済みとは判断しません。

手順2:実際のゲートウェイ、商戸番号mchId、許可されたwayCode、サーバー用の鍵を受け取り、公開notifyUrlと注文テーブルを用意します。鍵はバックエンドで管理します。集約コードの例はWeChatが90001、Alipayが80001ですが、利用権限が必要で、個別チャネルコードが指定される場合もあります。

手順3:一意のoutTradeNoと信頼できる金額を保存し、バックエンドからPOST /api/pay/collect/createへJSONを送ります。amountは人民元の分単位の整数で、1000は10元です。reqTimeは現在のミリ秒時刻を整数で指定し、signは資料のMD5規則で生成します。以下は本記事の決済方式の項目例で、仮の値を置き換え、サーバーで署名する必要があります。

回収フィールド例:仮の値を置き換え、reqTimeを現在のミリ秒整数にし、バックエンドで署名します。そのまま送信しないでください。
{
  "mchId": "YOUR_MERCHANT_ID",
  "wayCode": "80001",
  "outTradeNo": "YOUR_UNIQUE_ORDER_NO",
  "amount": 1000,
  "currencyCode": "CNY",
  "notifyUrl": "https://merchant.example.com/pay/notify",
  "subject": "WENFUPAY_H5_DEMO",
  "reqTime": "CURRENT_UNIX_MILLISECONDS",
  "sign": "GENERATE_MD5_ON_SERVER"
}

手順4:プラットフォーム注文番号を保存し、有効なpayUrlを受け取ってから所定の表示・遷移を行います。決済URLを独自に組み立てません。code=0は要求受付であり、支払完了でも残高加算の根拠でもありません。アプリが直接起動するかはチャネルとブラウザのテストで確認します。

手順5:稳付payの共通JSON通知を受け、署名、商戸、注文、金額、通貨を確認して一度だけ記帳します。永続保存後にHTTP 200とプレーンテキストOKを返します。通知未着や注文作成結果が不明な場合は、元の注文をバックエンドからGET /api/pay/collect/queryで照会します。照会金額の単位は接続時に確認してください。

手順6:担当者と調整したテスト環境で支払、キャンセル、タイムアウト、重複通知、残高反映を確認し、最初の本番注文を照合してから流量を増やします。下記に相談先と詳細資料を用意しています。

3.稳付payを利用する理由:チャネルと支援内容

決済手段の選択:現在はWeChat個人コード回収、WeChatネイティブ回収、Alipayネイティブ回収と集約接続を提供しています。事業に合う方式を設定し、個別チャネルとの接続作業を減らせます。H5対応は開通済みチャネル次第です。現在の稼働状況は安定していますが、注文、端末環境、チャネル状況で結果は変わるため固定の成功率を保証しません。

注文と通知の統一:返された決済入口と共通の注文作成・照会・JSON通知により、チャージ、購読、カード発行、TGボット注文を自社システムへ連携できます。プラットフォームは支払状態を通知し、残高や権限は商戸が検証済み結果から更新します。通知受信だけですべての提供処理が自動完了するわけではありません。

T0リアルタイムUSDT精算:顧客の支払確認後、合意した条件で商戸へUSDT精算を行えます。対象金額、料金、換算方法、ネットワーク、受取先を接続時に確認します。処理とブロックチェーン着金には条件や承認があり、手数料無料、承認不要、全件無条件の即時着金を意味しません。

技術担当者の支援:商戸設定、チャネル、署名、照会、通知異常について相談できます。WeChat・Alipay回収後のUSDT精算と、商戸の自有アドレスへのUSDT監視は別の資金経路です。後者は顧客が商戸ウォレットへ直接送り、稳付payが確認を監視して通知するサービスです。

4.公式WAPと稳付payのゲートウェイを区別する

公式へ直接接続する場合、契約製品に対応するアプリ情報と署名用の鍵を設定し、サーバーでWAP要求を生成します。公式Easy SDKはalipay.trade.wap.payとQUICK_WAP_WAYを使用し、totalAmountは元単位で10元なら10.00です。ブラウザへSDKが生成した決済フォームなどを渡します。署名用の鍵はバックエンドで管理します。

公式return_urlは支払後の戻り先、quit_urlは途中退出の戻り先、notify_urlは非同期通知先です。戻っただけでは支払確定になりません。WeChatのh5_urlやredirect_urlをAlipayの項目として使わず、APP決済をWAPの代用にしません。

稳付payではmchId、wayCode、outTradeNo、分単位の整数amountを使い、指定ゲートウェイとMD5規則に従ってpayUrlを受け取ります。公式AlipayのRSA2と集約側のMD5は異なる層の方式なので、項目や鍵を取り違えないでください。実際の応答と対応機能は連携テストで確認します。

5.支払確認後の通知と残高反映

注文受付やサイトへの復帰だけでは入金確定になりません。稳付payがチャネルの結果を確認してnotifyUrlへ共通通知を送り、商戸は署名、商戸情報、元注文、プラットフォーム注文番号、金額、通貨、成功状態を検証します。画像、画面ボタン、code=0だけでは加算しません。

永続保存後に一意の注文キーで残高台帳、会員付与、提供タスクを作成します。照会と重複通知を同じ処理へ集約し、一度だけ加算してください。支払済みで提供だけが失敗した場合は復旧可能なタスクを残し、再払いを求めません。

戻り画面の結果確認ボタンからバックエンドで元注文を照会します。通知遅延、作成結果不明、保留中も同様です。照会金額は確認済みの単位へ変換し、注文作成の分単位と無変換で比較しません。確認できない間は確認待ちと表示し、確定失敗として繰り返し払いを促さないことが大切です。

6.Alipay H5の本番前チェック

実際に利用するiOS・Androidブラウザで決済入口、キャンセルや退出後の復帰、元注文の復元、未保存のブラウザ状態への非依存を確認します。制限のある内蔵ブラウザでは担当者の案内に沿って開き方を変え、送信元の偽装や制限回避は行いません。

重複通知、通知前後の照会、データベース障害、提供処理の復旧を検証します。注文、支払記録、利用者残高、商戸のUSDT精算を照合してください。利用者への加算と商戸精算は別の状態です。

テスト記録には機密を除いた注文番号、時刻、エラー、要求IDを残し、商戸の鍵や完全な決済リンクは公開しません。稳付payが接続を支援し、最終的なチャネル、料金、精算条件は確認済みの取り決めに従います。

よくある質問

H5の開通方法と手数料を教えてください。

@tonyyydsへサイト、事業、利用環境、注文量、精算の希望を伝えます。担当者が対応チャネル、項目、料金、テストを確認してから接続します。一律の未確認手数料や全商戸への自動開通を意味する記事ではありません。

USDT精算は顧客が直接自分のウォレットへ送る方式ですか?

別の流れです。本記事は顧客がAlipayで払い、プラットフォームが合意条件でUSDT精算する方式です。自有アドレス監視では顧客が商戸ウォレットへ直接USDTを送り、確認後に通知します。それぞれの資金経路と条件を確認してください。

参考資料