Alipay入金の導入手順:サイト・アプリのチャージ、決済通知、残高記帳
Alipay入金とは、利用者がAlipayであなたのサイトやアプリへ支払い、残高をチャージすることです。稳付payが決済結果を確認して注文通知をサーバーへ送り、あなたのシステムが署名と注文を検証して該当利用者のサイト内残高を増やします。支払い、通知、記帳を相互に追跡できるようにし、同じ支払いの二重チャージを防ぐことが接続の要点です。
この記事の目次
1.利用者のチャージ・決済受取・アカウント記帳を区別
利用者がチャージするのは加盟店システム内の残高であり、Alipayウォレット自体ではありません。稳付payは開通済みAlipayネイティブ収納代行チャネル、決済結果確認、通知を担当し、加盟店は利用者アカウント、残高台帳、消費記録、購入後対応を管理します。
チャージ画面には残高の用途、有効期限、ボーナス、返金条件を明記します。実支払額と特典分を別々に記録し、最終的な残高増加から決済額を逆算しません。消費、返金、手動調整には独立した記録を残し、元のチャージ記録を削除して帳簿を変更しないでください。本文のサービスはAlipay出金やUSDT交換の提供を意味せず、独立した振込代行APIはまだ公開していません。
2.Alipayチャージが完了するまで
- 利用者がチャージを送信バックエンドで利用者を紐付け、金額を決定し、一意のチャージ注文を保存します。
- Alipay決済を作成開通済みチャネルを呼び出し、実際に返された決済情報を表示します。
- プラットフォームが入金結果を確認稳付payが元注文に関連付け、支払い成功を確認します。
- サーバーへ通知を送信加盟店設定のnotifyUrlへ標準コールバックを送ります。
- 加盟店が署名と内容を照合署名、加盟店、注文、金額、通貨、成功状態を確認します。
- 残高へ原子的に記帳同じトランザクションで決済、一意のチャージ記録、残高更新を保存します。
3.チャージ先の利用者・金額・チャネル設定を固定
注文作成前に利用者ID、加盟店注文番号、金額、通貨、チャージ規則のスナップショットを保存します。これらは加盟店の業務記録で、APIの追加パラメーターではありません。請求額はバックエンドの信頼できるデータから算出し、ブラウザーによる価格変更を受け付けず、通知到着後にチャージ先の利用者を変更しません。
以下の 収納代行の注文作成・照会ドキュメント に従ってmchId、wayCode、outTradeNo、amount、notifyUrl、reqTime、signなどを設定します。amountは分単位で、1000は10.00元です。reqTimeは現在のミリ秒タイムスタンプです。Alipay集約コードは80001で、加盟店に権限があり実チャネルが有効な場合にのみ利用できます。
「Alipayネイティブ」は当サイトの既存チャネルの業務名称です。決済画面、端末要件、操作方式は技術チームが設定に合わせて接続テストします。すべてのチャネルが任意のアプリ、H5、QR決済に対応するとは保証しません。実際に返された有効な決済入口だけを表示し、決済ページのURLを独自に組み立てないでください。
利用者は実際のAlipay決済画面で受取先と請求額を確認します。現在のチャージ注文と一致しなければ支払いを止め、加盟店へ確認してください。自分で金額を変更してからバックエンドへ紐付けを求めないでください。加盟店の決済案内にも注文との関連と照会入口を明記し、支払い後に確認できるようにします。
4.稳付payの仕様でコールバックを検証
以下の 署名ルールとコールバック仕様 に従ってBodyのsignを処理します。通知はCALLBACK_SECRETを優先し、個別設定がなければMD5_SECRETを使います。実際の非空項目を並べ替えて連結し、小文字MD5を計算します。00、10.00などの元の文字列を保持し、0、10へ変換してから署名検証しないでください。シークレットはサーバーだけに保存します。
署名検証後に加盟店、業務種別、元注文、プラットフォーム注文、分単位の金額、通貨を照合して成功状態を確認します。未知の注文や金額不一致では自動加算せず、例外を保持して技術担当者へ確認します。フロントエンドの成功遷移や利用者の「支払済み」操作は、自分のバックエンドへの進捗照会を起動するためにだけ使います。
当サイトの集約APIはAlipay公式直結の仕様とは異なります。Alipayの 公式SDKのRSA2署名実装 でここでのMD5ルールを置き換えることはできず、他所のsuccess応答例を本文の処理フローとして使うこともできません。稳付pay標準通知では確実に保存した後にHTTP 200、プレーンテキストOKを返すことを推奨します。
5.一意の取引記録でアカウント残高を保護
例えば「加盟店+チャージ注文」をキーに、チャージ記録へデータベース一意制約を設定します。注文、決済記録、チャージ記録、残高変化を同じトランザクションでコミットし、先に残高を増やして後から別に「処理済み」を保存しないでください。画面のボタン無効化や、存在確認後の書き込みだけでは同時通知を防げません。
通知を検証し、保存済みのチャージ注文を照合
データベーストランザクション開始
注文と関連アカウントをロック
この注文の成功チャージ記録があれば:残高を再加算しない
なければ:一意の記録を保存、該当利用者の残高を加算、注文を更新
トランザクションをコミット
HTTP 200、プレーンテキストOKを返すこれは加盟店の記帳用疑似コードで、追加APIではありません。失敗時はロールバックし、先に成功を確認しません。確実に処理済みの重複通知は確認後にOKを返せます。照会で成功した場合も同じ記帳関数を呼び、通知、再試行、手動補完で同じ重複防止の境界を共有します。
6.タイムアウトや重複通知は元注文を先に照会
| 状況 | 処理方法 |
|---|---|
| 注文作成リクエストがタイムアウト | 元注文番号を保持して照会し、すぐ新番号で二重チャージしません。 |
| 支払い済みだが残高が変わらない | 決済、通知処理、チャージ台帳を確認し、スクリーンショットだけで加算しません。 |
| 重複通知または同時照会 | 一意制約で保護された同じ記帳トランザクションを使います。 |
| 期限切れ注文に有効な支払い | 支払い事実を保存し、合意に従って補完記帳または返金し、無視しません。 |
利用者のAlipay明細の取引記録、稳付payが返すplatformOrderNo、加盟店が生成するoutTradeNoは別システムの識別子であり、同じ値とは限りません。バックエンドで関連を保存し、サポート担当者は元の加盟店注文を特定してから決済証跡を照合します。明細末尾、ニックネーム、同額だけの一致で加算しないでください。
稳付payの通知は初回を含めて合計最大3回で、最初の2回の失敗後に約60秒後、300秒後に再送するため、能動的な照会による補完も必要です。照会応答amountの単位は開通時に確認してから換算・比較し、注文作成の分単位とそのまま同一視しません。Alipayの 公式SDKにも取引照会リクエストがあります。ここでは能動的に確認する考え方だけを参考にし、実際の呼び出しには稳付payの収納代行照会APIを使います。
7.利用者チャージと加盟店USDT精算を別々に突合
利用者残高の増加は加盟店のアカウント記帳完了を意味し、加盟店USDT精算の完了は関連資金が合意に従って受取アドレスへ精算されたことを意味します。この2層の記録で同じ「完了」状態を共用してはいけません。
Alipayチャネルの収納代行後は双方の合意に従ってT0即時USDT精算が可能で、ネットワーク、アドレス、換算、費用は別途確認します。精算確認待ちでも利用者の支払いを失敗に変更してはいけません。残高加算だけで加盟店ウォレットがUSDTを受け取ったとも判断しません。詳細:加盟店精算の全手順。利用者注文、決済記録、精算明細、オンチェーン記録を1件ずつ関連付けてください。
8.よくある質問と本番前の検収
支払い後に画面を閉じてもチャージできますか?
バックエンドは有効な通知または照会によって処理を続行でき、利用者の画面復帰に依存しません。加盟店は確実な記帳と補完を実装する必要があります。
WeChatチャージと同じアカウント残高を使えますか?
加盟店システムで残高台帳を共用できますが、注文には決済方法と元チャネルを保持し、同じ支払いで有効なチャージ記録を1件だけ作ります。
既成AlipayプラグインはURL変更だけで接続できますか?
項目、署名、コールバック、照会が一致するかを先に確認します。公式直結プラグインはゲートウェイを置き換えるだけでは集約対応になりません。技術チームと接続テストしてください。
公開前に正常チャージ、不正署名、金額不一致、重複通知、通知と照会の同時処理、データベースのロールバック、遅延入金をテストします。毎回注文、一意の取引記録、最終残高を照合し、金額が正しく加算が一度だけであることを確認してください。WeChatの導入については WeChatチャージと残高への記帳。
参考資料
公式資料は決済通知とQR決済の用語確認用です。稳付payの項目、署名、通知応答は当サイトの開発者ドキュメントと開通設定に従います。