使用 MemberPress 交易完成鉤子自動寄送訂閱確認信

小豬 — Sat, 20 Dec 2025 03:46:29 +0000

前言

這段程式碼示範如何在 WordPress 使用 MemberPress 交易完成事件鉤子，自動寄送訂閱方案的確認電子郵件。適合使用 MemberPress 管理會員訂閱，並希望自動化寄送付款成功通知的工程師或自學者。

交易完成事件監聽

透過 add_action 監聽 mepr-event-transaction-completed 事件，當交易完成時觸發自訂函式。函式內部先檢查事件與交易物件有效性，避免錯誤執行。

add_action('mepr-event-transaction-completed', function($event) {
  if(!is_object($event)) return;

  $txn = $event->get_data();
  if(!is_object($txn)) return;
  // ...
});

交易資料擷取與條件判斷

取得交易相關資訊如使用者 ID、方案 ID、交易 ID、付款狀態與金額，並做以下條件過濾：

使用者、方案、交易 ID 必須有效
交易狀態必須為 complete
可選擇只寄首次付款通知（此範例預設為每次付款皆寄）
防止重複寄送，透過交易文章 meta 標記

這些判斷確保只有有效且未重複的交易會觸發郵件寄送。

根據方案選擇郵件模板

根據方案 ID（範例中為 626 月付方案與 639 年付方案）選擇對應的郵件主旨與 HTML 內容。郵件內容包含隱藏文字供郵件摘要使用，以及簡潔的訂閱資訊與操作連結。

if($membership_id === 626) {
  $subject = $subject_626;
  $message = $message_626;
} elseif($membership_id === 639) {
  $subject = $subject_639;
  $message = $message_639;
} else {
  return;
}

寄送郵件與防重複標記

使用 WordPress 內建的 wp_mail 函式寄送 HTML 格式郵件，並在成功寄出後，透過 update_post_meta 設定交易文章的自訂 meta，避免重複寄信。

$headers = ['Content-Type: text/html; charset=UTF-8'];
$sent = wp_mail($user->user_email, $subject, $message, $headers);

if($sent) {
  update_post_meta($txn_id, '_custom_plan_email_sent', 'yes');
}

實務應用與優化建議

可依照不同方案擴充更多模板，提升客製化體驗
建議搭配會員資料完整性檢查，確保郵件內容正確
若有多語系需求，可整合翻譯函式動態產生郵件內容
透過設定參數控制是否只寄首次付款通知，靈活調整行銷策略

常見問題與注意事項

確認 MemberPress 交易狀態名稱是否與程式碼一致，避免漏寄
郵件內容中圖片 URL 請替換成實際可用路徑
測試時注意交易狀態與交易金額，避免誤寄測試郵件

完整程式碼

get_data();
  if(!is_object($txn)) return;

  // 交易基本資訊
  $user_id       = intval($txn->user_id ?? 0);
  $membership_id = intval($txn->product_id ?? 0);
  $txn_id        = intval($txn->id ?? 0); // MemberPress 交易文章 ID
  $total         = floatval($txn->total ?? 0);
  $status        = strval($txn->status ?? '');

  if($user_id <= 0 || $membership_id <= 0 || $txn_id <= 0) return;

  // 僅完成交易才寄（雙保險）
  if($status !== 'complete') return;

  // 避免 $0 交易（試用 / 全額折扣）也發信
//   if($total <= 0) return;

  // 只寄首次付款？
  if($SEND_FIRST_PAYMENT_ONLY === true && method_exists($txn,'is_first_payment') && !$txn->is_first_payment()) {
    return;
  }

  // 防重複寄送：用交易 ID 做旗標
  if(get_post_meta($txn_id, '_custom_plan_email_sent', true) === 'yes') {
    return;
  }

  $user = get_user_by('id', $user_id);
  if(!$user || empty($user->user_email)) return;

  $product_name = get_the_title($membership_id);

  // ===== 月付 626 =====
  $subject_626 = '感謝您購買 '.$product_name;
  $message_626 = <<你已成功訂閱 。你的訂閱方案將會自動續訂：月付 $129，可隨時取消。












你已成功訂閱  。



你的訂閱方案將會自動續訂：月付 $129
你可以隨時取消。


點擊這裡登入


如有任何問題，請於聯絡我們留言你的需求。
 團隊


HTML;

  // ===== 年付 639 =====
  $subject_639 = '感謝您購買 '.$product_name;
  $message_639 = <<你已成功訂閱 。你的訂閱方案將會自動續訂：年付 $1,290，可隨時取消。











你已成功訂閱  。



你的訂閱方案將會自動續訂：年付 $1,290

你可以隨時取消。


別忘了到會員資訊裡留下你的收件資料，
讓我們能夠把贈品正確地寄送到你手上。


設定你的收件資料


如有任何問題，請於聯絡我們留言你的需求。
 團隊


HTML;

  // 套用對應模板
  if($membership_id === 626) {
    $subject = $subject_626;
    $message = $message_626;
  } elseif($membership_id === 639) {
    $subject = $subject_639;
    $message = $message_639;
  } else {
    return;
  }

  // 寄送
  $headers = ['Content-Type: text/html; charset=UTF-8'];
  $sent = wp_mail($user->user_email, $subject, $message, $headers);

  // 設定防重複旗標（只有寄成功才標記）
  if($sent) {
    update_post_meta($txn_id, '_custom_plan_email_sent', 'yes');
  }
});

交易完成 – 小豬日常