チャージ機能の導入

WeChat入金の導入手順:利用者のチャージ・決済確認・残高への記帳

ここでの「WeChat入金」は、利用者がWeChatであなたのサイトやアプリに支払い、残高をチャージすることです。稳付payが決済結果を確認してサーバーへ通知し、あなたのシステムが検証後に該当利用者のサイト内残高を増やします。決済確認と残高記帳の役割を分け、照合・再試行が可能で二重チャージのない一連の流れを実装する必要があります。

この記事の目次

1.入金先と記帳の担当を明確にする

利用者が購入するのはサイトやアプリ内のチャージ額であり、WeChatウォレット自体へのチャージではありません。稳付payは開通済みのWeChat決済チャネル、支払い結果の確認、注文通知を担当し、加盟店は利用者アカウント、残高台帳、その後の利用規則を管理します。

チャージ画面には残高の利用範囲、有効期限、購入後対応の規則を明記します。ボーナスがある場合は実支払額と特典分を別記し、増加した残高から決済金額を逆算しないでください。消費、返金、手動調整にも独立した記録を作り、理由と関連注文を保持します。元のチャージ記録を削除して帳簿を変更してはいけません。

各チャージは利用者アカウントから加盟店注文、さらにプラットフォーム決済記録まで追跡できる必要があります。ニックネーム、スクリーンショット、同額の支払いだけで残高を紐付けず、「注文作成済み」を「チャージ着金済み」とみなさないでください。本文はWeChat出金やUSDT交換の提供を意味せず、独立した振込代行APIは未提供です。

2.WeChatチャージの6段階

  1. 利用者がチャージを開始金額を選び、加盟店バックエンドが利用者を紐付けて一意のチャージ注文を発行します。
  2. WeChat決済入口を表示バックエンドが開通済みチャネルを呼び、実際に返された決済情報を表示します。
  3. 稳付payが支払いを確認元注文に関連付け、支払い成功の結果を検証します。
  4. サーバーへコールバック加盟店が設定した通知先へ標準決済通知を送信します。
  5. 加盟店が署名と内容を照合署名、加盟店、注文、金額、通貨、成功状態を確認します。
  6. 利用者残高を原子的に加算同じトランザクションで決済、一意の残高記録、残高更新を保存してから通知を確認応答します。
利用者に決済画面が表示されるのは決済フローの一部です。残高への反映は加盟店バックエンドの確実な記帳を基準とします。

3.注文作成前に利用者と請求額を固定

ローカルのチャージ注文を先に保存し、利用者ID、加盟店注文番号、請求額、通貨、チャージ規則のスナップショットを記録します。これらは加盟店自身の業務データであり、APIが同名パラメーターを追加で受け付ける意味ではありません。金額はバックエンドで算出し、フロントエンドの価格変更や通知によるチャージ利用者の再指定を許可しません。

以下の 収納代行の注文作成ドキュメント に従い、加盟店番号、開通済みチャネルコード、注文番号、金額、通知先、現在のミリ秒タイムスタンプ、署名を送信します。注文金額は分単位で、1000は10.00元です。WeChat集約コードは90001ですが、利用可否は加盟店権限と実設定によります。

WeChat個人用QRとネイティブチャネルの表示方法、端末制限、操作手順は導入時に技術チームと確認し、決済入口を独自に作らないでください。WeChat公式の Native製品説明 はQR決済の用語理解に役立ちますが、稳付payの集約MD5プロトコルをWeChat公式APIとして使うことはできません。

4.通知受信後は検証してから入金を記帳

以下の 標準コールバック仕様 に従いBodyのsignを検証します。設定済みCALLBACK_SECRETを優先し、個別設定がなければMD5_SECRETを使います。通知の元値を保持して署名検証し、00を0、10.00を10へ事前変換しません。シークレットはサーバーだけに置きます。

署名検証後も加盟店番号、業務種別、元注文番号、プラットフォーム注文番号、金額、通貨、成功状態を確認します。通知amountは分単位で、ローカルの請求額と一致する必要があります。利用者は保存済みの元注文から特定し、通知内の任意の追加値で置き換えてはいけません。

