萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 微信支付回調 (WXPayEntryActivity) 實作要點與避坑指南

前言

整合微信支付 SDK 時,必須在指定包名下實作 WXPayEntryActivity 並覆寫 onResp 接收支付結果回調。本文整理關鍵步驟、常見錯誤與安全驗證流程。

必要條件

  1. 包名必須為 你的包名.wxapi (如 com.example.app.wxapi)。
  2. 類名固定為 WXPayEntryActivity。
  3. 實作 IWXAPIEventHandler 介面。

標準實作範例 (Kotlin)

package com.example.app.wxapi

import android.app.Activity
import android.os.Bundle
import com.tencent.mm.opensdk.modelbase.BaseReq
import com.tencent.mm.opensdk.modelbase.BaseResp
import com.tencent.mm.opensdk.modelpay.PayResp
import com.tencent.mm.opensdk.openapi.IWXAPIEventHandler

class WXPayEntryActivity : Activity(), IWXAPIEventHandler {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 微信 SDK 會自動將回調轉發給 onResp,此處無需 setContentView
        // 若需顯示載入中可自行加載佈局
    }

    override fun onReq(req: BaseReq?) { /* 支付流程不需處理 */ }

    override fun onResp(resp: BaseResp?) {
        val payResp = resp as? PayResp
        val errCode = payResp?.errCode ?: -1

        when (errCode) {
            BaseResp.ErrCode.ERR_OK -> {
                // 支付成功:務必去後端驗證訂單狀態,再展示成功頁
                verifyOrderWithServer(payResp.prepayId)
            }
            BaseResp.ErrCode.ERR_USER_CANCEL -> toast("使用者取消支付")
            BaseResp.ErrCode.ERR_COMM, BaseResp.ErrCode.ERR_SENT_FAILED -> toast("支付失敗,請重試")
            else -> toast("未知錯誤: $errCode")
        }
        finish() // 關閉透明 Activity
    }

    private fun verifyOrderWithServer(prepayId: String?) {
        // TODO: 呼叫後端 API 驗證訂單狀態,成功後再導向訂單詳情頁
    }
}

AndroidManifest 宣告

<activity
    android:name=".wxapi.WXPayEntryActivity"
    android:exported="true"
    android:launchMode="singleTop"
    android:theme="@android:style/Theme.Translucent.NoTitleBar">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="wx<你的AppID>" />
    </intent-filter>
</activity>

關鍵避坑指南

  1. 包名/類名錯誤:任何不符會導致微信無法回調,Logcat 會出現 wxapi.WXPayEntryActivity not found。
  2. 主線程耗時:onResp 運行在主執行緒,**嚴禁**直接做網路請求,必須切換到 IO 執行緒 (Coroutine/RxJava/Thread)。
  3. 雙重回調:使用者可能在支付頁面按返回鍵,導致 onResp 與 onNewIntent 同時觸發,需去重 (用訂單號 Set 記錄已處理)。
  4. 安全驗證:**切勿只信任前端回調**,必須呼叫後端 API 查詢微信支付訂單狀態,防止偽造成功回調。
  5. Theme 透明:建議使用透明主題避免閃爍,或直接在 onCreate 呼叫 finish() 僅作為回調入口。

常見錯誤碼對照

errCode常數含義
0ERR_OK成功
-1ERR_COMM一般錯誤 (網路、簽名錯誤)
-2ERR_USER_CANCEL使用者取消
-3ERR_SENT_FAILED發送失敗
-4ERR_AUTH_DENIED授權失敗
-5ERR_UNSUPPORT不支援的 API

嚴格遵循微信規範實作回調入口,並配合後端驗證,才能確保支付流程安全可靠。

copyright © 萬盛學電腦網 all rights reserved