現在の位置: ホーム> 最新記事一覧> PHPチュートリアル：WeChat Payment Refund関数を簡単に実装できます

PHPチュートリアル：WeChat Payment Refund関数を簡単に実装できます

gitbox 2025-07-28

導入

WECHAT払い戻し機能により、商人はWeChat Payment Interfaceを介してユーザーが支払った支払いを返金することができます。この機能は、注文のキャンセルまたはリターンで特に重要であり、ユーザーエクスペリエンスとマーチャントサービスの品質を向上させることができます。この記事では、PHPの例を使用して、WECHAT払い戻し機能を段階的に実装します。

準備

商人番号を取得します

WeChat Payを使用する前に、レビューを通じてWeChat Merchantアカウントを登録および取得する必要があります。販売者番号は、WeChat Payment Platformの販売者の唯一の識別子です。レビューに合格した商人のみが払い戻しインターフェイスを呼び出すことができます。

Wechat Pay SDKをダウンロードしてください

WeChat Payは公式に豊富なSDKを提供します。これにより、開発者が支払い機能と払い戻し機能を統合できるようになります。 WeChat Pay Merchantプラットフォームにログインし、開発者センターのPHPのSDKをダウンロードできます。

払い戻し関数を実装します

払い戻しパラメーターを構成します

払い戻しの前に、販売者番号、払い戻し額、注文番号などの関連パラメーターをPHPコードで準備する必要があります。次のように定義できます。

 
$merchant_id = 'your_merchant_id'; // 商人番号
$refund_amount = '100'; // 返金額（単位ポイント）
$order_id = 'your_order_id'; // 注文番号

払い戻しリクエストを開始します

パラメーターを構成した後、WeChat Pay 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のダウンロード、パラメーター構成、払い戻し要求の開始、結果処理など、WeChat払い戻し機能を実装する方法を紹介します。特定のビジネスニーズに応じて、パラメーター構成を柔軟に調整して、スムーズな払い戻しプロセスを確保することができます。この記事が、WeChat Payment Refund機能の開発を正常に完了するのに役立つことを願っています。

関連内容