未知の注文、金額不一致、状態競合は例外を記録して技術担当者に確認し、自動で残高を増やしません。ブラウザーの成功表示や利用者の「支払済み」操作は、フロントエンドが自分のバックエンドへチャージ進捗を照会する契機にだけ使います。

5.一意の取引記録と残高更新を同時コミット

残高取引記録にデータベース一意制約を設定します。例えば「加盟店+チャージ注文」を業務一意キーとし、注文、取引記録、利用者残高を同じトランザクションで更新します。存在を確認してから書くだけでは同時コールバックを防げません。

決済通知を検証して元注文を照合
データベーストランザクション開始
  チャージ注文と関連アカウントをロック
  この注文の成功チャージ記録があれば:残高を再加算しない
  なければ:一意の記録を保存し、利用者残高を加算、チャージ状態を更新
トランザクションをコミット
HTTP 200、プレーンテキストOKを返す

以上は加盟店の記帳用疑似コードであり、稳付payの追加APIではありません。データベース障害時はロールバックし、先に成功応答を返しません。処理済みと確認できた重複通知にはOKを返せます。残高台帳、決済記録、アカウント更新は常に整合させます。照会による補完も同じ関数を使い、冪等チェックを回避する別の加算経路を作りません。

6.タイムアウト・重複通知・遅延入金への対応

場面正しい処理
作成リクエストがタイムアウト元注文番号で照会し、すぐ別番号で再チャージしません。
支払い後も残高が増えない決済、通知処理、ローカル取引記録を確認し、スクリーンショットだけで加算しません。
重複通知または照会と同時処理一意の取引記録の制約で保護した同じ記帳トランザクションへ進めます。
期限切れ後に有効な支払いを受信支払い事実を保存し、合意に従って記帳補完または返金し、無視しません。

稳付payの標準通知は初回を含めて合計最大3回で、最初の2回の失敗後に約60秒後、300秒後の再送となるため、能動的な照会による補完も必要です。照会応答の金額単位は開通時に確認し、その後換算して比較します。WeChat公式の コールバックと照会の実装ガイド も、通知の遅延・欠落があり得るため、画面復帰後もサーバー確認が必要だと説明しています。本文ではそのAPI項目や応答規則を流用しません。

7.利用者残高と加盟店USDT精算を別々に照合

「利用者のチャージ成功」は加盟店システム内の残高が正しく増えたこと、「加盟店の精算完了」は関連資金が合意に従って加盟店へ精算されたことです。同じアカウント残高でも同じ状態でもありません。

チャネル収納代行後は双方の合意に従ってT0即時USDT精算が可能で、ネットワーク、アドレス、換算、費用は別途確認します。精算確認中でも利用者の支払いを失敗へ変更せず、利用者残高の加算だけで加盟店ウォレットにUSDTが届いたと判断しません。詳細:加盟店精算の全手順。

8.よくある質問と本番前の検収

利用者がページを閉じてもチャージできますか?

サーバー結果で処理を継続でき、Webページへの復帰に依存しません。加盟店は通知受信と照会による補完を正しく実装する必要があります。

重複通知で残高が2回増えませんか?

一意のチャージ記録と原子的トランザクションを正しく実装すれば、同じ支払いは一度だけ計上されます。画面のボタンを無効にするだけでは並行した二重記帳を防げません。

稳付payの導入を始めるには?

技術チームへサイトやアプリ、チャージ規則、決済要件を伝え、チャネルと加盟店設定を確認してから開発者ドキュメントで接続テストします。

公開前に少なくとも正常チャージ、重複通知、通知と照会の同時処理、データベース障害のロールバック、ページ終了、遅延入金を検証します。各テストで注文、決済記録、残高台帳、最終残高を照合し、金額が正確で加算が一度だけであることを確認します。

参考資料

公式資料は決済通知とQR決済の用語確認用です。稳付payの項目、署名、通知応答は当サイトの開発者ドキュメントと開通設定に従います。

事業の内容に合わせて導入を確認

商品、注文量、決済方法、精算要件を伝え、インターフェース、資金の流れ、例外処理を一つずつ確認します。

稳付payに問い合わせる ↗