PHP教程：輕鬆實現微信支付退款功能

gitbox 2025-07-28

介紹

微信退款功能允許商戶通過微信支付接口將用戶已支付的款項進行退還。該功能在訂單取消或退貨時尤為重要，能提升用戶體驗和商戶服務質量。本文將通過PHP示例，帶您一步步實現微信退款功能。

準備工作

獲取商戶號

在使用微信支付之前，您需要先註冊並通過審核獲得微信商戶號。商戶號是商戶在微信支付平台的唯一標識，只有通過審核的商戶才可以調用退款接口。

下載微信支付SDK

微信支付官方提供了豐富的SDK，方便開發者集成支付和退款功能。您可以登錄微信支付商戶平台，在開發者中心下載適用於PHP的SDK。

實現退款功能

配置退款參數

退款前，需要準備好相關參數，如商戶號、退款金額、訂單號等。在PHP代碼中，可以這樣定義：

 
$merchant_id = 'your_merchant_id'; // 商戶號
$refund_amount = '100'; // 退款金額（單位分）
$order_id = 'your_order_id'; // 訂單號

發起退款請求

配置好參數後，利用微信支付SDK發送退款請求：

 
require_once 'path_to_wechat_sdk/autoload.php';
use WeChatPay\Builder\Refund\TradeRefundBuilder;

$refundBuilder = new TradeRefundBuilder();
$refundBuilder->setOutTradeNo($order_id)
    ->setOutRefundNo('refund_' . $order_id)
    ->setTotalFee($refund_amount)
    ->setRefundFee($refund_amount)
    ->setNotifyUrl('your_notify_url')
    ->setOpUserId('your_op_user_id')
    ->setIdempotencyKey($order_id);

$wechatPay = new \WeChatPay\WeChatPay();
$response = $wechatPay->refund($refundBuilder->getRequestParams(), $merchant_id);

處理退款結果

發起退款請求後，您會得到接口返回的結果，可以通過以下代碼進行判斷和處理：

 
if ($response['return_code'] === 'SUCCESS' && $response['result_code'] === 'SUCCESS') {
    // 退款成功，執行後續業務邏輯
    echo '退款成功';
} else {
    // 退款失敗，輸出錯誤信息
    echo '退款失敗：' . $response['err_code'] . ' ' . $response['err_code_des'];
}

總結

本文介紹瞭如何利用PHP實現微信退款功能，包括商戶號獲取、SDK下載、參數配置、退款請求發起及結果處理。根據具體業務需求，您可以靈活調整參數配置，確保退款流程順暢。希望本文能幫助您順利完成微信支付退款功能的開發。